ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files

14
custom-skills/20-seo-serp-analysis/code/CLAUDE.md
View File

@@ -2,7 +2,7 @@
## Overview
SERP analysis tool for understanding search result landscapes. Detects Google SERP features (featured snippets, PAA, knowledge panels, local pack, video, ads), analyzes Naver SERP composition (blog, cafe, knowledge iN, Smart Store, brand zone, VIEW tab), maps competitor positions, and scores SERP feature opportunities.
SERP analysis tool for understanding search result landscapes. Detects Google SERP features (featured snippets, PAA, knowledge panels, local pack, video, ads), analyzes Naver SERP composition (blog, cafe, knowledge iN, Smart Store, brand zone, shortform, influencer), maps competitor positions, and scores SERP feature opportunities.
## Quick Start
@@ -65,13 +65,13 @@ python scripts/naver_serp_analyzer.py --keywords-file keywords.txt --json
- Brand zone presence detection
- Shortform/influencer content analysis
## Ahrefs MCP Tools Used
## Data Sources
| Tool | Purpose |
|------|---------|
| `serp-overview` | Get SERP results for a keyword |
| `keywords-explorer-overview` | Get keyword metrics and SERP features |
| `site-explorer-organic-keywords` | Map competitor positions |
| Source | Purpose |
|--------|---------|
| `our-seo-agent` CLI | Primary data source (future); use `--input` for pre-fetched JSON |
| WebSearch / WebFetch | Live SERP data and Naver section analysis |
| Notion MCP | Save analysis report to SEO Audit Log database |
## Output Format

2
custom-skills/20-seo-serp-analysis/code/scripts/naver_serp_analyzer.py
View File

@@ -2,7 +2,7 @@
Naver SERP Analyzer - Naver search result composition analysis
==============================================================
Purpose: Analyze Naver SERP section distribution, content type mapping,
brand zone detection, and VIEW tab content analysis.
brand zone detection, and section priority analysis.
Python: 3.10+
Usage:

11
custom-skills/20-seo-serp-analysis/desktop/SKILL.md
View File

@@ -21,11 +21,10 @@ Analyze search engine result page composition for Google and Naver. Detect SERP
## MCP Tool Usage
### Ahrefs for SERP Data
### SEO Data
```
mcp__ahrefs__serp-overview: Get SERP results and features for a keyword
mcp__ahrefs__keywords-explorer-overview: Get keyword metrics, volume, difficulty, and SERP feature flags
mcp__ahrefs__site-explorer-organic-keywords: Map competitor keyword positions
our-seo-agent CLI: Primary data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Live SERP data and keyword metrics
```
### Notion for Report Storage
@@ -43,7 +42,7 @@ WebFetch: Fetch Naver SERP HTML for section analysis
## Workflow
### 1. Google SERP Analysis
1. Fetch SERP data via `mcp__ahrefs__serp-overview` for the target keyword and country
1. Fetch SERP data via `our-seo-agent` CLI, `--input` JSON, or WebSearch for the target keyword and country
2. Detect SERP features (featured snippet, PAA, local pack, knowledge panel, video, ads, images, shopping)
3. Map competitor positions from organic results (domain, URL, title, position)
4. Classify content type for each result (blog, product, service, news, video)
@@ -107,7 +106,7 @@ WebFetch: Fetch Naver SERP HTML for section analysis
## Limitations
- Ahrefs SERP data may have a delay (not real-time)
- SERP data may have a delay depending on data source (not real-time)
- Naver SERP HTML structure changes periodically
- Brand zone detection depends on HTML class patterns
- Cannot detect personalized SERP results