Seo Stack Mcp

io.github.Raffaele86由 GitHub 账号 Raffaele86 发布v0.2.0更新于 Oct 24, 2026

The complete open-source SEO data stack for AI agents: 7 sources, 86 tools, one MCP server

已验证STDIO仅桌面网页搜索与抓取数据与分析

概览

AI 生成的概览

自托管的 SEO 数据 MCP 服务器，让助手统一访问 Search Console、GA4、Bing、Clarity、AdSense、关键词规划师和 PageRank，并内置分析工具。

可以做什么
查询 Google Search Console 的搜索表现、检查网址、管理站点地图并请求收录，含关键词蚕食、内容缺口和周报分析。读取 Google Analytics 4 概览、落地页、流量来源、事件、受众和实时数据。获取 Bing 站长工具的流量、抓取、关键词和外链数据，并提交网址或站点地图。查看 Microsoft Clarity 的体验信号，如暴怒点击、无效点击、滚动深度和脚本错误。查看 AdSense 收入、付款、广告单元和提醒，并获取关键词规划师的词想法与指标。通过 Open PageRank 查询域名权重分。
适用场景
适合同时使用多个免费 SEO 与数据分析来源、希望用一套助手配置替代多个服务器的人，也适合需要下降查询、易提升关键词、周期对比等服务端分析而非原始数据的人。
运行要求
以 Python 包形式通过 uvx 或 pip 在本机运行，需要 Python 工具链。各数据源均可选，由各自凭据启用：Search Console 与 GA4 需 Google 服务账号 JSON 路径或 OAuth 客户端 JSON，以及 GA4 属性 ID 和站点地址；Bing 与 Clarity 需 API 密钥；AdSense 需账号 ID 加 Google 凭据；关键词规划师需 Google Ads 开发者令牌与 OAuth 参数并安装 google-ads 附加包；Open PageRank 需 API 密钥。需能访问各服务商 API。
安装前请注意
需要保存多项密钥，包括 Google Ads 客户端密钥、开发者令牌和刷新令牌、Bing 与 Clarity 密钥及 Open PageRank 密钥；服务账号密钥文件可访问你的 Google 资源。部分工具会写入外部服务：提交或删除站点地图、请求收录会改变 Search Console 和 Bing 的实际状态，且需要写权限。AdSense 工具会暴露收入和付款数据。OAuth 令牌会缓存在本机。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Seo Stack Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

seo-stack-mcp

The complete open-source SEO data stack for AI agents. Google Search Console, Google Analytics 4, Bing Webmaster Tools, Microsoft Clarity, Google AdSense, Google Keyword Planner and Open PageRank in a single MCP server — with built-in analyst tools (cannibalization check, low-hanging fruit, content gap, weekly report), not just raw API wrappers.

Self-hosted, free, MIT. Works with Claude Desktop, Claude Code, Cursor, and any MCP client.

Why this instead of N separate servers?

  • One install, one config — instead of wiring up 7 different MCP servers with 7 auth setups.
  • Analyst tools included — ask "which queries are declining this month?" or "find my low-hanging-fruit keywords" and get an answer computed server-side, not a raw data dump your agent has to crunch.
  • Sources are optional — configure only what you use; tools appear only for configured sources.
  • Self-hosted — your tokens stay on your machine. No third-party hosted gateway reading your Search Console.

Quickstart (60 seconds)

Add to your MCP client config (Claude Desktop claude_desktop_config.json, Cursor mcp.json, or claude mcp add):

json
{  "mcpServers": {    "seo-stack": {      "command": "uvx",      "args": ["seo-stack-mcp"],      "env": {        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",        "GA4_PROPERTY_ID": "123456789",        "BING_WEBMASTER_API_KEY": "your-key",        "CLARITY_API_TOKEN": "your-token"      }    }  }}

Every env var is optional — set only the sources you want. That's it: restart your client and ask "what are my top queries this week?".

To run the latest development version straight from GitHub, use "args": ["--from", "git+https://github.com/Raffaele86/seo-stack-mcp", "seo-stack-mcp"] instead.

Credentials

SourceWhat you needWhere to get it
GSC + GA4Service account JSON (recommended) → GOOGLE_APPLICATION_CREDENTIALSGoogle Cloud Console → create service account → enable Search Console API + Analytics Data API → add the SA email as a user in GSC / GA4
GSC + GA4 (alt)OAuth desktop client JSON → SEO_STACK_OAUTH_CLIENTFirst run opens a browser for consent; refresh token cached in ~/.config/seo-stack-mcp/
BingBING_WEBMASTER_API_KEYBing Webmaster Tools → Settings → API access
ClarityCLARITY_API_TOKENMicrosoft Clarity → project → Settings → Data Export API
AdSenseGoogle credentials above + ADSENSE_ACCOUNT_ID (accounts/pub-XXXX...)AdSense → Account → Settings → Account information. Enable the AdSense Management API in Google Cloud. If you use OAuth and enable AdSense later, delete the cached token in ~/.config/seo-stack-mcp/ to re-consent with the new scope
Keyword PlannerGOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CUSTOMER_ID (+ GOOGLE_ADS_LOGIN_CUSTOMER_ID under an MCC)Google Ads API Center → developer token (Basic access is enough; API calls are free). Also needs the google-ads extra: uvx --with google-ads seo-stack-mcp or pip install seo-stack-mcp[ads]
Open PageRankOPENPAGERANK_API_KEYOpen PageRank — free API key, 10,000 calls/hour

Optional defaults: GSC_SITE_URL, BING_SITE_URL (so you don't repeat the site on every question), ADSENSE_CURRENCY (default USD), GOOGLE_ADS_LOCATION_ID / GOOGLE_ADS_LANGUAGE_ID (Keyword Planner geo/language defaults, default US / English).

Tools

Google Search Console (29 tools)

ToolDescription
gsc_bulk_inspect_urlsInspect multiple URLs in batch via the URL Inspection API. Max 50 URLs per call.
gsc_bulk_request_indexingRequest indexing for multiple URLs via the Google Indexing API. Max 50 URLs.
gsc_cannibalization_checkFind queries where multiple pages compete (keyword cannibalization). Shows queries with 2+ ranking pages.
gsc_compare_periodsCompare two periods: shows deltas of clicks, impressions, CTR and position per item.
gsc_content_gap_analysisContent gap analysis: queries where the competitor ranks but you don't (or you are far behind).
gsc_country_performancePerformance by country: clicks, impressions, CTR and average position. Default: last 28 days.
gsc_daily_statsAggregated daily site statistics: clicks, impressions, CTR and average position per day.
gsc_declining_queriesQueries losing clicks/positions: compares last N days vs the equivalent previous period.
gsc_delete_sitemapRemove a sitemap from Google Search Console. Requires write scope on the credentials.
gsc_device_performanceCompare performance across MOBILE vs DESKTOP vs TABLET. Default: last 28 days.
gsc_indexing_status_summaryIndexing status summary for multiple URLs: how many indexed, not indexed, and errored.
gsc_inspect_urlInspect a URL via the Google Search Console URL Inspection API.
gsc_keyword_opportunitiesQueries with high impressions but low CTR in position 5-20: optimization opportunities.
gsc_list_sitemapsList all sitemaps of a site in Google Search Console.
gsc_list_sitesList all Google Search Console properties available to the configured credentials.
gsc_low_hanging_fruitQueries in position 3-10 with high impression volume: small optimizations can push them into the top 3.
gsc_page_trendDaily trend for a specific page over the last N days (default 90).
gsc_pages_for_queryWhich pages rank for a specific query? Shows all pages with performance data.
gsc_queries_for_pageWhich queries drive traffic to a specific page? Shows all keywords with performance data.
gsc_query_trendDaily trend for a specific query over the last N days (default 90).
gsc_request_indexingRequest indexing of a URL via the Google Indexing API.
gsc_rising_queriesRising queries: compares last N days vs the equivalent previous period.
gsc_search_analyticsQuery Search Analytics: clicks, impressions, CTR and position for the requested dimensions.
gsc_search_analytics_filteredSearch Analytics with advanced filters. Filters: query_contains, query_regex, page_contains, page_regex, country (e.g. 'ita'), device (MOBILE/DESKTOP/TABLET).
gsc_search_appearancePerformance by SERP result type (rich snippet, video, FAQ, etc.). Default: last 28 days.
gsc_submit_sitemapSubmit a sitemap to Google Search Console. Requires write scope on the credentials.
gsc_top_pagesTop pages by clicks or impressions. order_by: clicks, impressions, ctr, position. Default: last 28 days.
gsc_top_queriesTop queries by clicks or impressions. order_by: clicks, impressions, ctr, position. Default: last 28 days.
gsc_weekly_reportAutomatic weekly report: last 7 days vs previous 7 days metrics with deltas and top queries/pages.

Google Analytics 4 (10 tools)

ToolDescription
ga4_compare_periodsCompare two periods with percentage delta on key metrics.
ga4_conversion_pathsUser paths: acquisition source → landing page with sessions and users.
ga4_eventsTop GA4 events with count and number of users.
ga4_landing_pagesEntry pages (landing pages) with sessions, users and bounce rate.
ga4_overviewSite overview: users, sessions, pageviews, bounce rate, average session duration.
ga4_page_performanceDetailed performance of a single page with device and source breakdown.
ga4_realtimeRealtime report: pages currently being viewed and active users.
ga4_top_pagesTop pages by traffic with full metrics (pageviews, users, duration, bounce rate).
ga4_traffic_sourcesTraffic breakdown by source/medium (e.g. google/organic, direct/none).
ga4_user_demographicsUser demographics breakdown: country, device, browser, language.

Bing Webmaster Tools (22 tools)

ToolDescription
bing_crawl_issuesURLs with crawl problems (4xx/5xx errors, redirects, etc.).
bing_crawl_statsBing crawl statistics: crawled pages, errors, redirects, etc.
bing_keywordBing impression volume for an exact query (impressions + broad).
bing_keyword_statsHistorical statistics for a keyword on Bing: impressions and trend.
bing_link_countsPages with the highest number of backlinks according to Bing.
bing_pages_for_queryPages that rank for a specific query on Bing.
bing_queries_for_pageSearch queries that drive traffic to a specific page.
bing_query_page_detailDetailed statistics for a specific query + page combination.
bing_query_trafficDaily traffic trend for a specific query on Bing.
bing_related_keywordsKeywords related to a search term on Bing, with impression data.
bing_sitemapsList all sitemaps/feeds submitted to Bing.
bing_sitesList all sites verified in the Bing Webmaster Tools account.
bing_submission_quotaCheck the URL submission quota for Bing.
bing_submit_sitemapSubmit a new sitemap/feed to Bing.
bing_submit_urlSubmit a URL to Bing for indexing.
bing_submit_urls_batchSubmit a batch of URLs to Bing for indexing (max 500).
bing_top_pagesTop pages on Bing with clicks, impressions and average position.
bing_top_queriesTop Bing search queries with clicks, impressions and average position.
bing_traffic_statsDaily Bing traffic statistics: clicks and impressions over time.
bing_url_infoIndexing status of a specific URL on Bing.
bing_url_linksInbound backlinks to a specific URL according to Bing.
bing_url_trafficTraffic data for a specific URL on Bing.

Microsoft Clarity (10 tools)

ToolDescription
clarity_breakdownFree-form raw breakdown (1-3 dimensions). Power-user — costs 1 quota unit if not already cached.
clarity_dead_clicksTop URLs with dead clicks (clicks on non-interactive elements — a UX problem signal).
clarity_engagementEngagement Time + Scroll Depth per URL (or another dimension).
clarity_excessive_scrollTop URLs with excessive scrolling (users hunting for info they can't easily find).
clarity_popular_pagesTop URLs by visits over the last days (Popular Pages metric, dimension=URL).
clarity_quickback_clicksTop URLs with quickback clicks (user goes back immediately — page not relevant).
clarity_quota_statusDaily quota status (local counter, does not call the API).
clarity_rage_clicksTop URLs with rage clicks (fast repeated clicks — user frustration).
clarity_script_errorsTop URLs with JS errors + error clicks (technical problems on the page).
clarity_trafficTraffic breakdown from Microsoft Clarity (sessions, bot %, pages per session).

Google AdSense (10 tools)

ToolDescription
adsense_alertsActive alerts on the AdSense account (severity, type, message).
adsense_by_ad_unitPerformance per ad unit: earnings, impressions, clicks, CTR, eCPM.
adsense_by_countryRevenue breakdown by country, sorted by earnings.
adsense_by_platformRevenue breakdown by device platform (Desktop, Mobile, Tablet).
adsense_compare_periodsCompare two periods with percentage deltas on key metrics.
adsense_earnings_by_dateDaily earnings with total, average and trend.
adsense_earnings_overviewEarnings overview: estimated earnings, page views, impressions, clicks, RPM, CTR.
adsense_paymentsRecent payments on the AdSense account.
adsense_sitesSites linked to the AdSense account (domain, state, auto-ads).
adsense_top_pagesTop URL channels by revenue (requires URL channels configured in AdSense).

Google Keyword Planner (4 tools)

ToolDescription
kp_historical_metricsReal historical Keyword Planner metrics for a list of known keywords.
kp_keyword_ideasKeyword ideas with real metrics: volume, competition, top-of-page bids, 12-month volumes.
kp_statusSource status: library, credential completeness (masked) and live connection test.
kp_suggest_geo_targetResolve a location name to its geo target constant ID.

Open PageRank (1 tool)

ToolDescription
pagerank_scoreDomain authority score (0-10) for up to 100 domains per call, with a local 30-day cache.

Why not the official GA4 server or mcp-gsc?

Both are good and this project doesn't pretend otherwise. Google's official analytics-mcp covers GA4 only; mcp-gsc covers GSC only. If you live in one data source, use them. This project is for people who work across the whole free SEO stack and want the cross-source workflow (GSC + GA4 + Bing + Clarity) plus opinionated analysis tools in one place.

See also

local-leads-mcp — the prospecting counterpart: find local businesses with no website via OpenStreetMap and verify them, no API keys needed.

License

MIT.

Built and maintained by Raffaele Nocera — freelance web & SEO. Available for consulting.

来源：README.md，提交 3e18f79

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分