Add SEO skills 19-28, 31-32 with full Python implementations

12 new skills: Keyword Strategy, SERP Analysis, Position Tracking, Link Building, Content Strategy, E-Commerce SEO, KPI Framework, International SEO, AI Visibility, Knowledge Graph, Competitor Intel, and Crawl Budget. ~20K lines of Python across 25 domain scripts. Updated skill 11 pipeline table and repo CLAUDE.md. Enhanced skill 18 local SEO workflow from jamie.clinic audit. Note: Skill 26 hreflang_validator.py pending (content filter block). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-13 12:05:59 +09:00
parent 159f7ec3f7
commit a3ff965b87
125 changed files with 25948 additions and 173 deletions
--- a/custom-skills/27-seo-ai-visibility/desktop/SKILL.md
+++ b/custom-skills/27-seo-ai-visibility/desktop/SKILL.md
@@ -0,0 +1,66 @@
+---
+name: seo-ai-visibility
+description: |
+  AI search visibility and brand radar monitoring. Tracks how a brand appears
+  in AI-generated search answers using Ahrefs Brand Radar APIs.
+  Triggers: AI search, AI visibility, brand radar, AI citations,
+  share of voice, AI answers, AI mentions.
+---
+
+# SEO AI Visibility & Brand Radar
+
+Monitor and analyze brand visibility in AI-generated search results. This skill uses Ahrefs Brand Radar APIs to track impressions, mentions, share of voice, cited domains, cited pages, and AI response content.
+
+## Capabilities
+
+### AI Visibility Tracking
+- **Impressions Overview** - How often the brand appears in AI answers
+- **Mentions Overview** - Brand mention frequency across AI engines
+- **Share of Voice (SOV)** - Brand's share vs competitors in AI search
+- **Historical Trends** - Impressions, mentions, and SOV over time
+- **Competitor Comparison** - Side-by-side AI visibility metrics
+
+### AI Citation Analysis
+- **AI Response Analysis** - Content and sentiment of AI mentions
+- **Cited Domains** - Which source domains AI engines reference
+- **Cited Pages** - Specific URLs that get cited in AI answers
+- **Citation Ranking** - Frequency-based ranking of citations
+- **Sentiment Analysis** - Positive/neutral/negative distribution
+
+## Workflow
+
+1. **Input**: User provides target domain and optional competitors
+2. **Data Collection**: Fetch metrics from Ahrefs Brand Radar APIs
+3. **Analysis**: Calculate trends, compare competitors, analyze sentiment
+4. **Recommendations**: Generate actionable Korean-language recommendations
+5. **Output**: JSON report and Notion database entry
+
+## Ahrefs MCP Tools
+
+| Tool | Purpose |
+|------|---------|
+| `brand-radar-ai-responses` | AI-generated responses mentioning brand |
+| `brand-radar-cited-domains` | Domains cited in AI answers |
+| `brand-radar-cited-pages` | Specific pages cited in AI answers |
+| `brand-radar-impressions-history` | Impression trend over time |
+| `brand-radar-impressions-overview` | Current impression metrics |
+| `brand-radar-mentions-history` | Mention trend over time |
+| `brand-radar-mentions-overview` | Current mention metrics |
+| `brand-radar-sov-history` | Share of voice trend |
+| `brand-radar-sov-overview` | Current share of voice |
+
+## Notion Output
+
+All reports are saved to the OurDigital SEO Audit Log:
+- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
+- **Category**: AI Search Visibility
+- **Audit ID Format**: AI-YYYYMMDD-NNN
+- **Language**: Korean (technical terms in English)
+
+## Example Queries
+
+- "example.com의 AI 검색 가시성을 분석해줘"
+- "AI search visibility for example.com with competitors"
+- "브랜드 레이더 분석: example.com vs competitor.com"
+- "AI 인용 분석 - 어떤 페이지가 AI 답변에서 인용되나요?"
+- "Share of Voice in AI search for our domain"
--- a/custom-skills/27-seo-ai-visibility/desktop/skill.yaml
+++ b/custom-skills/27-seo-ai-visibility/desktop/skill.yaml
@@ -0,0 +1,8 @@
+name: seo-ai-visibility
+description: |
+  AI search visibility and brand radar monitoring. Triggers: AI search, AI visibility, brand radar, AI citations, share of voice, AI answers, AI mentions.
+allowed-tools:
+  - mcp__ahrefs__*
+  - mcp__notion__*
+  - WebSearch
+  - WebFetch
--- a/custom-skills/27-seo-ai-visibility/desktop/tools/ahrefs.md
+++ b/custom-skills/27-seo-ai-visibility/desktop/tools/ahrefs.md
@@ -0,0 +1,55 @@
+# Ahrefs Brand Radar MCP Tools
+
+## brand-radar-impressions-overview
+Get current AI search impression metrics for a target domain. Returns total impressions, change percentage, and breakdown by AI engine.
+
+**Parameters:**
+- `target` (required): Domain to analyze (e.g., "example.com")
+
+## brand-radar-impressions-history
+Get historical AI search impression data over time. Returns time-series data points with date and impression values.
+
+**Parameters:**
+- `target` (required): Domain to analyze
+
+## brand-radar-mentions-overview
+Get current AI mention metrics for a target domain. Returns total mentions, change percentage, and breakdown.
+
+**Parameters:**
+- `target` (required): Domain to analyze
+
+## brand-radar-mentions-history
+Get historical AI mention data over time. Returns time-series data points with date and mention values.
+
+**Parameters:**
+- `target` (required): Domain to analyze
+
+## brand-radar-sov-overview
+Get Share of Voice overview in AI search for a target domain. Returns brand SOV percentage and competitor SOV data.
+
+**Parameters:**
+- `target` (required): Domain to analyze
+
+## brand-radar-sov-history
+Get historical Share of Voice data over time. Returns time-series SOV data points.
+
+**Parameters:**
+- `target` (required): Domain to analyze
+
+## brand-radar-ai-responses
+Get AI-generated responses that mention the brand. Returns query, response text, sentiment, and source engine for each response.
+
+**Parameters:**
+- `target` (required): Domain to analyze
+
+## brand-radar-cited-domains
+Get domains cited in AI answers related to the brand. Returns domain name, citation count, topics, and share percentage.
+
+**Parameters:**
+- `target` (required): Domain to analyze
+
+## brand-radar-cited-pages
+Get specific pages cited in AI answers. Returns URL, title, citation count, context snippet, and topics.
+
+**Parameters:**
+- `target` (required): Domain to analyze
--- a/custom-skills/27-seo-ai-visibility/desktop/tools/notion.md
+++ b/custom-skills/27-seo-ai-visibility/desktop/tools/notion.md
@@ -0,0 +1,44 @@
+# Notion MCP Tools
+
+## Database: OurDigital SEO Audit Log
+
+- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
+- **URL**: https://www.notion.so/dintelligence/2c8581e58a1e8035880be38cefc2f3ef
+
+## Required Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| Issue | Title | Report title in Korean + date |
+| Site | URL | Tracked website URL |
+| Category | Select | "AI Search Visibility" |
+| Priority | Select | Based on SOV trend (Critical, High, Medium, Low) |
+| Found Date | Date | Report date (YYYY-MM-DD) |
+| Audit ID | Rich Text | Format: AI-YYYYMMDD-NNN |
+
+## Usage
+
+Use `notion-create-pages` to save audit results:
+
+```json
+{
+  "parent": {"database_id": "2c8581e5-8a1e-8035-880b-e38cefc2f3ef"},
+  "properties": {
+    "Issue": {"title": [{"text": {"content": "AI 검색 가시성 분석 - example.com (2025-01-15)"}}]},
+    "Site": {"url": "https://example.com"},
+    "Category": {"select": {"name": "AI Search Visibility"}},
+    "Priority": {"select": {"name": "Medium"}},
+    "Found Date": {"date": {"start": "2025-01-15"}},
+    "Audit ID": {"rich_text": [{"text": {"content": "AI-20250115-001"}}]}
+  }
+}
+```
+
+## Priority Guidelines
+
+| Condition | Priority |
+|-----------|----------|
+| SOV decreasing >10% | Critical |
+| SOV decreasing 3-10% | High |
+| SOV stable, low (<10%) | Medium |
+| SOV increasing or high (>25%) | Low |
--- a/custom-skills/27-seo-ai-visibility/desktop/tools/websearch.md
+++ b/custom-skills/27-seo-ai-visibility/desktop/tools/websearch.md
@@ -0,0 +1,17 @@
+# WebSearch & WebFetch Tools
+
+## WebSearch
+
+Use web search to supplement AI visibility analysis with additional context:
+- Research competitor AI optimization strategies
+- Find industry benchmarks for AI search visibility
+- Look up latest AI search engine algorithm updates
+- Discover best practices for AI citation optimization
+
+## WebFetch
+
+Use web fetch to retrieve specific pages for deeper analysis:
+- Fetch competitor pages that are frequently cited in AI answers
+- Retrieve structured data (Schema Markup) from cited pages
+- Analyze content structure of top-cited URLs
+- Check E-E-A-T signals on referenced pages