Andrew Yim
d2d0a2d460
New skills: - Skill 33: Site migration planner with redirect mapping and monitoring - Skill 34: Reporting dashboard with HTML charts and Korean executive reports Bug fixes (Skill 34 - report_aggregator.py): - Add audit_type fallback for skill identification (was only using audit_id prefix) - Extract health scores from nested data dict (technical_score, onpage_score, etc.) - Support subdomain matching in domain filter (blog.ourdigital.org matches ourdigital.org) - Skip self-referencing DASH- aggregated reports Bug fixes (Skill 20 - naver_serp_analyzer.py): - Remove VIEW tab selectors (removed by Naver in 2026) - Add new section detectors: books (도서), shortform (숏폼), influencer (인플루언서) Improvements (Skill 34 - dashboard/executive report): - Add Korean category labels for Chart.js charts (기술 SEO, 온페이지, etc.) - Add Korean trend labels (개선 중 ↑, 안정 →, 하락 중 ↓) - Add English→Korean issue description translation layer (20 common patterns) Documentation improvements: - Add Korean triggers to 4 skill descriptions (19, 25, 28, 31) - Expand Skill 32 SKILL.md from 40→143 lines (was 6/10, added workflow, output format, limitations) - Add output format examples to Skills 27 and 28 SKILL.md - Add limitations sections to Skills 27 and 28 - Update README.md, CLAUDE.md, AGENTS.md for skills 33-34 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
116 lines
4.0 KiB
Markdown
116 lines
4.0 KiB
Markdown
---
|
|
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)
|
|
|
|
## Output Format
|
|
|
|
```json
|
|
{
|
|
"domain": "example.com",
|
|
"impressions": {
|
|
"total": 15000,
|
|
"trend": "increasing",
|
|
"period": "30d"
|
|
},
|
|
"mentions": {
|
|
"total": 450,
|
|
"positive": 320,
|
|
"neutral": 100,
|
|
"negative": 30,
|
|
"sentiment_score": 0.72
|
|
},
|
|
"share_of_voice": {
|
|
"domain_sov": 12.5,
|
|
"competitors": {
|
|
"competitor1.com": 18.3,
|
|
"competitor2.com": 15.1
|
|
}
|
|
},
|
|
"cited_pages": [
|
|
{"url": "https://example.com/guide", "citations": 45},
|
|
{"url": "https://example.com/faq", "citations": 28}
|
|
],
|
|
"cited_domains": [
|
|
{"domain": "example.com", "citations": 120},
|
|
{"domain": "competitor1.com", "citations": 95}
|
|
],
|
|
"recommendations": [
|
|
"Create more FAQ-style content for AI citation capture",
|
|
"Add structured data to improve AI answer extraction"
|
|
],
|
|
"audit_id": "AI-20250115-001",
|
|
"timestamp": "2025-01-15T14:30:00"
|
|
}
|
|
```
|
|
|
|
## Limitations
|
|
|
|
- Requires Ahrefs Brand Radar API access (not available in basic plans)
|
|
- AI search landscape changes rapidly; data may not reflect real-time state
|
|
- Share of Voice metrics are relative to tracked competitor set only
|
|
- Sentiment analysis based on AI-generated text, not user perception
|
|
- Cannot distinguish between different AI engines (ChatGPT, Gemini, Perplexity) without Brand Radar
|
|
|
|
## 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"
|