How seoskillsai/seo-skills-ai works
SEO Skills is an AI-agent-oriented SEO audit and optimization suite with a deterministic Python engine. A user invokes an audit through the MCP server or directly; the audit fetches a page, parses its HTML, validates structured data, and returns scores and issues. Review-only remediation can turn audit findings into suggested snippets. Separate tools cover crawling, regression tracking, search analytics, performance, indexing, and content discovery. The supplied excerpts show the main audit and MCP paths; several other capabilities are documented in the README but their internal wiring was not sampled.
Main entry points: mcp_server.py MCP tools · full_audit.py Full audit · drift_compare.py Drift comparison · fetch_page.py Page fetcher
Components 27
Agent interfaces
- MCP tools
scripts/mcp_server.py
Audit engine
- Full audit
scripts/full_audit.py - Page fetcher
scripts/fetch_page.py - HTML parser
scripts/parse_html.py - Schema validator
scripts/schema_validator.py - Patch suggestions
scripts/remediation_engine.py - Site crawler
scripts/site_crawler.py - Drift comparison
scripts/drift_compare.py
Search analytics
- Google credentials
scripts/google_installed_app.py - Search Console
scripts/gsc_query.py - GA4 reporting
scripts/ga4_report.py
SEO tools
- Keyword analysis
scripts/analyze_keywords.py - Information gain
scripts/information_gain.py - LLMs.txt builder
scripts/llms_txt_builder.py - Discover RSS
scripts/discover_rss_builder.py - Consent validator
scripts/consent_mode.py - Speculation rules
scripts/speculation_rules.py - Reputation scanner
scripts/parasite_seo.py - PageSpeed check
scripts/pagespeed_check.py - Indexing notifier
scripts/indexing_notify.py - Bing Webmaster
scripts/bing_webmaster.py - DataForSEO adapter
scripts/dataforseo_api.py - Firecrawl adapter
scripts/firecrawl_api.py
Shared safeguards
- JSON HTTP client
scripts/http_json.py - URL policy
scripts/url_safety.py - Output path policy
scripts/path_safety.py
Other components
- SEO user
Connections 36
- SEO user → MCP tools: invokes tools
README.md - MCP tools → Full audit: dispatches audit
scripts/mcp_server.py - MCP tools → Schema validator: dispatches validation
scripts/mcp_server.py - MCP tools → Drift comparison: dispatches comparison
scripts/mcp_server.py - MCP tools → Search Console: dispatches query
scripts/mcp_server.py - MCP tools → GA4 reporting: dispatches report
scripts/mcp_server.py - Full audit → Page fetcher: fetches page
scripts/full_audit.py - Full audit → HTML parser: parses HTML
scripts/full_audit.py - Full audit → Schema validator: validates schemas
scripts/full_audit.py - Patch suggestions → Full audit: runs audit
scripts/remediation_engine.py - Page fetcher → URL policy: checks targets
scripts/fetch_page.py - Search Console → Google credentials: refreshes token
scripts/gsc_query.py - Search Console → JSON HTTP client: sends query
scripts/gsc_query.py - GA4 reporting → Google credentials: uses credentials
scripts/ga4_report.py - GA4 reporting → JSON HTTP client: requests report
scripts/ga4_report.py - JSON HTTP client → URL policy: validates endpoint
scripts/http_json.py - Site crawler → Page fetcher: fetches pages
scripts/site_crawler.py - Site crawler → HTML parser: parses pages
scripts/site_crawler.py - Drift comparison → Page fetcher: fetches page
scripts/drift_compare.py - Drift comparison → HTML parser: parses page
scripts/drift_compare.py - LLMs.txt builder → Output path policy: writes safely
scripts/llms_txt_builder.py - Discover RSS → Output path policy: writes safely
scripts/discover_rss_builder.py - SEO user → Site crawler: runs crawl
README.md - SEO user → Drift comparison: checks drift
README.md - SEO user → Keyword analysis: analyzes topics
README.md - SEO user → Information gain: scores novelty
README.md - SEO user → LLMs.txt builder: builds llms.txt
README.md - SEO user → Discover RSS: builds feeds
README.md - SEO user → Consent validator: checks consent
README.md - SEO user → Speculation rules: checks standards
README.md - SEO user → Reputation scanner: scans reputation
README.md - SEO user → PageSpeed check: checks performance
README.md - SEO user → Indexing notifier: notifies indexing
README.md - SEO user → Bing Webmaster: queries webmaster
README.md - SEO user → DataForSEO adapter: uses adapter
README.md - SEO user → Firecrawl adapter: uses adapter
README.md