SurfSense/.cursor/skills/rank-tracker/references/ranking-analysis-templates.md
DESKTOP-RTLN3BA\$punk 7ea840dbb2
Some checks failed
Build and Push Docker Images / tag_release (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend) (push) Has been cancelled
Build and Push Docker Images / create_manifest (web, surfsense-web) (push) Has been cancelled
feat: enhance SurfSense with new skills, blog section, and improve SEO metadata
- Added multiple new skills to skills-lock.json from the repository `aaron-he-zhu/seo-geo-claude-skills`.
- Introduced `fuzzy-search` dependency in package.json for improved search functionality.
- Updated pnpm-lock.yaml to include the new `fuzzy-search` package.
- Enhanced SEO metadata across various pages, including canonical links and descriptions for better search visibility.
- Improved layout and structure of several components, including the homepage and changelog, to enhance user experience.
2026-04-11 23:38:12 -07:00

7.3 KiB

Ranking Analysis Output Templates

Detailed output templates for each step of the rank tracking workflow. Use these templates when setting up tracking, recording snapshots, and generating reports.


1. Rank Tracking Setup Template

## Rank Tracking Setup

### Tracking Configuration

**Domain**: [domain]
**Tracking Location**: [country/city]
**Device**: [Mobile/Desktop/Both]
**Language**: [language]
**Update Frequency**: [Daily/Weekly/Monthly]

### Keywords to Track

| Keyword | Volume | Current Rank | Type | Priority |
|---------|--------|--------------|------|----------|
| [keyword 1] | [vol] | [rank] | Primary | High |
| [keyword 2] | [vol] | [rank] | Primary | High |
| [keyword 3] | [vol] | [rank] | Secondary | Medium |
| [keyword 4] | [vol] | [rank] | Long-tail | Medium |
| [keyword 5] | [vol] | [rank] | Brand | High |

### Competitor Tracking

Track these competitors for benchmark:
1. [Competitor 1] - [domain]
2. [Competitor 2] - [domain]
3. [Competitor 3] - [domain]

### Tracking Categories

| Category | Keywords | Description |
|----------|----------|-------------|
| Brand | [X] | Brand name variations |
| Product | [X] | Product-related terms |
| Informational | [X] | Educational queries |
| Commercial | [X] | Buying intent terms |

2. Current Ranking Snapshot Template

## Current Ranking Snapshot

**Date**: [date]
**Domain**: [domain]

### Ranking Overview

| Position Range | Keyword Count | % of Total |
|----------------|---------------|------------|
| #1 | [X] | [X]% |
| #2-3 | [X] | [X]% |
| #4-10 | [X] | [X]% |
| #11-20 | [X] | [X]% |
| #21-50 | [X] | [X]% |
| #51-100 | [X] | [X]% |
| Not ranking | [X] | [X]% |

### Position Distribution

Position 1: [X] keywords Position 2-3: [X] keywords Position 4-10: [X] keywords Position 11-20: [X] keywords Position 21+: [X] keywords


### Detailed Rankings

| Keyword | Position | URL | SERP Features | Change |
|---------|----------|-----|---------------|--------|
| [kw 1] | 3 | [url] | Featured Snippet | +2 |
| [kw 2] | 7 | [url] | PAA | -1 |
| [kw 3] | 12 | [url] | None | New |
| [kw 4] | 1 | [url] | Featured Snippet | Stable |

3. Ranking Change Analysis Template

## Ranking Change Analysis

**Period**: [start date] to [end date]

### Overall Movement

| Metric | Start | End | Change |
|--------|-------|-----|--------|
| Avg Position | [X] | [Y] | [+/-Z] |
| Keywords in Top 10 | [X] | [Y] | [+/-Z] |
| Keywords in Top 3 | [X] | [Y] | [+/-Z] |
| Keywords #1 | [X] | [Y] | [+/-Z] |

### Biggest Improvements

| Keyword | Old Rank | New Rank | Change | Est. Traffic Impact |
|---------|----------|----------|--------|---------------------|
| [kw 1] | 15 | 4 | +11 | +[X] visits/mo |
| [kw 2] | 25 | 9 | +16 | +[X] visits/mo |

**Possible causes**:
- [kw 1]: [hypothesis - e.g., content refresh may have improved relevance]

### Biggest Declines

| Keyword | Old Rank | New Rank | Change | Est. Traffic Impact |
|---------|----------|----------|--------|---------------------|
| [kw 1] | 3 | 12 | -9 | -[X] visits/mo |

**Likely factors**:
- [kw 1]: [hypothesis - e.g., competitor may have published updated guide]

> These are hypotheses based on available signals, not confirmed causes. Investigate each with the relevant skill to confirm.

**Recommended actions**:
- [kw 1]: [action to recover]

### Stable Keywords

[X] keywords remained within +/-3 positions (stable)

### New Rankings

| Keyword | Position | URL | Notes |
|---------|----------|-----|-------|
| [kw 1] | [pos] | [url] | [notes] |

### Lost Rankings

| Keyword | Last Position | URL | Action |
|---------|---------------|-----|--------|
| [kw 1] | [pos] | [url] | [investigate/refresh] |

4. SERP Feature Tracking Template

## SERP Feature Tracking

### Feature Ownership

| Feature | Your Count | Competitor Avg | Opportunity |
|---------|------------|----------------|-------------|
| Featured Snippets | [X] | [Y] | [+/-Z] |
| People Also Ask | [X] | [Y] | [+/-Z] |
| Image Pack | [X] | [Y] | [+/-Z] |
| Video Results | [X] | [Y] | [+/-Z] |
| Local Pack | [X] | [Y] | [+/-Z] |

### Featured Snippet Status

| Keyword | You Own? | Current Owner | Winnable? |
|---------|----------|---------------|-----------|
| [kw 1] | Yes | You | Maintain |
| [kw 2] | No | [Competitor] | High |

### PAA Appearances

| Question | Your Answer? | Position | Action |
|----------|--------------|----------|--------|
| [Question 1] | Yes/No | [pos] | [action] |

5. GEO/AI Visibility Tracking Template

## AI/GEO Visibility Tracking

### AI Overview Presence

| Keyword | AI Overview | You Cited? | Citation Position |
|---------|-------------|------------|-------------------|
| [kw 1] | Yes | Yes | 1st source |
| [kw 2] | Yes | Yes | 3rd source |
| [kw 3] | Yes | No | Not cited |
| [kw 4] | No | N/A | N/A |

### AI Citation Rate

| Metric | Value |
|--------|-------|
| Keywords with AI Overview | [X]/[Total] ([Y]%) |
| Your citations in AI Overview | [X]/[Y] ([Z]%) |
| Avg citation position | [X] |

### GEO Performance Trend

| Period | AI Overviews Tracked | Your Citations | Rate |
|--------|---------------------|----------------|------|
| Last week | [X] | [Y] | [Z]% |
| 2 weeks ago | [X] | [Y] | [Z]% |
| Month ago | [X] | [Y] | [Z]% |

### GEO Improvement Opportunities

| Keyword | Has AI Overview | You Cited? | Content Gap |
|---------|-----------------|------------|-------------|
| [kw 1] | Yes | No | Need clearer definition |
| [kw 2] | Yes | No | Missing quotable stats |

6. Competitor Ranking Comparison Template

## Competitor Ranking Comparison

### Share of Voice

| Domain | Keywords Ranked | Avg Position | Visibility |
|--------|-----------------|--------------|------------|
| [Your site] | [X] | [Y] | [Z]% |
| [Competitor 1] | [X] | [Y] | [Z]% |
| [Competitor 2] | [X] | [Y] | [Z]% |

### Head-to-Head Comparison

**You vs [Competitor 1]**:

| Keyword | Your Rank | Their Rank | Winner |
|---------|-----------|------------|--------|
| [kw 1] | 3 | 7 | You |
| [kw 2] | 12 | 5 | Them |

**Summary**: You win [X]/[Y] keywords vs [Competitor 1]

### Competitor Movement Alerts

| Competitor | Keyword | Their Change | Threat Level |
|------------|---------|--------------|--------------|
| [Comp 1] | [kw] | +15 positions | High |
| [Comp 2] | [kw] | +8 positions | Medium |

7. Ranking Performance Report Template

# Ranking Performance Report

**Domain**: [domain]
**Report Period**: [start] to [end]
**Generated**: [date]

## Executive Summary

**Overall Trend**: [Improving/Stable/Declining]

| Metric | Value | vs Last Period | Status |
|--------|-------|----------------|--------|
| Total keywords tracked | [X] | [+/-Y] | [status] |
| Keywords in top 10 | [X] | [+/-Y] | [status] |
| Keywords in top 3 | [X] | [+/-Y] | [status] |
| Average position | [X] | [+/-Y] | [status] |
| Estimated traffic | [X] | [+/-Y]% | [status] |

## Key Highlights

### Wins
- [Achievement 1]
- [Achievement 2]

### Concerns
- [Issue 1]
- [Issue 2]

### Opportunities
- [Opportunity 1]

## Detailed Analysis

[Include top performing keywords, keywords needing attention, SERP features, GEO visibility, competitive position]

## Recommendations

### Immediate Actions
1. [Action] for [keyword] - [expected impact]

### This Month
1. [Action]

### Next Quarter
1. [Strategic action]

## Next Report

Scheduled: [date]
Focus areas: [areas to monitor]