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 分