# SEO Skill — MCP server card for AI agents

Search Console, Google Analytics and keyword data for your AI agent.

Registry name: `dev.seoskill/seo` · category: Search and knowledge · version 0.25.0 · updated 2026-11-19

## Connect
- npm (stdio): `npx -y seo`
- Remote (Claude Code): `claude mcp add --transport http seo-skill https://seoskill.dev/mcp`

## Facts
- Repository: https://github.com/iannuttall/seo (635 stars)
- Website: https://seoskill.dev

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/dev-seoskill-seo/


## SEO Skill: your Search Console data for AI assistants

SEO Skill connects an AI assistant to your own Google Search Console and Google Analytics numbers. Ask why clicks dropped or which pages almost reach page one, and the answer comes from your real data, not guesses. The hosted server is free; only an optional weekly site audit costs money.

### Where to use it
- Find out why clicks dropped: Ask why search clicks fell last month. The assistant compares your Search Console numbers with Google update dates instead of listing generic causes.
- Pages close to page one: Get a list of pages that sit just below the first page of Google and the searches they rank for, so you know what to improve first.
- Check that a page is in Google: After the assistant fixes a page, it checks the live page and asks Google whether it is indexed, instead of trusting its own edit.
- Before and after a redesign: Compare the weeks before and after a site change or a Google update, with the pages and searches that moved.
- Check a site before launch: Crawl your site from your own computer to find broken pages, redirects, title problems and noindex tags, including what AI agents can read.
- Clean up AI-sounding copy: Before you publish a landing page or blog post, check it for stock phrases that read as AI-written and for titles and descriptions that are too long.

### How to start
- Add the hosted server to your assistant.

```
claude mcp add --transport http seoskill https://seoskill.dev/mcp
```

- Sign in with the Google account that can see your site in Search Console; access is read-only.
- For site crawls, internal links and Bing data, install the command-line tool on your computer (Node 22.23.4 or later).

```
npm i -g seo && seo start
```


### License
The code is open source under Apache 2.0, so you may use and change it in paid work. The hosted server and account are free; the weekly site audit is a paid plan at $50 a month per site.

### Good to know
- Your agent can start the paid audit. With a plan already on file, adding a site charges your card at once.
- Keyword and competitor research uses your own DataForSEO or Ahrefs key and costs credits on that account.
- Site crawls, internal links and Bing data work only with the tool installed on your computer, not the hosted server.
- The hosted server keeps your Google sign-ins and saved keys, encrypted, but not your Search Console data or reports.
- Running the free tools or the hosted server in bulk by script is not allowed.

Checked 2026-11-10 against: https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/README.md, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/server.json, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/LICENSE, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/CHANGELOG.md, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/packages/core/src/commands/tools.ts, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/packages/mcp/src/index.ts, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/packages/mcp/src/shared-tools.ts, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/packages/mcp/src/provider-extension-tools.ts, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/apps/mcp/src/mcp.ts, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/apps/mcp/src/telemetry.ts, https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/skills/seo/SKILL.md, https://seoskill.dev/docs/mcp.md, https://seoskill.dev/docs/cli.md, https://seoskill.dev/pricing, https://seoskill.dev/pricing.md, https://seoskill.dev/privacy.md, https://seoskill.dev/terms.md, https://seoskill.dev/llms.txt, https://registry.npmjs.org/seo/latest

### Mistakes to avoid
- Don't: Calling seo_sites with add to try the audit on a site → Do: Only call add when the person asks for the paid audit; otherwise call seo_sites without arguments (Adding a site can cost money; with a plan it charges the card at once.)
- Don't: Calling seo_research before a provider key is saved → Do: Ask the person to save a DataForSEO or Ahrefs key on the account page first (Without a saved key seo_research fails, and each call spends the person's credits.)
- Don't: Asking the hosted server for a site crawl, internal links or Bing data → Do: Use the local seo command (seo crawl, seo internal-links) on the person's machine (These run only on your own machine; Bing blocks the hosted server.)
- Don't: seo quick-wins --project mysite → Do: seo report --site example.com --section quick-wins (Saved projects are gone in current versions; pass --site instead.)
- Don't: Reading SEO estimates from seo_research as real traffic → Do: Treat Search Console rows as the person's real numbers and research rows as provider estimates (The tool keeps keyword-tool estimates apart from real data.)

### Questions
- Is it free? Yes for every tool the assistant calls, with no usage cap. Only the weekly site audit is paid, $50 a month per site.
- Does it need a password or a sign-up form? No. You sign in with Google, and that first Google account becomes your account.
- Can it change my Search Console or my site? No. Google access is read-only and every tool is marked read-only; the one paid action is adding a site to the audit.
- How do I remove its access? Choose Delete everything on the account page; it removes linked accounts and keys and revokes the Google sign-ins.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
