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
Keyword strategy and research tool for SEO campaigns. Expands seed keywords via Ahrefs APIs, classifies search intent, clusters topics, performs competitor keyword gap analysis, and supports Korean market keyword discovery including Naver autocomplete.
Keyword strategy and research tool for SEO campaigns. Expands seed keywords via our-seo-agent CLI or pre-fetched data, classifies search intent, clusters topics, performs competitor keyword gap analysis, and supports Korean market keyword discovery including Naver autocomplete.
## Quick Start
@@ -68,17 +68,13 @@ python scripts/keyword_gap_analyzer.py --target https://example.com --competitor
- Segment gaps by intent type
- Prioritize low-KD high-volume opportunities
## Ahrefs MCP Tools Used
## Data Sources
| Tool | Purpose |
|------|---------|
| `keywords-explorer-overview` | Get keyword metrics (volume, KD, CPC) |
| `keywords-explorer-matching-terms` | Find matching keyword variations |
| `keywords-explorer-related-terms` | Discover semantically related keywords |
| `keywords-explorer-search-suggestions` | Get autocomplete suggestions |
| `keywords-explorer-volume-by-country` | Compare volume across countries |
| `keywords-explorer-volume-history` | Track volume trends over time |
| `site-explorer-organic-keywords` | Get competitor keyword rankings |
| 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

@@ -23,14 +23,10 @@ Expand seed keywords, classify search intent, cluster topics, and identify compe
## MCP Tool Usage
### Ahrefs for Keyword Data
### SEO Data
```
mcp__ahrefs__keywords-explorer-overview: Get keyword metrics
mcp__ahrefs__keywords-explorer-matching-terms: Find keyword variations
mcp__ahrefs__keywords-explorer-related-terms: Discover related keywords
mcp__ahrefs__keywords-explorer-search-suggestions: Autocomplete suggestions
mcp__ahrefs__keywords-explorer-volume-by-country: Country volume comparison
mcp__ahrefs__site-explorer-organic-keywords: Competitor keyword rankings
our-seo-agent CLI: Primary keyword data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Live keyword research and autocomplete data
```
### Web Search for Naver Discovery
@@ -42,7 +38,7 @@ WebSearch: Naver autocomplete and trend discovery
### 1. Seed Keyword Expansion
1. Input seed keyword (Korean or English)
2. Query Ahrefs matching-terms and related-terms
2. Query keyword data via our-seo-agent CLI, pre-fetched JSON, or WebSearch
3. Get search suggestions for long-tail variations
4. Apply Korean suffix expansion if Korean market
5. Deduplicate and merge results