Fix SEO skill 34 bugs, Korean labels, and transition Ahrefs refs to our-seo-agent (#2)
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
## Overview
|
||||
|
||||
Position tracking tool for monitoring keyword rankings via Ahrefs Rank Tracker. Monitors ranking positions, detects position changes with threshold alerts, calculates visibility scores weighted by search volume, compares against competitors, and segments by brand/non-brand keywords.
|
||||
Position tracking tool for monitoring keyword rankings. Monitors ranking positions, detects position changes with threshold alerts, calculates visibility scores weighted by search volume, compares against competitors, and segments by brand/non-brand keywords.
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -41,7 +41,7 @@ python scripts/position_tracker.py --target https://example.com --competitor htt
|
||||
```
|
||||
|
||||
**Capabilities**:
|
||||
- Current ranking position retrieval via Ahrefs Rank Tracker
|
||||
- Current ranking position retrieval via our-seo-agent CLI or pre-fetched data
|
||||
- Position change detection with configurable threshold alerts
|
||||
- Visibility score calculation (weighted by search volume)
|
||||
- Brand vs non-brand keyword segmentation
|
||||
@@ -69,17 +69,13 @@ python scripts/ranking_reporter.py --target https://example.com --competitor htt
|
||||
- Competitor overlap and position comparison
|
||||
- Average position by keyword group
|
||||
|
||||
## Ahrefs MCP Tools Used
|
||||
## Data Sources
|
||||
|
||||
| Tool | Purpose |
|
||||
|------|---------|
|
||||
| `rank-tracker-overview` | Get rank tracking overview for project |
|
||||
| `rank-tracker-competitors-overview` | Compare against competitors |
|
||||
| `rank-tracker-competitors-pages` | Competitor page-level rankings |
|
||||
| `rank-tracker-competitors-stats` | Competitor ranking statistics |
|
||||
| `rank-tracker-serp-overview` | SERP details for tracked keywords |
|
||||
| `management-projects` | List Ahrefs projects |
|
||||
| `management-project-keywords` | Get tracked keywords for project |
|
||||
| Source | Purpose |
|
||||
|--------|---------|
|
||||
| `our-seo-agent` CLI | Primary data source (future); use `--input` for pre-fetched JSON |
|
||||
| WebSearch / WebFetch | Supplementary live data |
|
||||
| Notion MCP | Save audit report to database |
|
||||
|
||||
## Output Format
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
name: seo-position-tracking
|
||||
description: |
|
||||
Keyword position tracking and ranking monitoring via Ahrefs Rank Tracker.
|
||||
Keyword position tracking for keyword ranking monitoring.
|
||||
Triggers: rank tracking, position monitoring, keyword rankings, visibility score, ranking report, 키워드 순위, 순위 추적.
|
||||
---
|
||||
|
||||
@@ -9,11 +9,11 @@ description: |
|
||||
|
||||
## Purpose
|
||||
|
||||
Monitor keyword ranking positions, detect significant changes, calculate visibility scores, and compare against competitors using Ahrefs Rank Tracker data. Provides actionable alerts for ranking drops and segment-level performance breakdown.
|
||||
Monitor keyword ranking positions, detect significant changes, calculate visibility scores, and compare against competitors using our-seo-agent CLI or pre-fetched ranking data. Provides actionable alerts for ranking drops and segment-level performance breakdown.
|
||||
|
||||
## Core Capabilities
|
||||
|
||||
1. **Position Monitoring** - Retrieve current keyword ranking positions from Ahrefs Rank Tracker projects
|
||||
1. **Position Monitoring** - Retrieve current keyword ranking positions from our-seo-agent CLI or pre-fetched data
|
||||
2. **Change Detection** - Detect significant position changes with configurable threshold alerts (severity: critical/high/medium/low)
|
||||
3. **Visibility Scoring** - Calculate weighted visibility scores using CTR-curve model (position 1 = 30%, position 2 = 15%, etc.)
|
||||
4. **Brand/Non-brand Segmentation** - Automatically classify keywords by brand relevance and search intent type
|
||||
@@ -21,15 +21,10 @@ Monitor keyword ranking positions, detect significant changes, calculate visibil
|
||||
|
||||
## MCP Tool Usage
|
||||
|
||||
### Ahrefs Rank Tracker Tools
|
||||
### SEO Data
|
||||
```
|
||||
mcp__ahrefs__rank-tracker-overview: Get rank tracking overview with current positions
|
||||
mcp__ahrefs__rank-tracker-competitors-overview: Compare rankings against competitors
|
||||
mcp__ahrefs__rank-tracker-competitors-pages: Competitor page-level ranking data
|
||||
mcp__ahrefs__rank-tracker-competitors-stats: Detailed competitor ranking statistics
|
||||
mcp__ahrefs__rank-tracker-serp-overview: SERP details for tracked keywords
|
||||
mcp__ahrefs__management-projects: List available Ahrefs projects
|
||||
mcp__ahrefs__management-project-keywords: Get tracked keywords for a project
|
||||
our-seo-agent CLI: Primary ranking data source (future); use --input for pre-fetched JSON
|
||||
WebSearch: Supplementary ranking data
|
||||
```
|
||||
|
||||
### Notion for Report Storage
|
||||
@@ -41,7 +36,7 @@ mcp__notion__notion-update-page: Update existing tracking entries
|
||||
## Workflow
|
||||
|
||||
### Phase 1: Data Collection
|
||||
1. Identify Ahrefs project via `management-projects`
|
||||
1. Identify tracking project or use --input for pre-fetched data
|
||||
2. Retrieve tracked keywords via `management-project-keywords`
|
||||
3. Fetch current positions via `rank-tracker-overview`
|
||||
4. Fetch competitor data via `rank-tracker-competitors-overview` (if requested)
|
||||
|
||||
Reference in New Issue
Block a user