● open-source · MIT · v1.8.0

SEO Tools MCP

Eight universal stdio MCP servers for SEO: SERP from two independent providers, Wordstat, Google Search Console, Google Analytics 4, Yandex.Webmaster, Yandex.Metrica and a bridge to your own A-Parser — right from Claude Code and other MCP clients. Read-only, strict JSON, production-tested on real PBN Workers workloads.

GitHub → Installation

● eight servers

xmlstock API key

Google/Yandex SERP, images, news, video + Wordstat

xmlstock_serpxmlstock_imagesxmlstock_newsxmlstock_videoxmlstock_wordstatxmlstock_wordstat_dynamicsxmlstock_wordstat_regionsxmlstock_wordstat_regions_treexmlstock_balance

access: xmlstock.com →

xmlriver API key

Second SERP provider: AI Overview, People Also Ask, Maps

xmlriver_serpxmlriver_imagesxmlriver_newsxmlriver_mapsxmlriver_check_indexxmlriver_suggestxmlriver_related_questionsxmlriver_balance

access: xmlriver.com →

wordstat Yandex Cloud API key

Yandex.Wordstat frequency & trends

wordstat_frequencywordstat_dynamicswordstat_regionswordstat_regions_tree

access: Yandex Cloud →

gsc OAuth / service account

Google Search Console

gsc_querygsc_inspect_urlgsc_list_sitesgsc_get_sitegsc_list_sitemapsgsc_get_sitemap

access: Google Cloud →

ga4 OAuth / service account

Google Analytics 4 — Data API + Admin API

ga4_list_propertiesga4_metadataga4_check_compatibilityga4_reportga4_bytimega4_traffic_sourcesga4_geoga4_devicesga4_top_pagesga4_eventsga4_realtimega4_funnelga4_annotationsga4_property_details

access: Google Cloud →

ywm OAuth with auto-refresh

Yandex.Webmaster

ywm_hostsywm_summaryywm_search_queriesywm_queries_historyywm_recommended_queriesywm_popularywm_indexing_historyywm_sqi_historyywm_external_linksywm_broken_linksywm_diagnosticsywm_important_urlsywm_sitemaps

access: Yandex OAuth →

metrika OAuth with auto-refresh

Yandex.Metrica

metrika_reportmetrika_bytimemetrika_countersmetrika_goalsmetrika_traffic_sourcesmetrika_geometrika_devicesmetrika_landing_behaviormetrika_search_phrasesmetrika_top_landings

access: Yandex OAuth →

aparser self-hosted: API URL + password

Bridge to your own A-Parser instance

aparser_pingaparser_statusaparser_proxiesaparser_parsersaparser_parser_fieldsaparser_get_presetaparser_serp_googleaparser_serp_yandexaparser_suggestaparser_requestaparser_bulk_request

access: a-parser.com →

● installation

Claude Code plugin, .mcpb or npx

Marketplace: one source = one plugin. Keys are asked at install; secrets go to the OS keychain:

claude plugin marketplace add antohins/seo-tools-mcp
claude plugin install ga4@seo-tools-mcp

Available: xmlstock, xmlriver, wordstat, gsc, ga4, ywm, metrika, aparser and the seo-tools bundle (all eight). The bundle pulls ~100 tools into every session — if you need two sources, install two plugins.

Claude Desktop: download a .mcpb from the latest release and double-click it.

Or via npx, no cloning:

claude mcp add xmlstock --scope user -- npx -y seo-tools-mcp-xmlstock

From source:

git clone https://github.com/antohins/seo-tools-mcp.git && cd seo-tools-mcp
pnpm install && pnpm build

Need access from claude.ai (web) or a remote machine? Deploy it on a VPS and connect over an HTTP bridge with supergateway.

● what's inside

Claude Code plugins

Marketplace: one server per plugin, plus skills on SERP spend, Wordstat, GA4 zeros and GSC vs scraped position.

Read-only

Every tool only reads data and returns strict JSON. Nothing is ever modified in your accounts.

Interactive authorization

Manage access right in the chat: *_auth_status, *_set_credentials — no file editing required.

Multi-account

Named profiles: multiple Google/Yandex accounts with separate token storage.

Auto token refresh

OAuth tokens are refreshed automatically on expiry.

Not tied to any site

Domains are not hardcoded — defaults are configured on the fly, for any project.

Single config

One env file ~/.config/seo-tools-mcp/.env with 600 permissions.

● changelog

What shipped recently

Since the first public release the toolkit grew from five servers to eight. Full history — CHANGELOG.md.

v1.8.0 25 Aug 2026

Claude Code plugins and skills, plus one-click .mcpb install. GA4 gains funnels (ga4_funnel), date annotations and a property card with Measurement IDs. All 101 tools declare whether they are read-only: hosts stop asking for confirmation on safe calls, but metered SERP and A-Parser tools no longer pretend to be free.

v1.7.0 8 Aug 2026

GA4 gains ga4_metadata (which fields exist in this property, with blocked ones flagged) and ga4_check_compatibility (is a dimension × metric pair valid — without paying for a heavy report). Plus period comparison, metric-value filters and totals in every report tool.

v1.6.0 7 Aug 2026

New server ga4 — Google Analytics 4 via the Data API and Admin API: reports, traffic sources, geo, devices, top pages, events and realtime. Shares the OAuth app with gsc, so both run side by side.

v1.5.0 — 1.5.1 7 Aug 2026

gsc: arbitrary dimension filters and aggregationType. xmlstock: third engine yandex_xml — the official Yandex XML API, up to 100 results per single paid request. xmlriver: Google Maps search and extra SERP blocks. Fixed an extra paid request in the yandex_xml pagination loop.

v1.4.0 4 Aug 2026

New server aparser — a bridge to your own self-hosted A-Parser: Google/Yandex SERP, suggestions and ~150 parsers through one universal call. xmlriver: Google geo-targeting, full AI Overview text, People Also Ask and suggestions.

v1.3.0 26 Jul 2026

Wordstat inside xmlstock: frequency, trends and regional demand on the same API key — no Yandex Cloud setup required.

v1.2.0 18 Jul 2026

New server xmlriver — a second SERP provider and an indexation check for Google and Yandex.

● docs & links

Repository →Changelog →Security →Contributing →MIT License →supergateway (remote bridge) →

We build top-ranking infrastructure — and share the tools

We use this tool in our own satellite production. If you need a done-for-you result, see how we work with businesses and agencies, or read the blog.

View on GitHub →