opencode-skills-antigravity 1.0.4 → 1.0.6

package/bundled-skills/seo-dataforseo/SKILL.md

@@ -0,0 +1,395 @@
+---
+name: seo-dataforseo
+description: "Use DataForSEO for live SERPs, keyword metrics, backlinks, competitor analysis, on-page checks, and AI visibility data. Trigger when the user needs real SEO data rather than static guidance."
+risk: unknown
+source: "https://github.com/AgriciDaniel/claude-seo"
+date_added: "2026-03-21"
+user-invokable: true
+argument-hint: "[command] [query]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - WebFetch
+  - Write
+---
+
+# DataForSEO: Live SEO Data (Extension)
+
+Live search data via the DataForSEO MCP server. Provides real-time SERP results,
+keyword metrics, backlink profiles, on-page analysis, content analysis, business
+listings, AI visibility checking, and LLM mention tracking across
+9 API modules with 79 MCP tools.
+
+## When to Use
+
+- Use when the user needs live SEO data instead of static best-practice guidance.
+- Use for SERP lookups, keyword volumes, backlink checks, competitor data, or AI visibility tracking.
+- Use only when the DataForSEO extension is available in the environment.
+
+## Prerequisites
+
+This skill requires the DataForSEO extension to be installed:
+```bash
+./extensions/dataforseo/install.sh
+```
+
+**Check availability:** Before using any DataForSEO tool, verify the MCP server
+is connected by checking if `serp_organic_live_advanced` or any DataForSEO tool
+is available. If tools are not available, inform the user the extension is not
+installed and provide install instructions.
+
+## API Credit Awareness
+
+DataForSEO charges per API call. Be efficient:
+- Prefer bulk endpoints over multiple single calls
+- Use default parameters (US, English) unless user specifies otherwise
+- Cache results mentally within a session; don't re-fetch the same data
+- Warn user before running expensive operations (full backlink crawls, large keyword lists)
+
+## Quick Reference
+
+| Command | What it does |
+|---------|-------------|
+| `/seo dataforseo serp <keyword>` | Google organic SERP results |
+| `/seo dataforseo serp-youtube <keyword>` | YouTube search results |
+| `/seo dataforseo youtube <video_id>` | YouTube video deep analysis |
+| `/seo dataforseo keywords <seed>` | Keyword ideas and suggestions |
+| `/seo dataforseo volume <keywords>` | Search volume for keywords |
+| `/seo dataforseo difficulty <keywords>` | Keyword difficulty scores |
+| `/seo dataforseo intent <keywords>` | Search intent classification |
+| `/seo dataforseo trends <keyword>` | Google Trends data |
+| `/seo dataforseo backlinks <domain>` | Full backlink profile |
+| `/seo dataforseo competitors <domain>` | Competitor domain analysis |
+| `/seo dataforseo ranked <domain>` | Ranked keywords for domain |
+| `/seo dataforseo intersection <domains>` | Keyword/backlink overlap |
+| `/seo dataforseo traffic <domains>` | Bulk traffic estimation |
+| `/seo dataforseo subdomains <domain>` | Subdomains with ranking data |
+| `/seo dataforseo top-searches <domain>` | Top queries mentioning domain |
+| `/seo dataforseo onpage <url>` | On-page analysis (Lighthouse + parsing) |
+| `/seo dataforseo tech <domain>` | Technology stack detection |
+| `/seo dataforseo whois <domain>` | WHOIS registration data |
+| `/seo dataforseo content <keyword/url>` | Content analysis and trends |
+| `/seo dataforseo listings <keyword>` | Business listings search |
+| `/seo dataforseo ai-scrape <query>` | ChatGPT web scraper for GEO |
+| `/seo dataforseo ai-mentions <keyword>` | LLM mention tracking for GEO |
+
+---
+
+## SERP Analysis
+
+### `/seo dataforseo serp <keyword>`
+
+Fetch live Google organic search results.
+
+**MCP tools:** `serp_organic_live_advanced`
+
+**Default parameters:** location_code=2840 (US), language_code=en, device=desktop, depth=100
+
+**Also supports:** The `serp_organic_live_advanced` tool supports Google, Bing, and Yahoo via the `se` parameter. Specify "bing" or "yahoo" to switch search engines.
+
+**Output:** Rank, URL, title, description, domain, featured snippets, AI overview references, People Also Ask.
+
+### `/seo dataforseo serp-youtube <keyword>`
+
+Fetch YouTube search results. Valuable for GEO. YouTube mentions correlate most strongly with AI citations.
+
+**MCP tools:** `serp_youtube_organic_live_advanced`
+
+**Output:** Video title, channel, views, upload date, description, URL.
+
+### `/seo dataforseo youtube <video_id>`
+
+Deep analysis of a specific YouTube video: info, comments, and subtitles. YouTube mentions have the strongest correlation (0.737) with AI visibility, making this critical for GEO analysis.
+
+**MCP tools:** `serp_youtube_video_info_live_advanced`, `serp_youtube_video_comments_live_advanced`, `serp_youtube_video_subtitles_live_advanced`
+
+**Parameters:** video_id (the YouTube video ID, e.g., "dQw4w9WgXcQ")
+
+**Output:** Video metadata (title, channel, views, likes, description), top comments with engagement, subtitle/transcript text.
+
+---
+
+## Keyword Research
+
+### `/seo dataforseo keywords <seed>`
+
+Generate keyword ideas, suggestions, and related terms from a seed keyword.
+
+**MCP tools:** `dataforseo_labs_google_keyword_ideas`, `dataforseo_labs_google_keyword_suggestions`, `dataforseo_labs_google_related_keywords`
+
+**Default parameters:** location_code=2840 (US), language_code=en, limit=50
+
+**Output:** Keyword, search volume, CPC, competition level, keyword difficulty, trend.
+
+### `/seo dataforseo volume <keywords>`
+
+Get search volume and metrics for a list of keywords.
+
+**MCP tools:** `kw_data_google_ads_search_volume`
+
+**Parameters:** keywords (array, comma-separated), location_code, language_code
+
+**Output:** Keyword, monthly search volume, CPC, competition, monthly trend data.
+
+### `/seo dataforseo difficulty <keywords>`
+
+Calculate keyword difficulty scores for ranking competitiveness.
+
+**MCP tools:** `dataforseo_labs_bulk_keyword_difficulty`
+
+**Parameters:** keywords (array), location_code, language_code
+
+**Output:** Keyword, difficulty score (0-100), interpretation (Easy/Medium/Hard/Very Hard).
+
+### `/seo dataforseo intent <keywords>`
+
+Classify keywords by user search intent.
+
+**MCP tools:** `dataforseo_labs_search_intent`
+
+**Parameters:** keywords (array), location_code, language_code
+
+**Output:** Keyword, intent type (informational, navigational, commercial, transactional), confidence score.
+
+### `/seo dataforseo trends <keyword>`
+
+Analyze keyword trends over time using Google Trends data.
+
+**MCP tools:** `kw_data_google_trends_explore`
+
+**Parameters:** keywords (array), location_code, date_from, date_to, language_code
+
+**Output:** Keyword, time series data, trend direction, seasonality signals.
+
+---
+
+## Domain & Competitor Analysis
+
+### `/seo dataforseo backlinks <domain>`
+
+Comprehensive backlink profile analysis.
+
+**MCP tools:** `backlinks_summary`, `backlinks_backlinks`, `backlinks_anchors`, `backlinks_referring_domains`, `backlinks_bulk_spam_score`, `backlinks_timeseries_summary`
+
+**Default parameters:** limit=100 per sub-call
+
+**Output:** Total backlinks, referring domains, domain rank, spam score, top anchors, new/lost backlinks over time, dofollow ratio, top referring domains.
+
+### `/seo dataforseo competitors <domain>`
+
+Identify competing domains and estimate traffic.
+
+**MCP tools:** `dataforseo_labs_google_competitors_domain`, `dataforseo_labs_google_domain_rank_overview`, `dataforseo_labs_bulk_traffic_estimation`
+
+**Output:** Competitor domains, keyword overlap %, estimated traffic, domain rank, common keywords.
+
+### `/seo dataforseo ranked <domain>`
+
+List keywords a domain ranks for with positions and page data.
+
+**MCP tools:** `dataforseo_labs_google_ranked_keywords`, `dataforseo_labs_google_relevant_pages`
+
+**Default parameters:** limit=100, location_code=2840
+
+**Output:** Keyword, position, URL, search volume, traffic share, SERP features.
+
+### `/seo dataforseo intersection <domain1> <domain2> [...]`
+
+Find shared keywords and backlink sources across 2-20 domains.
+
+**MCP tools:** `dataforseo_labs_google_domain_intersection`, `backlinks_domain_intersection`
+
+**Parameters:** domains (2-20 array)
+
+**Output:** Shared keywords with positions per domain, shared backlink sources, unique keywords per domain.
+
+### `/seo dataforseo traffic <domains>`
+
+Estimate organic search traffic for one or more domains.
+
+**MCP tools:** `dataforseo_labs_bulk_traffic_estimation`
+
+**Parameters:** domains (array)
+
+**Output:** Domain, estimated organic traffic, estimated traffic cost, top keywords.
+
+### `/seo dataforseo subdomains <domain>`
+
+Enumerate subdomains with their ranking data and traffic estimates.
+
+**MCP tools:** `dataforseo_labs_google_subdomains`
+
+**Parameters:** target (domain), location_code, language_code
+
+**Output:** Subdomain, ranked keywords count, estimated traffic, organic cost.
+
+### `/seo dataforseo top-searches <domain>`
+
+Find the most popular search queries that mention a specific domain in results.
+
+**MCP tools:** `dataforseo_labs_google_top_searches`
+
+**Parameters:** target (domain), location_code, language_code
+
+**Output:** Query, search volume, domain position, SERP features, traffic share.
+
+---
+
+## Technical / On-Page
+
+### `/seo dataforseo onpage <url>`
+
+Run on-page analysis including Lighthouse audit and content parsing.
+
+**MCP tools:** `on_page_instant_pages`, `on_page_content_parsing`, `on_page_lighthouse`
+
+**Usage:**
+- `on_page_instant_pages`:Quick page analysis (status codes, meta tags, content size, page timing, broken links, on-page checks)
+- `on_page_content_parsing`:Extract and parse page content (plain text, word count, structure)
+- `on_page_lighthouse`:Full Lighthouse audit (performance score, accessibility, best practices, SEO, Core Web Vitals)
+
+**Output:** Pages crawled, status codes, meta tags, titles, content size, load times, Lighthouse scores, broken links, resource analysis.
+
+### `/seo dataforseo tech <domain>`
+
+Detect technologies used on a domain.
+
+**MCP tools:** `domain_analytics_technologies_domain_technologies`
+
+**Output:** Technology name, version, category (CMS, analytics, CDN, framework, etc.).
+
+### `/seo dataforseo whois <domain>`
+
+Retrieve WHOIS registration data.
+
+**MCP tools:** `domain_analytics_whois_overview`
+
+**Output:** Registrar, creation date, expiration date, nameservers, registrant info (if public).
+
+---
+
+## Content & Business Data
+
+### `/seo dataforseo content <keyword/url>`
+
+Analyze content quality, search for content by topic, and track phrase trends.
+
+**MCP tools:** `content_analysis_search`, `content_analysis_summary`, `content_analysis_phrase_trends`
+
+**Parameters:** keyword (for search/trends) or URL (for summary)
+
+**Output:** Content matches with quality scores, sentiment analysis, readability metrics, phrase trend data over time.
+
+### `/seo dataforseo listings <keyword>`
+
+Search business listings for local SEO competitive analysis.
+
+**MCP tools:** `business_data_business_listings_search`
+
+**Parameters:** keyword, location (optional)
+
+**Output:** Business name, description, category, address, phone, domain, rating, review count, claimed status.
+
+---
+
+## AI Visibility / GEO
+
+### `/seo dataforseo ai-scrape <query>`
+
+Scrape what ChatGPT web search returns for a query. Real GEO visibility check: see which sources ChatGPT cites for your target keywords.
+
+**MCP tools:** `ai_optimization_chat_gpt_scraper`
+
+**Parameters:** query, location_code (optional), language_code (optional). Use `ai_optimization_chat_gpt_scraper_locations` to look up available locations.
+
+**Output:** ChatGPT response content, cited sources/URLs, referenced domains.
+
+### `/seo dataforseo ai-mentions <keyword>`
+
+Track how LLMs mention brands, domains, and topics. Critical for GEO. Measures actual AI visibility across multiple LLM platforms.
+
+**MCP tools:** `ai_opt_llm_ment_search`, `ai_opt_llm_ment_top_domains`, `ai_opt_llm_ment_top_pages`, `ai_opt_llm_ment_agg_metrics`
+
+**Parameters:** keyword, location_code (optional), language_code (optional). Use `ai_opt_llm_ment_loc_and_lang` for available locations/languages and `ai_optimization_llm_models` for supported LLM models.
+
+**Workflow:**
+1. Search LLM mentions with `ai_opt_llm_ment_search` (find mentions of a brand/keyword across LLM responses)
+2. Get top cited domains with `ai_opt_llm_ment_top_domains` (which domains are most cited for this topic)
+3. Get top cited pages with `ai_opt_llm_ment_top_pages` (which specific pages are most cited)
+4. Get aggregate metrics with `ai_opt_llm_ment_agg_metrics` (overall mention volume, trends)
+
+**Output:** LLM mention count, top cited domains with frequency, top cited pages, mention trends over time, cross-platform visibility scores.
+
+**Advanced:** Use `ai_opt_llm_ment_cross_agg_metrics` for cross-model comparison (how mentions differ across ChatGPT, Claude, Perplexity, etc.).
+
+---
+
+## Available Utility Tools
+
+These DataForSEO tools are available for internal use by the agent but do not have dedicated commands:
+
+- `serp_locations`:Location code lookups for SERP queries
+- `serp_youtube_locations`:Location code lookups for YouTube queries
+- `kw_data_google_ads_locations`:Location lookups for keyword data
+- `kw_data_dfs_trends_demography`:Demographic data for trend analysis
+- `kw_data_dfs_trends_subregion_interests`:Subregion interest data for trends
+- `kw_data_dfs_trends_explore`:DFS proprietary trends data
+- `kw_data_google_trends_categories`:Google Trends category lookups
+- `dataforseo_labs_google_keyword_overview`:Quick keyword metrics overview
+- `dataforseo_labs_google_historical_serp`:Historical SERP results for a keyword
+- `dataforseo_labs_google_serp_competitors`:Competitors for a specific SERP
+- `dataforseo_labs_google_keywords_for_site`:Keywords a site ranks for (alternative to ranked)
+- `dataforseo_labs_google_page_intersection`:Page-level intersection analysis
+- `dataforseo_labs_google_historical_rank_overview`:Historical domain rank data
+- `dataforseo_labs_google_historical_keyword_data`:Historical keyword metrics
+- `dataforseo_labs_available_filters`:Available filter options for Labs endpoints
+- `backlinks_competitors`:Find domains with similar backlink profiles
+- `backlinks_bulk_backlinks`:Bulk backlink counts for multiple targets
+- `backlinks_bulk_new_lost_referring_domains`:Bulk new/lost referring domains
+- `backlinks_bulk_new_lost_backlinks`:Bulk new/lost backlinks
+- `backlinks_bulk_ranks`:Bulk rank overview for multiple targets
+- `backlinks_bulk_referring_domains`:Bulk referring domain counts
+- `backlinks_domain_pages_summary`:Summary of pages on a domain
+- `backlinks_domain_pages`:List pages on a domain with backlink data
+- `backlinks_page_intersection`:Shared backlink sources at page level
+- `backlinks_referring_networks`:Referring network analysis
+- `backlinks_timeseries_new_lost_summary`:Track new/lost backlinks over time
+- `backlinks_bulk_pages_summary`:Bulk page summaries
+- `backlinks_available_filters`:Available filter options for Backlinks endpoints
+- `domain_analytics_whois_available_filters`:WHOIS filter options
+- `domain_analytics_technologies_available_filters`:Technology detection filter options
+- `ai_opt_kw_data_loc_and_lang`:AI optimization keyword data locations/languages
+- `ai_optimization_keyword_data_search_volume`:AI-specific keyword volume data
+- `ai_optimization_llm_response`:Direct LLM response analysis
+- `ai_optimization_llm_mentions_filters`:Available filters for LLM mentions
+- `ai_optimization_chat_gpt_scraper_locations`:Available locations for ChatGPT scraper
+
+## Cross-Skill Integration
+
+When DataForSEO MCP tools are available, other claude-seo skills can leverage live data:
+
+- **seo-audit**:Spawn `seo-dataforseo` agent for real SERP, backlink, on-page, and listings data
+- **seo-technical**:Use `on_page_instant_pages` / `on_page_lighthouse` for real crawl data, `domain_analytics_technologies_domain_technologies` for stack detection
+- **seo-content**:Use `kw_data_google_ads_search_volume`, `dataforseo_labs_bulk_keyword_difficulty`, `dataforseo_labs_search_intent` for real keyword metrics, `content_analysis_summary` for content quality
+- **seo-page**:Use `serp_organic_live_advanced` for real SERP positions, `backlinks_summary` for link data
+- **seo-geo**:Use `ai_optimization_chat_gpt_scraper` for real ChatGPT visibility, `ai_opt_llm_ment_search` for LLM mention tracking
+- **seo-plan**:Use `dataforseo_labs_google_competitors_domain`, `dataforseo_labs_google_domain_intersection`, `dataforseo_labs_bulk_traffic_estimation` for real competitive intelligence
+
+## Error Handling
+
+- **MCP server not connected**: Report that DataForSEO extension is not installed or MCP server is unreachable. Suggest running `./extensions/dataforseo/install.sh`
+- **API authentication failed**: Report invalid credentials. Suggest checking DataForSEO API login/password in MCP config
+- **Rate limit exceeded**: Report the limit hit and suggest waiting before retrying
+- **No results returned**: Report "no data found" for the query rather than guessing. Suggest broadening the query or checking location/language codes
+- **Invalid location code**: Report the error and suggest using the locations lookup tool to find the correct code
+
+## Output Formatting
+
+Match existing claude-seo output patterns:
+- Use tables for comparative data
+- Prioritize issues as Critical > High > Medium > Low
+- Include specific, actionable recommendations
+- Show scores as XX/100 where applicable
+- Note data source as "DataForSEO (live)" to distinguish from static analysis

package/bundled-skills/seo-geo/SKILL.md

@@ -0,0 +1,254 @@
+---
+name: seo-geo
+description: "Optimize content for AI Overviews, ChatGPT, Perplexity, and other AI search systems. Use when improving GEO, AI citations, llms.txt readiness, crawler accessibility, and passage-level citability."
+risk: unknown
+source: "https://github.com/AgriciDaniel/claude-seo"
+date_added: "2026-03-21"
+user-invokable: true
+argument-hint: "[url]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - WebFetch
+---
+
+# AI Search / GEO Optimization (February 2026)
+
+## When to Use
+
+- Use when improving visibility in AI Overviews, ChatGPT, Perplexity, or similar AI search systems.
+- Use when evaluating llms.txt readiness, AI crawler access, or citation-oriented content structure.
+- Use when the user asks about GEO, AI SEO, LLM visibility, or AI citations.
+
+## Key Statistics
+
+| Metric | Value | Source |
+|--------|-------|--------|
+| AI Overviews reach | 1.5 billion users/month across 200+ countries | Google |
+| AI Overviews query coverage | 50%+ of all queries | Industry data |
+| AI-referred sessions growth | 527% (Jan-May 2025) | SparkToro |
+| ChatGPT weekly active users | 900 million | OpenAI |
+| Perplexity monthly queries | 500+ million | Perplexity |
+
+## Critical Insight: Brand Mentions > Backlinks
+
+**Brand mentions correlate 3x more strongly with AI visibility than backlinks.**
+(Ahrefs December 2025 study of 75,000 brands)
+
+| Signal | Correlation with AI Citations |
+|--------|------------------------------|
+| YouTube mentions | ~0.737 (strongest) |
+| Reddit mentions | High |
+| Wikipedia presence | High |
+| LinkedIn presence | Moderate |
+| Domain Rating (backlinks) | ~0.266 (weak) |
+
+**Only 11% of domains** are cited by both ChatGPT and Google AI Overviews for the same query, so platform-specific optimization is essential.
+
+---
+
+## GEO Analysis Criteria (Updated)
+
+### 1. Citability Score (25%)
+
+**Optimal passage length: 134-167 words** for AI citation.
+
+**Strong signals:**
+- Clear, quotable sentences with specific facts/statistics
+- Self-contained answer blocks (can be extracted without context)
+- Direct answer in first 40-60 words of section
+- Claims attributed with specific sources
+- Definitions following "X is..." or "X refers to..." patterns
+- Unique data points not found elsewhere
+
+**Weak signals:**
+- Vague, general statements
+- Opinion without evidence
+- Buried conclusions
+- No specific data points
+
+### 2. Structural Readability (20%)
+
+**92% of AI Overview citations come from top-10 ranking pages**, but 47% come from pages ranking below position 5, demonstrating different selection logic.
+
+**Strong signals:**
+- Clean H1->H2->H3 heading hierarchy
+- Question-based headings (matches query patterns)
+- Short paragraphs (2-4 sentences)
+- Tables for comparative data
+- Ordered/unordered lists for step-by-step or multi-item content
+- FAQ sections with clear Q&A format
+
+**Weak signals:**
+- Wall of text with no structure
+- Inconsistent heading hierarchy
+- No lists or tables
+- Information buried in paragraphs
+
+### 3. Multi-Modal Content (15%)
+
+Content with multi-modal elements sees **156% higher selection rates**.
+
+**Check for:**
+- Text + relevant images
+- Video content (embedded or linked)
+- Infographics and charts
+- Interactive elements (calculators, tools)
+- Structured data supporting media
+
+### 4. Authority & Brand Signals (20%)
+
+**Strong signals:**
+- Author byline with credentials
+- Publication date and last-updated date
+- Citations to primary sources (studies, official docs, data)
+- Organization credentials and affiliations
+- Expert quotes with attribution
+- Entity presence in Wikipedia, Wikidata
+- Mentions on Reddit, YouTube, LinkedIn
+
+**Weak signals:**
+- Anonymous authorship
+- No dates
+- No sources cited
+- No brand presence across platforms
+
+### 5. Technical Accessibility (20%)
+
+**AI crawlers do NOT execute JavaScript.** Server-side rendering is critical.
+
+**Check for:**
+- Server-side rendering (SSR) vs client-only content
+- AI crawler access in robots.txt
+- llms.txt file presence and configuration
+- RSL 1.0 licensing terms
+
+---
+
+## AI Crawler Detection
+
+Check `robots.txt` for these AI crawlers:
+
+| Crawler | Owner | Purpose |
+|---------|-------|---------|
+| GPTBot | OpenAI | ChatGPT web search |
+| OAI-SearchBot | OpenAI | OpenAI search features |
+| ChatGPT-User | OpenAI | ChatGPT browsing |
+| ClaudeBot | Anthropic | Claude web features |
+| PerplexityBot | Perplexity | Perplexity AI search |
+| CCBot | Common Crawl | Training data (often blocked) |
+| anthropic-ai | Anthropic | Claude training |
+| Bytespider | ByteDance | TikTok/Douyin AI |
+| cohere-ai | Cohere | Cohere models |
+
+**Recommendation:** Allow GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot for AI search visibility. Block CCBot and training crawlers if desired.
+
+---
+
+## llms.txt Standard
+
+The emerging **llms.txt** standard provides AI crawlers with structured content guidance.
+
+**Location:** `/llms.txt` (root of domain)
+
+**Format:**
+```
+# Title of site
+> Brief description
+
+## Main sections
+- `Page title -> https://example.com/page`: Description
+- `Another page -> https://example.com/another-page`: Description
+
+## Optional: Key facts
+- Fact 1
+- Fact 2
+```
+
+**Check for:**
+- Presence of `/llms.txt`
+- Structured content guidance
+- Key page highlights
+- Contact/authority information
+
+---
+
+## RSL 1.0 (Really Simple Licensing)
+
+New standard (December 2025) for machine-readable AI licensing terms.
+
+**Backed by:** Reddit, Yahoo, Medium, Quora, Cloudflare, Akamai, Creative Commons
+
+**Check for:** RSL implementation and appropriate licensing terms.
+
+---
+
+## Platform-Specific Optimization
+
+| Platform | Key Citation Sources | Optimization Focus |
+|----------|---------------------|-------------------|
+| **Google AI Overviews** | Top-10 ranking pages (92%) | Traditional SEO + passage optimization |
+| **ChatGPT** | Wikipedia (47.9%), Reddit (11.3%) | Entity presence, authoritative sources |
+| **Perplexity** | Reddit (46.7%), Wikipedia | Community validation, discussions |
+| **Bing Copilot** | Bing index, authoritative sites | Bing SEO, IndexNow |
+
+---
+
+## Output
+
+Generate `GEO-ANALYSIS.md` with:
+
+1. **GEO Readiness Score: XX/100**
+2. **Platform breakdown** (Google AIO, ChatGPT, Perplexity scores)
+3. **AI Crawler Access Status** (which crawlers allowed/blocked)
+4. **llms.txt Status** (present, missing, recommendations)
+5. **Brand Mention Analysis** (presence on Wikipedia, Reddit, YouTube, LinkedIn)
+6. **Passage-Level Citability** (optimal 134-167 word blocks identified)
+7. **Server-Side Rendering Check** (JavaScript dependency analysis)
+8. **Top 5 Highest-Impact Changes**
+9. **Schema Recommendations** (for AI discoverability)
+10. **Content Reformatting Suggestions** (specific passages to rewrite)
+
+---
+
+## Quick Wins
+
+1. Add "What is [topic]?" definition in first 60 words
+2. Create 134-167 word self-contained answer blocks
+3. Add question-based H2/H3 headings
+4. Include specific statistics with sources
+5. Add publication/update dates
+6. Implement Person schema for authors
+7. Allow key AI crawlers in robots.txt
+
+## Medium Effort
+
+1. Create `/llms.txt` file
+2. Add author bio with credentials + Wikipedia/LinkedIn links
+3. Ensure server-side rendering for key content
+4. Build entity presence on Reddit, YouTube
+5. Add comparison tables with data
+6. Implement FAQ sections (structured, not schema for commercial sites)
+
+## High Impact
+
+1. Create original research/surveys (unique citability)
+2. Build Wikipedia presence for brand/key people
+3. Establish YouTube channel with content mentions
+4. Implement comprehensive entity linking (sameAs across platforms)
+5. Develop unique tools or calculators
+
+## DataForSEO Integration (Optional)
+
+If DataForSEO MCP tools are available, use `ai_optimization_chat_gpt_scraper` to check what ChatGPT web search returns for target queries (real GEO visibility check) and `ai_opt_llm_ment_search` with `ai_opt_llm_ment_top_domains` for LLM mention tracking across AI platforms.
+
+## Error Handling
+
+| Scenario | Action |
+|----------|--------|
+| URL unreachable (DNS failure, connection refused) | Report the error clearly. Do not guess site content. Suggest the user verify the URL and try again. |
+| AI crawlers blocked by robots.txt | Report exactly which crawlers are blocked and which are allowed. Provide specific robots.txt directives to add for enabling AI search visibility. |
+| No llms.txt found | Note the absence and provide a ready-to-use llms.txt template based on the site's content structure. |
+| No structured data detected | Report the gap and provide specific schema recommendations (Article, Organization, Person) for improving AI discoverability. |