SEO AI Visibility Monitor

Monitor and analyze brand visibility across AI-powered search and LLM platforms using DataForSEO AI Optimization API.

API Configuration

Credentials stored in ~/.config/dataforseo/auth (Base64 encoded).

AUTH=$(cat ~/.config/dataforseo/auth)

Quick Reference

Command	What it does
/seo ai-visibility domain <domain>	Check domain mentions across AI platforms
/seo ai-visibility keyword <keyword>	See which domains AI cites for a topic
/seo ai-visibility top-domains <keyword>	Top cited domains for a keyword
/seo ai-visibility top-pages <domain>	Most cited pages from a domain
/seo ai-visibility compare <domain1> <domain2>	Compare AI visibility between domains
/seo ai-visibility chatgpt <query>	Get ChatGPT response for query
/seo ai-visibility claude <query>	Get Claude response for query
/seo ai-visibility perplexity <query>	Get Perplexity response for query

API Endpoints

LLM Mentions Search (Domain/Keyword Monitoring)

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/search/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "target": [{"domain": "example.com"}],
    "platform": "google",
    "location_code": 2840,
    "language_code": "en",
    "limit": 100
  }]'

Top Domains for Keyword

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/top_domains/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "target": [{"keyword": "TARGET_KEYWORD"}],
    "platform": "google",
    "limit": 20
  }]'

Top Pages for Domain

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/top_pages/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "target": [{"domain": "example.com"}],
    "platform": "google",
    "limit": 50
  }]'

Aggregated Metrics

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/aggregated_metrics/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "target": [{"domain": "example.com"}],
    "platform": "google"
  }]'

Cross-Platform Aggregated Metrics

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "target": [{"domain": "example.com"}]
  }]'

ChatGPT Response

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "prompt": "YOUR_QUERY_HERE"
  }]'

Claude Response

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "prompt": "YOUR_QUERY_HERE"
  }]'

Gemini Response

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "prompt": "YOUR_QUERY_HERE"
  }]'

Perplexity Response

curl -s -X POST "https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{
    "prompt": "YOUR_QUERY_HERE"
  }]'

Analysis Modes

1. Domain AI Visibility Audit

Check how often a domain is cited by AI:

Input: domain (e.g., "example.com")
Output:
- Total AI mentions across platforms
- Questions/queries where cited
- Citation position (first source, etc.)
- Trend over time
- Competitor comparison

2. Keyword AI Landscape

See which domains AI cites for a topic:

Input: keyword (e.g., "best project management tools")
Output:
- Top cited domains
- Citation frequency per domain
- Content types that get cited
- Gap analysis (competitors cited, you're not)

3. AI Response Analysis

Get actual AI responses to understand context:

Input: query
Output:
- Raw AI response
- Sources cited
- How your brand is mentioned (if at all)
- Sentiment/positioning

4. Cross-Platform Comparison

Compare visibility across AI platforms:

Input: domain
Output:
- Google AI Overview visibility
- ChatGPT citation rate
- Claude citation rate
- Perplexity citation rate
- Platform-specific insights

Key Metrics

AI Visibility Score

• Mentions Count: Total times cited by AI
• Query Coverage: % of relevant queries where cited
• Citation Position: Average position in AI responses
• Source Diversity: Variety of pages being cited

Platform Breakdown

Platform	Data Available
Google AI Overview	Mentions, queries, citations
ChatGPT	Response content, brand mentions
Claude	Response content, brand mentions
Gemini	Response content, brand mentions
Perplexity	Response content, sources

Output Format

AI Visibility Report

# AI Visibility: [domain]
Generated: [Date]

## Overview
- Total AI Mentions: X
- Platforms Present: Google AIO, ChatGPT, Claude
- Top Cited Pages: X pages

## Google AI Overview
- Mentions: X
- Top Queries:
  1. "[query]" - cited in position 1
  2. "[query]" - cited in position 3

## Platform Comparison
| Platform | Mentions | Trend |
|----------|----------|-------|
| Google AIO | X | +15% |
| ChatGPT | X | +8% |
| Claude | X | New |

## Top Cited Content
| Page | Mentions | Queries |
|------|----------|---------|
| /guide | 45 | 23 |
| /blog/post | 32 | 18 |

## Recommendations
1. [Gap identified] - Create content for [topic]
2. [Opportunity] - Optimize [page] for AI citation

Keyword AI Landscape Report

# AI Landscape: "[keyword]"

## Top Cited Domains
| Rank | Domain | Mentions | Authority |
|------|--------|----------|-----------|
| 1 | competitor1.com | 89 | High |
| 2 | competitor2.com | 67 | High |
| 3 | your-domain.com | 23 | Medium |

## Citation Analysis
- Average sources per response: 5
- Content types cited:
  - Guides/tutorials: 45%
  - Product pages: 30%
  - Blog posts: 25%

## Gap Opportunities
Keywords where competitors are cited but you're not:
1. [keyword] - competitor1 cited
2. [keyword] - competitor2 cited

Strategic Implications

Why AI Visibility Matters

• Zero-click answers: AI provides direct answers, reducing clicks
• Authority signal: Being cited = AI trusts your content
• Future of search: AI search growing rapidly
• Brand presence: Mentioned = remembered

Optimization Strategies

1. Structured content: Clear headings, lists, definitions
2. E-E-A-T signals: Expertise, authoritativeness, trustworthiness
3. Comprehensive coverage: Answer related questions
4. Fresh content: Regular updates signal relevance
5. Citation-worthy: Stats, research, unique insights

Red Flags

• Zero AI mentions (invisible to AI search)
• Competitors heavily cited, you're not
• Only cited for branded queries
• Decreasing trend in mentions

Integration with Other Skills

• Use seo-content to optimize pages for AI citation
• Use seo-keywords to find queries where AI provides answers
• Use seo-serp to see AI Overview presence in SERPs
• Use seo-backlinks to build authority (correlates with AI trust)

Best Practices

Monitoring Cadence

Check	Frequency
Domain mentions	Weekly
Competitor comparison	Bi-weekly
Top keywords landscape	Monthly
Cross-platform audit	Monthly

Action Triggers

Signal	Action
Competitor cited, you're not	Create/optimize content
Mention dropped	Investigate content issues
New query emerging	Create content opportunity
Wrong page cited	Optimize correct page

[PROTOCOL]: Update this header on changes, then check CLAUDE.md