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
Competitor intelligence and benchmarking tool for comprehensive SEO competitive analysis. Auto-discovers competitors via Ahrefs, builds competitor profile cards (DR, traffic, keywords, backlinks, content volume), creates head-to-head comparison matrices, tracks traffic trends, analyzes keyword overlap, compares content freshness/volume, and scores competitive threats. Supports Korean market competitor analysis including Naver Blog/Cafe presence.
Competitor intelligence and benchmarking tool for comprehensive SEO competitive analysis. Auto-discovers competitors via our-seo-agent CLI, builds competitor profile cards (DR, traffic, keywords, backlinks, content volume), creates head-to-head comparison matrices, tracks traffic trends, analyzes keyword overlap, compares content freshness/volume, and scores competitive threats. Supports Korean market competitor analysis including Naver Blog/Cafe presence.
## Quick Start
@@ -41,7 +41,7 @@ python scripts/competitor_profiler.py --target https://example.com --korean-mark
```
**Capabilities**:
- Competitor auto-discovery via Ahrefs organic-competitors
- Competitor auto-discovery via our-seo-agent CLI or pre-fetched data
- Competitor profile cards:
- Domain Rating (DR)
- Organic traffic estimate
@@ -78,21 +78,13 @@ python scripts/competitive_monitor.py --target https://example.com --scope traff
- Alert generation for significant competitive movements
- Market share estimation based on organic traffic
## Ahrefs MCP Tools Used
## Data Sources
| Tool | Purpose |
|------|---------|
| `site-explorer-metrics` | Current organic metrics |
| `site-explorer-metrics-history` | Historical metrics trends |
| `site-explorer-organic-competitors` | Discover organic competitors |
| `site-explorer-organic-keywords` | Keyword rankings per domain |
| `site-explorer-top-pages` | Top performing pages |
| `site-explorer-pages-by-traffic` | Pages ranked by traffic |
| `site-explorer-domain-rating` | Domain Rating |
| `site-explorer-domain-rating-history` | DR trend |
| `site-explorer-referring-domains` | Referring domain list |
| `site-explorer-backlinks-stats` | Backlink overview |
| `site-explorer-pages-history` | Page index history |
| 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

@@ -15,7 +15,7 @@ Comprehensive competitor intelligence for SEO: auto-discover competitors, build
## Core Capabilities
1. **Competitor Discovery** - Auto-discover organic competitors via Ahrefs
1. **Competitor Discovery** - Auto-discover organic competitors via our-seo-agent CLI
2. **Profile Cards** - DR, traffic, keywords, referring domains, top pages, content volume
3. **Comparison Matrix** - Multi-dimensional head-to-head comparison
4. **Keyword Overlap** - Shared, unique, and gap keyword analysis
@@ -26,19 +26,10 @@ Comprehensive competitor intelligence for SEO: auto-discover competitors, build
## MCP Tool Usage
### Ahrefs for Competitive Data
### SEO Data
```
mcp__ahrefs__site-explorer-organic-competitors: Discover organic competitors
mcp__ahrefs__site-explorer-metrics: Current organic metrics
mcp__ahrefs__site-explorer-metrics-history: Historical metric trends
mcp__ahrefs__site-explorer-domain-rating: Domain Rating score
mcp__ahrefs__site-explorer-domain-rating-history: DR trend over time
mcp__ahrefs__site-explorer-organic-keywords: Keyword rankings per domain
mcp__ahrefs__site-explorer-top-pages: Top performing pages
mcp__ahrefs__site-explorer-pages-by-traffic: Pages ranked by traffic
mcp__ahrefs__site-explorer-referring-domains: Referring domain list
mcp__ahrefs__site-explorer-backlinks-stats: Backlink overview
mcp__ahrefs__site-explorer-pages-history: Page index history
our-seo-agent CLI: Primary competitive data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Supplementary competitor data
```
### Notion for Report Storage
@@ -55,7 +46,7 @@ WebSearch: Check Naver Blog/Cafe presence for competitors
### Competitor Profiling
1. Accept target URL/domain
2. Auto-discover competitors via Ahrefs organic-competitors (or use provided list)
2. Auto-discover competitors via our-seo-agent CLI or use provided list
3. Build profile card for target and each competitor (DR, traffic, keywords, backlinks, content)
4. Analyze keyword overlap between target and each competitor
5. Build multi-dimensional comparison matrix
@@ -136,9 +127,9 @@ WebSearch: Check Naver Blog/Cafe presence for competitors
## Limitations
- Ahrefs data has ~24h freshness lag
- Data freshness depends on source and collection method
- Keyword overlap limited to top 1,000 keywords per domain
- Content velocity based on Ahrefs page index (not real-time crawl)
- Content velocity based on page index data (not real-time crawl)
- Naver presence detection is heuristic-based
## Notion Output (Required)