---
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"