Docs
Connect the hosted MCP or install the CLI. Both run the same reports and give your agent the same facts.
Connect or install
Run it in a terminal, then sign in with Google.
Or run it on your machine
Installs the CLI, signs you in and adds the skill to your agents. Crawls and Bing run this way.
Start
Getting started
Connect the hosted MCP or install the CLI, sign in with Google and run your first report.
Hosted MCP
Add seoskill.dev/mcp to Claude Code, Codex or any remote MCP client.
API keys
Add your own DataForSEO or Ahrefs key on your account page or as a header.
Analytics
Google Analytics and Clicky on the hosted MCP and the CLI, and other tools on your machine.
Bing
Add Bing clicks, queries and pages beside Search Console in the report.
CLI
Install the open source seo command and run the same reports on your machine.
Cloud agents
Run on machines that are rebuilt each time, such as Amp, Codex cloud and CI.
Commands
seo report
The main Search Console report: an overview first, then one section.
seo page
One URL: live page facts, Google index status and its queries.
seo compare
Before and after a date, with the Google updates in the window.
seo index
Why Google does or does not index your pages, checked live, and pages that lost their clicks.
seo research
Keyword metrics, rankings, SERPs, competitors, backlinks and AI answer citations from your own key.
seo data
Raw Search Console or Bing rows, or landing pages from your analytics.
seo crawl
Crawl your site and list technical issues. CLI only.
seo internal-links
Find pages that could link to a page you choose. CLI only.
Commands and hosted MCP tools
Each command has the same name in the CLI and a matching tool in the hosted MCP, and the results are the same either way. Start with the report: the overview shows where clicks moved, and each section count tells you where to look next.
| CLI | Hosted MCP tool | Needs |
|---|---|---|
seo report | seo_report | Search Console |
seo page | seo_page | Search Console and a URL |
seo compare | seo_compare | Search Console and a date |
seo index | seo_index | Search Console |
seo research | seo_research | A DataForSEO or Ahrefs key |
seo data | seo_data | Search Console, or Google Analytics on the hosted MCP |
seo crawl | CLI only | A site URL |
seo internal-links | CLI only | A site, or one page |