seoclaude

An MCP server that gives Claude (Claude Code, Claude Desktop or any MCP client) your SEO data and the tools to act on it: Google Search Console, Google Analytics 4, Bing Webmaster Tools, IndexNow, PageSpeed Insights, AdSense and Google Ads Keyword Planner, plus live technical SEO audits of your pages.

Ask in plain language — "when did search traffic drop, and which pages lost it?", "are my canonicals and hreflang set up right?", "how much traffic comes from ChatGPT?" — and Claude pulls the numbers live and works out the answer.

Nothing is stored: every question is answered from the APIs in real time. The only things kept on disk are your Google OAuth token and any API keys you add, in ~/.config/seoclaude/.

Tools

Search Console

Technical audits (no account needed)

Google Analytics 4

Bing and IndexNow

AdSense and Google Ads

The AdSense and Google Ads tools are new and have not yet been tested against live accounts. Reports are welcome.

Related MCP server: Google Search Console MCP Server

Setup

You need Node.js 20 or newer and a Google Cloud OAuth client of your own (free, about five minutes). Only the Google services you enable are used; everything else is optional.

1. Create a Google OAuth client

1. In the Google Cloud Console, create a project (or pick one).

2. Under APIs & Services → Library, enable the APIs you want:

   • Google Search Console API

   • Google Analytics Data API and Google Analytics Admin API

   • PageSpeed Insights API

   • AdSense Management API (optional)

   • Google Ads API (optional)

3. OAuth consent screen: user type External; add your own Google account under Test users.

4. Credentials → Create credentials → OAuth client ID → Application type: Desktop app.

5. Download the JSON and save it as ~/.config/seoclaude/credentials.json (or set GSC_CLIENT_ID and GSC_CLIENT_SECRET).

While the app is in Testing, Google expires the refresh token every 7 days and you will need to sign in again. To avoid that, set the consent screen to In production; for personal use no verification is needed, you just click through a warning.

2. Sign in

npx seoclaude auth

A browser window opens; approve access with the Google account that owns your properties. It asks for read-only access to GA4 and AdSense, the openid scope PageSpeed Insights uses for quota, and full Search Console access. Google has no narrower scope that allows submitting sitemaps; seoclaude only writes to Search Console when you call submit_sitemap.

3. Connect it to Claude

Claude Code

claude mcp add seoclaude -- npx -y seoclaude

Claude Desktop: add this to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "seoclaude": {
      "command": "npx",
      "args": ["-y", "seoclaude"]
    }
  }
}

4. Optional: other services

Keys for non-Google services, and Google Ads settings, are read from environment variables or from ~/.config/seoclaude/config.json:

{
  "bingApiKey": "",
  "indexNowKey": "",
  "pagespeedApiKey": "",
  "googleAdsDeveloperToken": "",
  "googleAdsLoginCustomerId": "",
  "googleAdsCustomerId": "",
  "googleAdsApiVersion": ""
}

Restart the MCP server after changing these.

Google Ads

The ads_* tools need a developer token on top of OAuth:

1. Open or create a Google Ads manager account (free).

2. In the manager account, go to Admin → API Center and request a developer token. Higher access levels are needed for real data; apply from the same page if your token is limited to test accounts.

3. Put the token (and your manager account ID) in config.json.

4. Sign in again with Google Ads access: npx seoclaude auth --ads. Ads access is only requested when you ask for it, because Google's consent screen words it as managing your campaigns.

Example questions

• "Which sites do I have?"

• "Top 20 queries on example.com in the last 28 days?"

• "When did search traffic drop, and which pages lost it?"

• "Find quick SEO wins."

• "Audit example.com's sitemap for technical SEO problems."

• "Summarize the index status of my 50 most-shown pages."

• "Is https://example.com/blog/x indexed? What canonical did Google pick?"

• "How much traffic do ChatGPT and other AI assistants send?"

• "Which pages show up in Google but don't get clicked, or get clicked and abandoned?"

• "Mobile Core Web Vitals for the home page?"

• "Resubmit the sitemap and send all its URLs to IndexNow."

• "Monthly search volume for these keywords in Turkey?"

Notes

• Search Console data is finalized with a ~3 day delay; by default the last 28 finalized days are used. CTR is returned as a percentage.

• URL Inspection allows 2,000 inspections per property per day and 600 per minute; bulk_inspect counts against it.

• Search Console has no API for the Request indexing button.

• Google does not take part in IndexNow; for Google, sitemaps and Search Console are the route.

• audit_page and audit_sitemap fetch pages with a plain HTTP client and don't run JavaScript, so they see the server-rendered HTML.

Development

git clone https://github.com/muhammeddilaver/seoclaude.git
cd seoclaude
npm install
npm run build
node dist/index.js auth
claude mcp add seoclaude -- node "$PWD/dist/index.js"

License

MIT