antigravity-seo-kit 2.0.0

package/.agent/skills/seo-content/SKILL.md

@@ -0,0 +1,230 @@
+---
+name: seo-content
+description: >
+  Content quality and E-E-A-T analysis with AI citation readiness assessment.
+  Use when user says "content quality", "E-E-A-T", "content analysis",
+  "readability check", "thin content", or "content audit".
+---
+
+# Content Quality & E-E-A-T Analysis
+
+## E-E-A-T Framework (updated Sept 2025 QRG)
+
+Read `seo/references/eeat-framework.md` for full criteria.
+
+### Experience (first-hand signals)
+- Original research, case studies, before/after results
+- Personal anecdotes, process documentation
+- Unique data, proprietary insights
+- Photos/videos from direct experience
+
+### Expertise
+- Author credentials, certifications, bio
+- Professional background relevant to topic
+- Technical depth appropriate for audience
+- Accurate, well-sourced claims
+
+### Authoritativeness
+- External citations, backlinks from authoritative sources
+- Brand mentions, industry recognition
+- Published in recognized outlets
+- Cited by other experts
+
+### Trustworthiness
+- Contact information, physical address
+- Privacy policy, terms of service
+- Customer testimonials, reviews
+- Date stamps, transparent corrections
+- Secure site (HTTPS)
+
+## Content Metrics
+
+### Word Count Analysis
+Compare against page type minimums:
+| Page Type | Minimum |
+|-----------|---------|
+| Homepage | 500 |
+| Service page | 800 |
+| Blog post | 1,500 |
+| Product page | 300+ (400+ for complex products) |
+| Location page | 500-600 |
+
+> **Important:** These are **topical coverage floors**, not targets. Google has confirmed word count is NOT a direct ranking factor. The goal is comprehensive topical coverage; a 500-word page that thoroughly answers the query will outrank a 2,000-word page that doesn't. Use these as guidelines for adequate coverage depth, not rigid requirements.
+
+### Readability
+- Flesch Reading Ease: target 60-70 for general audience
+
+> **Note:** Flesch Reading Ease is a useful proxy for content accessibility but is NOT a direct Google ranking factor. John Mueller has confirmed Google does not use basic readability scores for ranking. Yoast deprioritized Flesch scores in v19.3. Use readability analysis as a content quality indicator, not as an SEO metric to optimize directly.
+- Grade level: match target audience
+- Sentence length: average 15-20 words
+- Paragraph length: 2-4 sentences
+
+### Keyword Optimization
+- Primary keyword in title, H1, first 100 words
+- Natural density (1-3%)
+- Semantic variations present
+- No keyword stuffing
+
+### Content Structure
+- Logical heading hierarchy (H1 -> H2 -> H3)
+- Scannable sections with descriptive headings
+- Bullet/numbered lists where appropriate
+- Table of contents for long-form content
+
+### Multimedia
+- Relevant images with proper alt text
+- Videos where appropriate
+- Infographics for complex data
+- Charts/graphs for statistics
+
+### Internal Linking
+- 3-5 relevant internal links per 1000 words
+- Descriptive anchor text
+- Links to related content
+- No orphan pages
+
+### External Linking
+- Cite authoritative sources
+- Open in new tab for user experience
+- Reasonable count (not excessive)
+
+## AI Content Assessment (Sept 2025 QRG addition)
+
+Google's raters now formally assess whether content appears AI-generated.
+
+### Acceptable AI Content
+- Demonstrates genuine E-E-A-T
+- Provides unique value
+- Has human oversight and editing
+- Contains original insights
+
+### Low-Quality AI Content Markers
+- Generic phrasing, lack of specificity
+- No original insight
+- Repetitive structure across pages
+- No author attribution
+- Factual inaccuracies
+
+> **Helpful Content System (March 2024):** The Helpful Content System was merged into Google's core ranking algorithm during the March 2024 core update. It no longer operates as a standalone classifier. Helpfulness signals are now weighted within every core update. The same principles apply (people-first content, demonstrating E-E-A-T, satisfying user intent), but enforcement is continuous rather than through separate HCU updates.
+
+## AI Citation Readiness (GEO signals)
+
+Optimize for AI search engines (ChatGPT, Perplexity, Google AI Overviews):
+
+- Clear, quotable statements with statistics/facts
+- Structured data (especially for data points)
+- Strong heading hierarchy (H1->H2->H3 flow)
+- Answer-first formatting for key questions
+- Tables and lists for comparative data
+- Clear attribution and source citations
+
+### AI Search Visibility & GEO (2025-2026)
+
+**Google AI Mode** launched publicly in May 2025 as a separate tab in Google Search, available in 180+ countries. Unlike AI Overviews (which appear above organic results), AI Mode provides a fully conversational search experience with **zero organic blue links**, making AI citation the only visibility mechanism.
+
+**Key optimization strategies for AI citation:**
+- **Structured answers:** Clear question-answer formats, definition patterns, and step-by-step instructions that AI systems can extract and cite
+- **First-party data:** Original research, statistics, case studies, and unique datasets are highly cited by AI systems
+- **Schema markup:** Article, FAQ (for non-Google AI platforms), and structured content schemas help AI systems parse and attribute content
+- **Topical authority:** AI systems preferentially cite sources that demonstrate deep expertise. Build content clusters, not isolated pages
+- **Entity clarity:** Ensure brand, authors, and key concepts are clearly defined with structured data (Organization, Person schema)
+- **Multi-platform tracking:** Monitor visibility across Google AI Overviews, AI Mode, ChatGPT, Perplexity, and Bing Copilot, not just traditional rankings. Treat AI citation as a standalone KPI alongside organic rankings and traffic.
+
+**Generative Engine Optimization (GEO):**
+GEO is the emerging discipline of optimizing content specifically for AI-generated answers. Key GEO signals include: quotability (clear, concise extractable facts), attribution (source citations within your content), structure (well-organized heading hierarchy), and freshness (regularly updated data). Cross-reference the `seo-geo` skill for detailed GEO workflows.
+
+## Content Freshness
+
+- Publication date visible
+- Last updated date if content has been revised
+- Flag content older than 12 months without update for fast-changing topics
+
+## Output
+
+### Content Quality Score: XX/100
+
+### E-E-A-T Breakdown
+| Factor | Score | Key Signals |
+|--------|-------|-------------|
+| Experience | XX/25 | ... |
+| Expertise | XX/25 | ... |
+| Authoritativeness | XX/25 | ... |
+| Trustworthiness | XX/25 | ... |
+
+### AI Citation Readiness: XX/100
+
+### Issues Found
+### Recommendations
+
+## DataForSEO Integration (Optional)
+
+If DataForSEO MCP tools are available, use `kw_data_google_ads_search_volume` for real keyword volume data, `dataforseo_labs_bulk_keyword_difficulty` for difficulty scores, `dataforseo_labs_search_intent` for intent classification, and `content_analysis_summary` for content quality analysis.
+
+## Error Handling
+
+| Scenario | Action |
+|----------|--------|
+| URL unreachable (DNS failure, connection refused) | Report the error clearly. Do not guess page content. Suggest the user verify the URL and try again. |
+| Content behind paywall (402/403, login wall) | Report that the content is not publicly accessible. Analyze only the visible portion (meta tags, headers) and note the limitation. |
+| Thin content (fewer than 100 words retrievable) | Report the findings as-is rather than guessing. Flag the page as potentially JavaScript-rendered or gated, and suggest the user provide the full text directly. |
+
+## Specialist Role Instructions
+
+When operating as a specialist during audits:
+
+You are a Content Quality specialist following Google's September 2025 Quality Rater Guidelines.
+
+When given content to analyze:
+
+1. Assess E-E-A-T signals (Experience, Expertise, Authoritativeness, Trustworthiness)
+2. Check word count against page type minimums
+3. Calculate readability metrics
+4. Evaluate keyword optimization (natural, not stuffed)
+5. Assess AI citation readiness (quotable facts, structured data, clear hierarchy)
+6. Check content freshness and update signals
+7. Flag potential AI-generated content quality issues per Sept 2025 QRG criteria
+
+## E-E-A-T Scoring
+
+| Factor | Weight | What to Look For |
+|--------|--------|------------------|
+| Experience | 20% | First-hand signals, original content, case studies |
+| Expertise | 25% | Author credentials, technical accuracy |
+| Authoritativeness | 25% | External recognition, citations, reputation |
+| Trustworthiness | 30% | Contact info, transparency, security |
+
+## Content Minimums
+
+| Page Type | Min Words |
+|-----------|-----------|
+| Homepage | 500 |
+| Service page | 800 |
+| Blog post | 1,500 |
+| Product page | 300+ (400+ for complex products) |
+| Location page | 500-600 |
+
+> **Note:** These are topical coverage floors, not targets. Google confirms word count is NOT a direct ranking factor. The goal is comprehensive topical coverage.
+
+## AI Content Assessment (Sept 2025 QRG)
+
+AI content is acceptable IF it demonstrates genuine E-E-A-T. Flag these markers of low-quality AI content:
+- Generic phrasing, lack of specificity
+- No original insight or unique perspective
+- No first-hand experience signals
+- Factual inaccuracies
+- Repetitive structure across pages
+
+> **Helpful Content System (March 2024):** The Helpful Content System was merged into Google's core ranking algorithm during the March 2024 core update. It no longer operates as a standalone classifier. Helpfulness signals are now evaluated within every core update.
+
+## Cross-Skill Delegation
+
+- For evaluating programmatically generated pages, defer to the `seo-programmatic` sub-skill.
+- For comparison page content standards, see `seo-competitor-pages`.
+
+## Output Format
+
+Provide:
+- Content quality score (0-100)
+- E-E-A-T breakdown with scores per factor
+- AI citation readiness score
+- Specific improvement recommendations

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

@@ -0,0 +1,418 @@
+---
+name: seo-dataforseo
+description: >
+  Live SEO data via DataForSEO MCP server. SERP analysis (Google, Bing, Yahoo,
+  YouTube), keyword research (volume, difficulty, intent, trends), backlink
+  profiles, on-page analysis (Lighthouse, content parsing), competitor analysis,
+  content analysis, business listings, AI visibility (ChatGPT scraper, LLM
+  mention tracking), and domain analytics. Requires DataForSEO extension
+  installed. Use when user says "dataforseo", "live SERP", "keyword volume",
+  "backlink data", "competitor data", "AI visibility check", "LLM mentions",
+  or "real search data".
+---
+
+# 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.
+
+## 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 seo-kit skills can leverage live data:
+
+- **seo-audit**: Activate `seo-dataforseo` skill 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 seo-kit 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
+
+## Specialist Role Instructions
+
+When operating as a specialist during audits:
+
+You are a DataForSEO data analyst. When delegated tasks during an SEO audit or analysis:
+
+1. Check that DataForSEO MCP tools are available before attempting calls
+2. Use the most efficient tool combination for the requested data
+3. Apply default parameters: location_code=2840 (US), language_code=en unless specified
+4. Format output to match seo-kit conventions (tables, priority levels, scores)
+
+### Efficient Tool Usage
+
+- **Prefer bulk endpoints** over multiple single calls to minimize API credits
+- **Don't re-fetch** data already retrieved in the same session
+- **Warn before expensive operations** (full backlink crawls, large keyword lists)
+- **Use limits**: default to limit=100 for list endpoints unless user needs more
+
+### Error Handling
+
+- If a DataForSEO tool returns an error, report the error clearly to the user
+- If credentials are invalid, suggest running the extension installer again
+- If a module is not enabled, note which module is needed
+
+### Output Format
+
+Match existing seo-kit patterns:
+- Tables for comparative data
+- Scores as XX/100
+- Priority: Critical > High > Medium > Low
+- Note data source as "DataForSEO (live)" to distinguish from static HTML analysis
+- Include timestamps for time-sensitive data (SERP positions, backlink counts)