iannuttall/seo

What it solves

SEO Skill provides a unified command-line interface and MCP server that allows users and AI agents to perform comprehensive SEO audits, keyword research, and competitor analysis. It eliminates the need for heavy dashboards by turning crawl data, Google Search Console, traffic analytics, and third-party research providers into actionable, ranked lists of fixes and opportunities.

How it works

The tool operates as a local command (seo) and an MCP server. It integrates first-party data from Google Search Console and Google Analytics, as well as optional third-party research providers like DataForSEO, Semrush, and Ahrefs. It crawls sites to find technical blockers and combines this with search performance data to prioritize work based on actual visibility and analytics value. The system maintains a strict separation between observed evidence and derived findings to ensure reports are defensible.

Who it’s for

• Site owners who want a clear, prioritized list of SEO fixes without using complex dashboards.
• AI agents that require deterministic JSON, Markdown, and a compact MCP surface to access real crawl and search evidence instead of guessing.
• Developers who want to embed SEO reporting engines into scripts, CI jobs, or TypeScript applications.

Highlights

• Agent-Ready: Provides an MCP server and structured JSON/Markdown output for AI agents.
• Lined-up Evidence: Separates raw data from findings, ensuring every claim is backed by a crawl row or provider row.
• Multi-Provider Support: Built-in support for DataForSEO, Semrush, and Ahrefs, with an extensible provider SDK for adding new analytics or research tools.
• Comprehensive Audits: Covers technical blockers (metadata, indexability, performance), keyword gaps, and AI mention research.
• Deterministic Reporting: Offers stable rule IDs and matched before-and-after Search Console windows to measure changes.