{
 "kind": "mcp",
 "slug": "dev-seoskill-seo",
 "path": "mcp/servers/dev-seoskill-seo/",
 "name": "SEO Skill",
 "maker": "iannuttall",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Search and knowledge",
   "mcp/search/"
  ]
 ],
 "lead": "your Search Console data for AI assistants.",
 "chips": [
  {
   "label": "Search and knowledge",
   "path": "mcp/search/"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http seoskill https://seoskill.dev/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/iannuttall/seo"
  },
  {
   "label": "Website",
   "href": "https://seoskill.dev"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "A third party",
   "status": "info",
   "sub": "Community server",
   "quote": "\"websiteUrl\": \"https://seoskill.dev\"",
   "note": "It wraps Google Search Console and Google Analytics, but it is not made by Google. The repository and seoskill.dev belong to an independent maker; it is the official server of SEO Skill itself.",
   "src": "https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/server.json"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "3 secrets needed",
   "status": "info",
   "sub": "none for the hosted server (Google sign-in in the browser), ",
   "quote": "claude mcp add --transport http seoskill https://seoskill.dev/mcp",
   "note": null,
   "src": "https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/README.md"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote or local",
   "status": "info",
   "sub": "Hosted URL, or run the package yourself",
   "note": "Endpoint: https://seoskill.dev/mcp. Checked: yes: https://seoskill.dev/mcp answered 401 (sign-in required) to one unauthenticated GET on 2026-11-10.",
   "src": "https://seoskill.dev/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "Apache-2.0 license",
   "quote": "\"license\":\"Apache-2.0\"",
   "note": "The code is Apache 2.0; the hosted service follows the seoskill.dev terms and Google's terms.",
   "src": "https://registry.npmjs.org/seo/latest"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What SEO Skill does",
   "parts": [
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Find out why clicks dropped",
       "text": "Ask why search clicks fell last month. The assistant compares your Search Console numbers with Google update dates instead of listing generic causes.",
       "idea": false
      },
      {
       "title": "Pages close to page one",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Check that a page is in Google",
       "text": "After the assistant fixes a page, it checks the live page and asks Google whether it is indexed, instead of trusting its own edit.",
       "idea": false
      },
      {
       "title": "Before and after a redesign",
       "text": "Compare the weeks before and after a site change or a Google update, with the pages and searches that moved.",
       "idea": false
      },
      {
       "title": "Check a site before launch",
       "text": "Crawl your site from your own computer to find broken pages, redirects, title problems and noindex tags, including what AI agents can read.",
       "idea": false
      },
      {
       "title": "Clean up AI-sounding copy",
       "text": "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.",
       "idea": false
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "SEO Skill popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "635",
       "l": "GitHub stars, iannuttall/seo"
      },
      {
       "n": "5,705",
       "l": "downloads last week, seo"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (13)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "seo_sites",
       "text": "Lists the Search Console and Google Analytics properties you can read and which research keys are set; with add, starts the paid weekly site audit for a site. Risk: can start a paid plan (Stripe Checkout link, or a charge at once when a plan already exists)."
      },
      {
       "name": "seo_report",
       "text": "The main Search Console report for a site, an overview first and then one section such as quick wins or low click-through. Risk: read-only."
      },
      {
       "name": "seo_page",
       "text": "One URL checked live, with its Google index status and the searches it shows up for. Risk: read-only; fetches the live page."
      },
      {
       "name": "seo_compare",
       "text": "Compares equal periods before and after a date, such as a redesign or a Google update. Risk: read-only."
      },
      {
       "name": "seo_index",
       "text": "Google's reasons for not indexing pages, and pages that lost their clicks. Risk: read-only."
      },
      {
       "name": "seo_research",
       "text": "Keyword, competitor, backlink and AI answer data from your own DataForSEO or Ahrefs key. Risk: spends credits on your DataForSEO or Ahrefs account."
      },
      {
       "name": "seo_data",
       "text": "Raw rows from Search Console, Google Analytics, Bing or Clicky for questions the report does not answer. Risk: read-only."
      },
      {
       "name": "seo_lint",
       "text": "Checks page copy, titles and descriptions for phrases that read as AI-written and for title and description length. Risk: read-only; reads only the text or files you give it."
      },
      {
       "name": "seo_crawl",
       "text": "Local server only. Crawls a site from your computer and lists technical issues with the pages they affect. Risk: fetches many pages of the site from your machine; saves the crawl locally."
      },
      {
       "name": "seo_internal_links",
       "text": "Local server only. Suggests internal links to add across a site or to one page. Risk: crawls from your machine; page text goes to TypeSafe when a TypeSafe key is set."
      },
      {
       "name": "seo_list_providers",
       "text": "Local server only. Lists add-on provider packages installed through the seo command. Risk: read-only."
      },
      {
       "name": "seo_describe_provider",
       "text": "Local server only. Shows what one installed provider package can do. Risk: read-only."
      },
      {
       "name": "seo_run_provider",
       "text": "Local server only. Runs one action of an installed provider package. Risk: runs code from a third-party package you installed."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "your Google sign-in tokens and email, and any DataForSEO, Ahrefs or Clicky keys you save",
       "sub": "To seoskill.dev (stored encrypted in Cloudflare D1); when you sign in or save a key on the hosted server. Opt out: use the local command-line tool with a sign-in on your machine only; Delete everything removes them."
      },
      {
       "l": "Sends",
       "v": "your Search Console, Google Analytics and provider rows",
       "sub": "To fetched by seoskill.dev for each request and returned to your agent, not kept; on each tool call to the hosted server. Opt out: use the local server or command-line tool."
      },
      {
       "l": "Sends",
       "v": "research inputs such as keywords and domains",
       "sub": "To DataForSEO or Ahrefs, on your own key; when seo_research runs. Opt out: do not call seo_research."
      },
      {
       "l": "Sends",
       "v": "anonymous usage events (event, report, agent, version, week); never a site, URL, query or key",
       "sub": "To SEO Skill telemetry; on report runs, from the hosted server and the command-line tool. Opt out: seo telemetry disable, DO_NOT_TRACK=1 or SEO_TELEMETRY_DISABLED=1 for the command-line tool; none on the hosted server."
      }
     ]
    },
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "The code is Apache 2.0; the hosted service follows the seoskill.dev terms and Google's terms.",
       "quote": "\"license\":\"Apache-2.0\"",
       "src": "https://registry.npmjs.org/seo/latest"
      },
      {
       "l": "client-work",
       "v": "With conditions",
       "status": "cond",
       "sub": "Only check sites and use accounts and keys you are allowed to, such as a client's Search Console you were given access to.",
       "quote": "Only check sites and use accounts and keys you are allowed to.",
       "src": "https://seoskill.dev/terms.md"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "Apache 2.0 allows passing the code on with its license; the name and artwork follow a separate brand policy.",
       "quote": "Apache-2.0. The name and artwork are covered by the [brand policy](TRADEMARKS.md).",
       "src": "https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/README.md"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "0.25.0 in the registry, updated Nov 19, 2026"
      },
      {
       "l": "Last release",
       "v": "0.17.3 on npm (2026-11-09); our registry row still says 0.5.0"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: https://seoskill.dev/mcp answered 401 (sign-in required) to one unauthenticated GET on 2026-11-10",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "SEO Skill",
       "me": true,
       "facts": [
        "635 stars",
        "Remote"
       ]
      },
      {
       "name": "serper",
       "why": "Pick it if you need live Google results for keywords you do not rank for yet, from code, without Search Console access",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "next-seo",
       "why": "Pick it if you need to set titles, meta descriptions and structured data in a Next.js app",
       "path": null,
       "facts": [
        "Local"
       ]
      }
     ],
     "more": "All search and knowledge servers",
     "more_path": "mcp/search/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Connect the SEO Skill server at https://seoskill.dev/mcp, list my Search Console sites with seo_sites, then run seo_report for my main site and tell me which pages are close to page one. Do not add any site to the paid audit."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http seoskill https://seoskill.dev/mcp"
      },
      {
       "tab": "npm (stdio)",
       "code": "npx -y seo"
      },
      {
       "tab": "Cursor",
       "code": "{\n  \"mcpServers\": {\n    \"seoskill\": { \"url\": \"https://seoskill.dev/mcp\" }\n  }\n}\n"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"seo-skill\": {\n      \"url\": \"https://seoskill.dev/mcp\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Calling seo_sites with add to try the audit on a site",
       "fix": "Only call add when the person asks for the paid audit; otherwise call seo_sites without arguments",
       "why": "Adding a site can cost money; with a plan it charges the card at once."
      },
      {
       "dont": "Calling seo_research before a provider key is saved",
       "fix": "Ask the person to save a DataForSEO or Ahrefs key on the account page first",
       "why": "Without a saved key seo_research fails, and each call spends the person's credits."
      },
      {
       "dont": "Asking the hosted server for a site crawl, internal links or Bing data",
       "fix": "Use the local seo command (seo crawl, seo internal-links) on the person's machine",
       "why": "These run only on your own machine; Bing blocks the hosted server."
      },
      {
       "dont": "seo quick-wins --project mysite",
       "fix": "seo report --site example.com --section quick-wins",
       "why": "Saved projects are gone in current versions; pass --site instead."
      },
      {
       "dont": "Reading SEO estimates from seo_research as real traffic",
       "fix": "Treat Search Console rows as the person's real numbers and research rows as provider estimates",
       "why": "The tool keeps keyword-tool estimates apart from real data."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Is it free?",
       "a": "Yes for every tool the assistant calls, with no usage cap. Only the weekly site audit is paid, $50 a month per site.",
       "evidence": {
        "url": "https://seoskill.dev/pricing",
        "quote": "The weekly site audit is the only paid part, because it runs on our servers in the background."
       }
      },
      {
       "q": "Does it need a password or a sign-up form?",
       "a": "No. You sign in with Google, and that first Google account becomes your account.",
       "evidence": {
        "url": "https://github.com/iannuttall/seo/blob/4edd3575d29dd1b111ce287b0944c8dd770d79d3/README.md",
        "quote": "There's no password and no signup form."
       }
      },
      {
       "q": "Can it change my Search Console or my site?",
       "a": "No. Google access is read-only and every tool is marked read-only; the one paid action is adding a site to the audit.",
       "evidence": {
        "url": "https://seoskill.dev/docs/cli.md",
        "quote": "Either way, Search Console and Google Analytics access is read-only."
       }
      },
      {
       "q": "How do I remove its access?",
       "a": "Choose Delete everything on the account page; it removes linked accounts and keys and revokes the Google sign-ins.",
       "evidence": {
        "url": "https://seoskill.dev/docs/mcp.md",
        "quote": "It deletes your linked accounts and keys and revokes the Google sign-ins, so your agents will ask you to sign in again."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "dev.seoskill/seo"
  ],
  [
   "Category",
   "Search and knowledge"
  ],
  [
   "Version",
   "0.25.0"
  ],
  [
   "Remote endpoint",
   "https://seoskill.dev/mcp"
  ],
  [
   "Package",
   "npm seo"
  ],
  [
   "License",
   "Apache-2.0"
  ],
  [
   "GitHub",
   "iannuttall/seo"
  ],
  [
   "In the registry since",
   "Nov 19, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "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."
 ],
 "checked_line": "Read by AgentGid from 19 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/iannuttall.png"
}