TAU-HOME.COM
LOADING

SEO Skill: Open-Source MCP Server and CLI Connecting Search Console and Crawl Data to AI Agents

An overview of SEO Skill, an Apache-2.0 open-source MCP server and CLI that feeds live Google Search Console, Analytics, Bing, and local crawl data directly int

tau · November 15, 2026

#SEO #MCP #AI-Agent #CLI #SearchConsole

SEO Skill: Open-Source MCP Server and CLI Connecting Search Console and Crawl Data to AI Agents

SEO Skill (iannuttall/seo) is an open-source (Apache-2.0) Model Context Protocol (MCP) server and command-line interface (CLI) that connects live site performance and technical crawl data directly to AI agents. Instead of letting language models guess optimization steps from generic checklists or third-party keyword estimates, it exposes verified metrics from Google Search Console (GSC), Google Analytics (GA), Bing, Clicky, Simple Analytics, and local site crawls.

Overview card illustrating SEO Skill open-source MCP server and CLI commands for Search Console and site crawl data

Image source: https://x.com/DanKornas/status/2111943900277469488

The tool works either as a hosted remote MCP endpoint for compatible coding and desktop agents—such as Claude Code, Cursor, Codex, and Claude Desktop—or as a locally installed npm CLI package. Created on July 10, 2026, the repository's changelog documents active iteration through version 0.19.0 as of November 13, 2026.

Why It Exists and How the Architecture Works

When asked why organic search traffic dropped on a website, a standard AI agent typically outputs a generic list of possibilities—algorithm updates, technical errors, or content quality—because it has no visibility into the site's actual search logs. Relying on third-party SEO estimators introduces another layer of inaccuracy, as sample-based traffic models frequently miss long-tail queries and real-time indexing states.

SEO Skill reverses that workflow by withholding generic advice and supplying raw facts through single-purpose commands:

  • Hosted Remote MCP Server: Teams can connect agents directly to [https://seoskill.dev/mcp](https://seoskill.dev/mcp) and authenticate via Google OAuth without running local infrastructure, immediately unlocking Search Console and analytics queries.
  • Local CLI and Server Execution: Installing the package globally via npm i -g seo and running seo start handles authentication, configures agent skills, and enables local machine capabilities.
  • Minimal Data Retention: According to the project documentation, the hosted server stores only encrypted linked Google account credentials and user-provided API keys. It does not retain Search Console data, generated reports, or request logs, while local CLI credentials remain in the operating system keychain.

Core Commands and MCP Tool Mapping

Rather than overwhelming agents with dozens of configuration-heavy reports, SEO Skill consolidates workflows into focused commands. Every CLI command is mirrored as an MCP tool (for example, seo report maps to seo_report) and supports a --json flag for scripted pipelines.

CommandFunction and Returned Data
seo reportCompares site totals, pages, and queries against the previous period, surfacing quick wins, low click-through rates (CTR), page-two rankings, content decay, and keyword cannibalization
seo pageInspects a single live URL alongside its Google index status and associated Search Console queries
seo compareAligns weekly traffic before and after a specified date while overlaying known Google search update dates
seo indexChecks Google indexing reasons for known URLs and audits live pages that recently lost clicks
seo researchQueries keyword volumes, SERP overlap, competitor backlinks, and brand mentions using the user's own DataForSEO or Ahrefs API key
seo dataRetrieves raw rows directly from Google Search Console or Bing Webmaster Tools
seo analyticsPulls landing page visits, referrers, and AI assistant traffic from Google Analytics, Clicky, or Simple Analytics
seo crawlRuns a full local site crawl to detect technical issues and verify whether AI crawlers (ChatGPT, Claude, Perplexity) can read pages (CLI only)
seo internal-linksIdentifies internal linking opportunities across an entire site or for a specific target page (CLI only)

In practice, an agent can use seo report to isolate queries that lost clicks, call seo page or seo index to verify whether the live URL is properly indexed, and propose targeted edits grounded in that specific row.

Setup Path and Verified Limitations

Users can register the remote MCP server in their agent environment in seconds. For Claude Code and Codex, the README provides direct registration commands:

# Add remote MCP server in Claude Code
claude mcp add --transport http seoskill https://seoskill.dev/mcp

# Add remote MCP server in Codex
codex mcp add seoskill --url https://seoskill.dev/mcp

For full site crawls, internal link audits, and Bing integration, install the CLI locally:

npm i -g seo
seo start

Before adopting the tool into production workflows, note several documented constraints:

  1. CLI-Only Features: Full site crawling (seo crawl), internal link discovery (seo internal-links), and Bing data access run locally on the user's machine and are not available through the hosted remote MCP server.
  2. Third-Party Keys for Market Research: While Search Console and supported analytics connectors work without extra research subscriptions, running seo research for keyword metrics, backlinks, or brand mentions requires registering your own DataForSEO or Ahrefs API key.
  3. Heuristic Metrics: Certain report sections introduced in v0.18.0—such as tracking conversational AI follow-up queries (ai-queries) or comparing Google-to-Bing query ratios—rely on heuristics because Search Console does not expose session IDs and hides rare queries, meaning counts represent baseline floors rather than exact totals.

Sources

Impact-Site-Verification: 9b3ebd10-6c45-44cf-a014-5b8c19b7b285