MetricPort

metricport-mcp

适用于 Google Search Console、Google Ads 和 AdSense 的 MCP 服务，可与 Claude、Cursor、Windsurf、VS Code、ChatGPT 及任何其他 MCP 客户端搭配使用。

此软件包是一个轻量级本地客户端。服务本身托管在 metricport.io：它负责管理 Google OAuth 连接、调用三个 Google API，并提供 57 个只读分析工具，以及每日洞察、提醒和报告。你无需自行创建 Google Cloud 项目、OAuth 客户端或开发者令牌。

npx metricport-mcp

快速开始

1. 在 metricport.io 创建免费账户并连接 Google 账户（免费版支持 Search Console，Pro 版支持 Ads 和 AdSense）。
2. 将服务添加到客户端。你可以在浏览器中登录一次，也可以在 https://metricport.io/app/keys 创建 API 密钥。

Claude Desktop（claude_desktop_config.json）：

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

Cursor（.cursor/mcp.json）、Windsurf、VS Code（.vscode/mcp.json）：配置格式相同。

claude.ai、ChatGPT 和其他支持远程服务的客户端无需安装任何软件包。添加自定义连接器，使用 URL https://metricport.io/api/mcp，然后登录。

你可以询问的问题

• “本周哪些页面的点击量下降最多？它们有什么共同点？”
• “显示排名在第 5 至第 20 位且有实际展示量的临界排名查询。”
• “我的 Google Ads 账户中，哪些搜索词花了钱却没有带来转化？”
• “与上个月相比，我的 AdSense 收入为什么下降了？”
• “我为哪些关键词付费，而这些词其实已经有自然搜索排名？”

工具

工具	功能
gsc_search_analytics	按维度分组的搜索表现（点击次数、展示次数、CTR、排名），支持可选筛选条件
gsc_top_queries	过去 N 天（默认 28 天）点击次数最多的搜索查询
gsc_top_pages	过去 N 天（默认 28 天）点击次数最多的页面
gsc_page_queries	单个 URL 获得排名的所有查询，以及点击次数、展示次数、CTR 和排名
gsc_quick_wins	排名有望提升的查询（默认排名为 5-20），这些查询有实际展示次数；按排名提升约 3 位后预计增加的点击次数排序
gsc_ctr_opportunities	排名在首页但 CTR 远低于该排名预期 CTR 的查询
gsc_content_decay	与上一时段相比点击次数下降最多的页面（或使用 compareTo=year 与去年同期相比）
gsc_new_and_lost_queries	本时段出现但上一时段没有的查询，以及已消失的查询
gsc_cannibalization	两个或多个页面竞争同一关键词的查询
gsc_brand_split	使用正则表达式将查询划分为品牌和非品牌（例如
gsc_query_clusters	根据共同词语将查询分组为主题集群，并提供点击总数、展示总数和示例查询
gsc_question_queries	按展示次数排序的疑问句形式查询（how、what、why、wie、was、warum……）
gsc_zero_click_pages	有展示次数但没有点击次数的页面
gsc_daily_trend	每日点击次数和展示次数，以及 7 日移动平均值；标记下降或飙升（相较于 ≥30%
gsc_device_country_breakdown	按设备和国家/地区统计点击次数、展示次数、CTR 和排名，并提供移动设备与桌面设备之间的 CTR 差距
gsc_search_appearance	按搜索外观（富媒体搜索结果、视频、AMP……）统计表现，并提供同一时段的 Discover 和 Google 新闻流量
gsc_inspect_url	单个 URL 的 Google 索引状态：判定结果、覆盖状态、上次抓取时间、规范网址、移动设备易用性、富媒体搜索结果
gsc_index_check	检查最多 10 个 URL 并返回精简表格：是否已编入索引、覆盖状态、上次抓取时间、Google 选择的规范网址与
gsc_sitemaps	已提交的网站地图及其状态、错误、警告和 URL 数量
gsc_weekly_report	一次调用即可生成面向客户的每周摘要：总计与
ads_list_accounts	已连接的 Google Ads 客户账号，包括管理账号（MCC）及其直接子账号
ads_query	对客户账号运行 Google Ads Query Language（GAQL）SELECT 查询
ads_campaign_performance	指定日期范围内的广告系列数据：费用、点击次数、展示次数、CTR、转化次数、每次转化费用、ROAS 和状态（默认最近 30 天）
ads_search_terms	触发广告的实际搜索字词，以及费用、点击次数、展示次数和转化次数
ads_wasted_spend	本时段内产生费用或点击却从未带来转化的搜索字词（默认 30 天）；跨广告系列汇总，并提供否定关键词建议（反复出现的词用词组匹配，偶发词用完全匹配）
ads_keyword_performance	关键词的匹配类型、状态、质量得分、费用、点击次数、转化次数、CPA 和展示次数份额
ads_quality_score_audit	按展示次数加权的质量得分、1-10 分的分布，以及得分低于或等于阈值的关键词；同时提供其最弱组成部分（预期 CTR、广告相关性、着陆页体验）和相关花费
ads_impression_share	各广告系列的搜索展示次数份额，以及因预算不足和排名损失的份额；另含页首和绝对页首展示率
ads_budget_pacing	每个广告系列本月至今的花费与根据每日预算预计的花费对比，并提供月底预测
ads_ad_performance	响应式搜索广告的广告效力、最终 URL、标题数量、CTR、费用和转化次数
ads_geo_performance	按国家/地区统计费用、点击次数、转化次数和 CPA（或使用 level 按州/省或城市统计）
ads_device_performance	按设备（移动设备、桌面设备、平板电脑）统计账号或单个广告系列的费用、点击次数、CTR、转化次数和 CPA
ads_dayparting	按小时和星期几统计费用、点击次数、转化次数和 CPA
ads_landing_pages	着陆页的费用、点击次数、转化次数、CPA 和移动设备友好点击率
ads_recommendations	Google 为账号提供的优化建议（关键词、预算、广告建议、出价），以及可用时的预估影响
ads_change_history	过去 N 天（最多 30 天）账号中谁更改了什么：资源类型、操作、用户、时间戳
ads_conversion_actions	已配置的转化操作及其状态、类别、计数类型、归因模型，以及它们在本时段产生的转化次数
ads_pmax_asset_groups	Performance Max 广告系列的素材资源组及其广告效力、费用、转化次数和转化价值
ads_daily_trend	账号的每日费用、点击次数、转化次数和 CPA，并标记费用飙升或下降（相较于 ≥30%
ads_metadata	描述 Google Ads 资源的可选字段（例如
ads_account_audit	一次调用即可运行关键检查：广告系列总计与
adsense_earnings	收益摘要：所选范围内的总计（默认最近 30 天）以及每日明细
adsense_report	使用所选维度和指标生成指定日期范围的自定义报告（默认最近 30 天）
adsense_top_pages	按预估收益排列的页面及其页面浏览量和 RPM
adsense_by_country	按国家/地区统计收益、页面浏览量、RPM 和 CTR
adsense_ad_unit_performance	广告单元的收益、展示次数、RPM、CTR 和可视率
adsense_platform_split	按平台（桌面设备、高端移动设备、平板电脑）统计收益、页面浏览量、RPM 和 CTR
adsense_daily_trend	每日收益、页面浏览量和 RPM，并标记下降或飙升（相较于 ≥30%
adsense_sites	AdSense 账号中的网站及其批准状态
adsense_alerts	AdSense 账号的政策和账号提醒
adsense_payments	AdSense 账号的未付款余额和付款历史记录
adsense_ad_units	AdSense 账号中每个广告客户的广告单元
adsense_monthly_report	一次调用：本日历月至今与
paid_vs_organic	将 Google Ads 搜索字词与同一时段的 Search Console 查询相匹配
content_monetization	将 Search Console 的每页点击次数与 AdSense 的每页 URL 收益关联起来
landing_page_overview	将 Google Ads 着陆页的花费和转化次数与相同 URL 的 Search Console 点击次数关联起来
list_properties	列出每个已连接的 Google 账号及其 Search Console 网站、Google Ads 客户账号和 AdSense 账号
所有工具均为只读。MetricPort 不会更改你 Google 账号中的任何内容。

选项

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

定价与数据

免费计划：1 个 Google 账号、Search Console、每月 500 次工具调用。Pro 和 Agency 计划还提供 Google Ads、AdSense、更多账号、每日洞察、提醒和可分享的报告。请参阅 https://metricport.io/pricing。

服务托管在法兰克福（欧盟）。刷新令牌采用静态加密；原始 API 响应缓存在内存中，保留 5 分钟，绝不会写入磁盘。隐私政策：https://metricport.io/privacy。

许可证

此客户端软件包采用 MIT 许可证。托管服务受服务条款约束。