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

308 lines
7.3 KiB
Markdown

# 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
```markdown
## 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
```markdown
## 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
```markdown
## 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
```markdown
## 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
```markdown
## 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
```markdown
## 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
```markdown
# 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]
```