MetricPort

io.metricport由 metricport.io 发布官方发布者v0.1.1更新于 Nov 2, 2026

Google Search Console, Ads and AdSense analytics for AI clients. Hosted, read-only, 57 tools.

已验证Streamable HTTP可网页运行网页搜索与抓取数据与分析商业与电商

概览

AI 生成的概览

托管的只读 MCP 服务器，通过 57 个报表工具让助手分析 Google Search Console、Google Ads 和 AdSense 数据。

可以做什么
  • 查询 Search Console 表现：按查询词、页面、设备、国家、搜索外观统计点击、展示、CTR 和排名，并提供速赢机会、CTR 差距、内容衰减、关键词自相竞争和网址收录检查
  • 查看 Google Ads：广告系列、搜索词、关键词、质量得分、展示份额、预算节奏、广告、地域、设备、时段、落地页、优化建议和更改历史
  • 查看 AdSense：收入、自定义报表、热门页面、国家、广告单元、平台分布、网站、提醒和付款
  • 跨来源对比：付费与自然搜索词对照、页面点击与 AdSense 收入关联、落地页花费与自然点击关联
  • 列出已连接的 Google 账号及其 Search Console 站点、Ads 客户账号和 AdSense 账号
适用场景
适合希望助手基于自己的 Google 数据回答 SEO、付费搜索或发布商变现问题，又不想自行搭建 Google Cloud 项目、OAuth 客户端或开发者令牌的场景。适用于定期报表、审计以及自然与付费表现的跨渠道对比。
运行要求
需要 MetricPort 账号并连接 Google 账号；Search Console 在免费方案内，Ads 和 AdSense 需 Pro。需在 METRICPORT_API_KEY 中提供 API 密钥，或通过浏览器一次性登录。可作为远程端点使用，也可用 npx metricport-mcp 本地运行（需 Node.js）。要求 OAuth，并需能访问 metricport.io。
安装前请注意
服务器在其托管基础设施上保存你的 Google OAuth 连接和刷新令牌，等于将 Search Console、Ads 和 AdSense 账号的访问权托付给第三方。METRICPORT_API_KEY 属于凭据，不应写入共享配置。用量按方案计量（免费版每月 500 次工具调用），Ads 或 AdSense 数据需付费方案。工具虽标为只读，使用前仍应自行确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MetricPort，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.metricport%2Fmetricport/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "metricport": {
      "type": "http",
      "url": "https://metricport.io/api/mcp"
    }
  }
}

README

metricport-mcp

MCP server for Google Search Console, Google Ads and AdSense, usable from Claude, Cursor, Windsurf, VS Code, ChatGPT and any other MCP client.

This package is a thin local client. The server itself runs hosted at metricport.io: it holds the Google OAuth connection, talks to the three Google APIs, and exposes 57 read-only analysis tools plus daily insights, alerts and reports. You never create a Google Cloud project, OAuth client or developer token yourself.

bash
npx metricport-mcp

Quick start

  1. Create a free account at metricport.io and connect a Google account (Search Console on Free, Ads and AdSense on Pro).
  2. Add the server to your client. Either sign in once in the browser, or create an API key at https://metricport.io/app/keys.

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "metricport": {      "command": "npx",      "args": ["-y", "metricport-mcp"],      "env": { "METRICPORT_API_KEY": "mp_..." }    }  }}

Cursor (.cursor/mcp.json), Windsurf, VS Code (.vscode/mcp.json): same shape.

claude.ai, ChatGPT and other clients that support remote servers need no package at all. Add a custom connector with the URL https://metricport.io/api/mcp and sign in.

What you can ask

  • "Which pages lost the most clicks this week, and what do they have in common?"
  • "Show me striking-distance queries on positions 5 to 20 with real impressions."
  • "Which search terms in my Google Ads account spend money without converting?"
  • "Why did my AdSense earnings drop compared to last month?"
  • "Where do I pay for keywords I already rank for organically?"

Tools

ToolWhat it does
gsc_search_analyticsSearch performance (clicks, impressions, CTR, position) grouped by dimensions with optional filters
gsc_top_queriesTop search queries by clicks over the last N days (default 28)
gsc_top_pagesTop pages by clicks over the last N days (default 28)
gsc_page_queriesAll queries a single URL ranks for, with clicks, impressions, CTR and position
gsc_quick_winsQueries ranking in striking distance (default positions 5-20) with real impressions, ranked by estimated extra clicks if pushed up ~3 positions
gsc_ctr_opportunitiesQueries on page one whose CTR is far below the expected CTR for their position
gsc_content_decayPages that lost the most clicks versus the previous period (or the same period last year with compareTo=year)
gsc_new_and_lost_queriesQueries that appeared this period but not in the previous one, and queries that disappeared
gsc_cannibalizationQueries where two or more of your pages compete for the same keyword
gsc_brand_splitSplits queries into brand and non-brand using a regex (e.g
gsc_query_clustersGroups queries by shared terms into topic clusters with total clicks, impressions and example queries
gsc_question_queriesQueries phrased as questions (how, what, why, wie, was, warum…) sorted by impressions
gsc_zero_click_pagesPages that get impressions but no clicks
gsc_daily_trendDaily clicks and impressions with a 7-day moving average, flagged drops or spikes (≥30% vs
gsc_device_country_breakdownClicks, impressions, CTR and position per device and per country, with the CTR gap between mobile and desktop
gsc_search_appearancePerformance by search appearance (rich results, video, AMP…) plus Discover and Google News traffic for the same period
gsc_inspect_urlGoogle index status for one URL: verdict, coverage state, last crawl, canonical, mobile usability, rich results
gsc_index_checkInspects up to 10 URLs and returns a compact table: indexed or not, coverage state, last crawl, Google-selected canonical vs
gsc_sitemapsSubmitted sitemaps with status, errors, warnings and URL counts
gsc_weekly_reportOne call for a client-ready weekly summary: totals vs
ads_list_accountsConnected Google Ads customer accounts including manager (MCC) accounts and their direct child accounts
ads_queryRun a Google Ads Query Language (GAQL) SELECT against a customer account
ads_campaign_performanceCampaigns with cost, clicks, impressions, CTR, conversions, cost per conversion, ROAS and status for a date range (default last 30 days)
ads_search_termsActual search terms that triggered ads, with cost, clicks, impressions and conversions
ads_wasted_spendSearch terms that cost money or clicks but never converted in the period (default 30 days), aggregated across campaigns, with negative keyword suggestions (phrase for recurring words, exact for one-offs)
ads_keyword_performanceKeywords with match type, status, quality score, cost, clicks, conversions, CPA and impression share
ads_quality_score_auditImpression-weighted quality score, distribution 1-10, and the keywords at or below a threshold with their weakest component (expected CTR, ad relevance, landing page experience) and the money spent on them
ads_impression_shareSearch impression share per campaign with the share lost to budget and lost to rank, plus top-of-page and absolute-top rates
ads_budget_pacingMonth-to-date spend per campaign versus the expected spend from its daily budget, with month-end projection
ads_ad_performanceResponsive search ads with ad strength, final URL, headlines count, CTR, cost, conversions
ads_geo_performanceCost, clicks, conversions and CPA by country (or by region/city with level)
ads_device_performanceCost, clicks, CTR, conversions and CPA per device (mobile, desktop, tablet) for the account or one campaign
ads_daypartingCost, clicks, conversions and CPA by hour of day and by day of week
ads_landing_pagesLanding pages with cost, clicks, conversions, CPA and mobile-friendly click rate
ads_recommendationsGoogle's own optimization recommendations for the account (keywords, budgets, ad suggestions, bidding), with the estimated impact where available
ads_change_historyWho changed what in the account in the last N days (max 30): resource type, operation, user, timestamp
ads_conversion_actionsConfigured conversion actions with status, category, counting type, attribution model and the conversions each produced in the period
ads_pmax_asset_groupsAsset groups of Performance Max campaigns with ad strength, cost, conversions and value
ads_daily_trendDaily cost, clicks, conversions and CPA for the account with flagged spend spikes or drops (≥30% vs
ads_metadataDescribes selectable fields of a Google Ads resource (e.g
ads_account_auditOne call that runs the key checks: campaign totals vs
adsense_earningsEarnings summary: totals for the range (default last 30 days) plus a daily breakdown
adsense_reportCustom report with chosen dimensions and metrics for a date range (default last 30 days)
adsense_top_pagesPages by estimated earnings with page views and RPM
adsense_by_countryEarnings, page views, RPM and CTR per country
adsense_ad_unit_performanceAd units with earnings, impressions, RPM, CTR and viewability
adsense_platform_splitEarnings, page views, RPM and CTR by platform (desktop, high-end mobile, tablet)
adsense_daily_trendDaily earnings, page views and RPM with flagged drops or spikes (≥30% vs
adsense_sitesSites in the AdSense account with approval state
adsense_alertsPolicy and account alerts for the AdSense account
adsense_paymentsUnpaid balance and payment history for the AdSense account
adsense_ad_unitsAd units per ad client in the AdSense account
adsense_monthly_reportOne call: calendar month to date vs
paid_vs_organicMatches Google Ads search terms against Search Console queries for the same period
content_monetizationJoins Search Console clicks per page with AdSense earnings per page URL
landing_page_overviewJoins Google Ads landing page spend and conversions with Search Console clicks for the same URLs
list_propertiesLists every connected Google account with its Search Console sites, Google Ads customer accounts and AdSense accounts

All tools are read-only. MetricPort never changes anything in your Google accounts.

Options

npx metricport-mcp                      sign in with your MetricPort accountnpx metricport-mcp --key mp_xxx         use an API keyMETRICPORT_API_KEY=mp_xxx npx metricport-mcpMETRICPORT_URL=...                      override the server URL (self-hosted or staging)

Pricing and data

Free plan: 1 Google account, Search Console, 500 tool calls per month. Pro and Agency add Google Ads, AdSense, more accounts, daily insights, alerts and shareable reports. See https://metricport.io/pricing.

Hosted in Frankfurt (EU). Refresh tokens are encrypted at rest, raw API responses are cached in memory for five minutes and never written to disk. Privacy policy: https://metricport.io/privacy.

License

MIT for this client package. The hosted service is governed by the terms.

来源：README.md，提交 4d7f27b

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.1.1最新Oct 18, 2026

评分

已满足适用检查项的 85%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

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

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