Fix SEO skill 34 bugs, Korean labels, and transition Ahrefs refs to our-seo-agent (#2)

This commit is contained in:
Andrew Yim
2026-02-14 01:09:35 +09:00
committed by GitHub
parent d2d0a2d460
commit a28bfbf847
34 changed files with 265 additions and 262 deletions

View File

@@ -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

View File

@@ -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)