原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Google E-commerce (GA4, Search Console, Merchant Center, Ads)

作者:MoonEyes版本 0.6.0i★ –i在你的电脑上运行
注册名称io.github.MoonEyes/google-ecommerce-mcp

安装

概览

作者提供的说明(英文原文)

Multi-client read and controlled write (off by default): GA4, GSC, Merchant, GTM, ad platforms.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在你的电脑上运行
  • 传输方式: stdio
  • 分类: 网店与支付
  • 你需要填写:PAGESPEED_API_KEY

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

  • 基础检查:1 项中通过 1 项
  • 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
  • 需要你自己填写: GA4_PROPERTY_ID, GSC_SITE_URL, MERCHANT_ACCOUNT_ID, GTM_CONTAINER_ID, PAGESPEED_API_KEY, GEM_CLIENT, GEM_WRITE, GOOGLE_TOKEN_FILE

标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。

你需要

  • PyPI已安装 Python 的 uv(用于 uvx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "google-ecommerce": {
      "command": "uvx",
      "args": [
        "google-ecommerce-mcp"
      ],
      "env": {
        "GA4_PROPERTY_ID": "your-value",
        "GSC_SITE_URL": "your-value",
        "MERCHANT_ACCOUNT_ID": "your-value",
        "GTM_CONTAINER_ID": "your-value",
        "PAGESPEED_API_KEY": "your-value",
        "GEM_CLIENT": "your-value",
        "GEM_WRITE": "your-value",
        "GOOGLE_TOKEN_FILE": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add google-ecommerce --env GA4_PROPERTY_ID=your-value --env GSC_SITE_URL=your-value --env MERCHANT_ACCOUNT_ID=your-value --env GTM_CONTAINER_ID=your-value --env PAGESPEED_API_KEY=your-value --env GEM_CLIENT=your-value --env GEM_WRITE=your-value --env GOOGLE_TOKEN_FILE=your-value -- uvx google-ecommerce-mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-ecommerce": {
      "command": "uvx",
      "args": [
        "google-ecommerce-mcp"
      ],
      "env": {
        "GA4_PROPERTY_ID": "your-value",
        "GSC_SITE_URL": "your-value",
        "MERCHANT_ACCOUNT_ID": "your-value",
        "GTM_CONTAINER_ID": "your-value",
        "PAGESPEED_API_KEY": "your-value",
        "GEM_CLIENT": "your-value",
        "GEM_WRITE": "your-value",
        "GOOGLE_TOKEN_FILE": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "google-ecommerce": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "google-ecommerce-mcp"
      ],
      "env": {
        "GA4_PROPERTY_ID": "your-value",
        "GSC_SITE_URL": "your-value",
        "MERCHANT_ACCOUNT_ID": "your-value",
        "GTM_CONTAINER_ID": "your-value",
        "PAGESPEED_API_KEY": "your-value",
        "GEM_CLIENT": "your-value",
        "GEM_WRITE": "your-value",
        "GOOGLE_TOKEN_FILE": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • GA4_PROPERTY_ID env
    GA4 numeric property id
  • GSC_SITE_URL env
    Search Console property, sc-domain:example.com or https://www.example.com/
  • MERCHANT_ACCOUNT_ID env
    Merchant Center account id
  • GTM_CONTAINER_ID env
    Tag Manager container id, GTM-XXXXXXX
  • PAGESPEED_API_KEY 机密 env
    PageSpeed Insights API key (optional)
  • GEM_CLIENT env
    Pin this server process to one client of the client registry (clients.json)
  • GEM_WRITE env
    Set to 1 to allow writing at all (off by default; each client and platform must also be enabled)
  • GOOGLE_TOKEN_FILE env
    Store the OAuth token in this file instead of the OS keyring

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 MoonEyes 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

与“网店与支付”中的其他服务器比较i

  • 星标数多于此分类中其他 2540 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 2540 个服务器的 66% 更新
  • 基础检查结果等于或优于此分类中其他 2540 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Google E-commerce (GA4, Search Console, Merchant Center, Ads) 安全吗?

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:PAGESPEED_API_KEY

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(0.6.0)于17天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它?

同一分类中有:Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Stripe MCP

作者:stripe

MCP server integrating with Stripe - tools for customers, products, payments, and more.

在云端运行★ 2,043MIT12个月前更新
安装

MCP Cn Commerce

作者:TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

在你的电脑上运行★ 96MIT28天前更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

google-ecommerce-mcp

One MCP server for the data an online shop decides from, for one shop or for many clients: GA4, Search Console, Merchant Center, Tag Manager, Indexing API, PageSpeed, the ad platforms Google Ads, Meta Ads and ChatGPT Ads, and the Meta pixel, catalog, Instagram and Page. It reads by default, and can also prepare controlled changes that you approve (pause a campaign, change a budget, submit a sitemap, add a tag in a workspace).

Ask your AI assistant "how much organic traffic did we get this month?", "which products are disapproved in Merchant Center?", "is GA4 loaded twice on my site?" or "what did each ad platform claim last month, and what does GA4 say?" and it answers from your own accounts. Out of the box it reads and reports and changes nothing. If you turn writing on for a client, the assistant can propose a change as a plan; nothing is sent until you approve it, and anything that costs money needs your approval in a terminal, outside the chat.

Built by MoonEyes, a small French shop selling 3D-printed tabletop terrain, because no existing MCP server covered GA4, Search Console and Merchant Center together.

Writing is off by default and has never been tested on a real account. The write tools exist in this version, but they were checked offline only, against fake answers written from each platform's documentation. Turning them on is opt-in per client and per platform, creations are always paused, and some risks cannot be removed (for example a Google Ads token or a ChatGPT Ads key cannot be limited to reading). Read docs/SECURITY.md and docs/WRITE.md before you turn it on, and try it first on a test account. New here? [docs/QUICKSTART.md](https://github.com/MoonEyes/google-ecommerce-mcp/blob/main/docs/QUICKSTART.md): your first client in 10 minutes.

The paid media connectors are new and tested offline only. The Google Ads, Meta Ads and ChatGPT Ads tools were checked against fake responses written from each platform's documentation. They have not been run against real ad accounts yet: compare the first figures with each platform's own interface. Details: docs/ADS.md.

Documentation

PageWhat is in it
QuickstartYour first client in 10 minutes: four commands
Several clientsThe client registry clients.json, secrets per client, isolation, an agency example
Reading pilotA pilot with one client and writing left off: access checklist, steps, how to check writing is off, how to revoke
Writing: plan, approve, applyTurn writing on in 5 steps, three full examples, every lock, every refusal and its fix
ArchitectureComponents, the write path, a tool call step by step, design choices, sequence diagrams
Tool referenceEvery tool (82): parameters, output, example questions
Setup, one service at a timeWhich services you need, access checklist and e-mail template for a client, install order with doctor checks, revocation
Client reportingMonthly report plan, KPI formulas, the report command and its input contract
Guided install promptsA prompt to paste into Claude to be guided step by step (French)
Third-party noticesCode ported from OpenGSC (MIT); ideas credited to other open-source projects (no code copied)
Easy setup guide for ad platformsGoogle Ads, Meta Ads, ChatGPT Ads: client e-mail, numbered steps, ids, checks, revocation
Paid media guideGoogle Ads, Meta Ads, ChatGPT Ads: prerequisites step by step, GAQL rules, errors, what is untested
Google Cloud setupOAuth client, APIs to enable, where to find each id
Security modelWhat writing changes, the real guardrails, the known limits, scopes, token storage, how to revoke
TroubleshootingEvery error we have met and its fix
Example promptsQuestions that work well, by use case
Client configsClaude Desktop (one or two shops), Claude Code

Why this one

  • One server for the whole picture. Traffic and sales (GA4), organic search (Search Console), the product feed (Merchant Center), the tracking setup (Tag Manager), site speed, and what the ad platforms say they delivered. Other MCP servers cover one or two of these.
  • Several clients, kept apart. An agency registers each client once (ids in a file, secrets in the OS keyring). Every call names its client, a foreign account id is refused, and one server process can be pinned to one client.
  • Read by default, controlled writing on request. Reading uses a per-platform allow-list with no write endpoint. Writing is off until you enable it per client and per platform, and then goes through one path only: plan (diff, dry run, signed token), your approval (in a terminal for anything that costs money, is irreversible or touches personal data), apply, and a journal. Creations are paused; there is no activation, deletion or publishing in this version.
  • Secrets kept out of the way. The Google token goes to your OS keyring (Windows Credential Manager, macOS Keychain or Secret Service). The Google Ads token is a separate keyring entry because its scope can write. Meta and ChatGPT Ads secrets go to the OS keyring from a hidden prompt (an environment variable also works), never on the command line or in a URL.
  • Answers a model can read correctly. Reports return the top rows plus totals over everything, the unit and definition of each metric, dates resolved in the account's timezone with a flag when the last days can still change, and the attribution windows each ad platform used.
  • Honest about what it does not know. Ad platforms count conversions their own way. The tools say so in every answer instead of adding up numbers that should not be added.
  • No third party. Requests go straight from your machine to Google, Meta and OpenAI. Nothing goes through a MoonEyes server.

How it compares

Checked on 2026-10-18 from each project's public page; they change fast, so check before you decide.

ProjectLicenseScopeWriting
googleanalytics/google-analytics-mcp (official)Apache-2.0GA4reads only
googleads/google-ads-mcp (official)Apache-2.0Google Adsreads only
Meta Ads MCP (official, hosted by Meta, beta)closedMeta Adsyes, hosted by Meta
pipeboard-co/meta-ads-mcpBUSLMeta Adsyes
stape-io/google-tag-manager-mcp-serverApache-2.0Tag Managerread and write
RoyAzran/mcp-adsMIT12+ ad and analytics platformssee its docs
This projectMITGA4, Search Console, Merchant Center, Tag Manager, PageSpeed, Google Ads, Meta Ads, ChatGPT Adsoff by default, plan, approval, journal, rollback; never tested on a real account

Where this one fits: you run several shops or clients from one self-hosted server and want every change shown as a diff and approved before it is sent. If you need one Google product only, or a hosted service with nothing to install, the official servers above are the better choice.

What you can ask

Each case gives the question, the tools the assistant usually calls, what you learn, and the decision it supports. The decision stays yours: by default the server shows data and changes nothing, and any change it prepares needs your approval. Ready-to-paste prompts are in examples/PROMPTS.md.

Traffic, search, feed, tracking

  1. Where do visits and sales come from? *"Sessions, purchases and revenue by channel, this month vs. last month."* Tools: ga4_report. You learn which channels bring revenue and which only bring visits. Decision: where to put the next hour or euro.
  2. Which searches are one push away from page one? *"Queries ranking 5 to 15 with more than 100 impressions, and their landing page."* Tools: gsc_performance. You learn which pages already earn impressions but few clicks. Decision: which titles, descriptions and internal links to rewrite first.
  3. Which disapproved products still get visits? *"Products disapproved in Merchant Center that still receive organic clicks."* Tools: merchant_product_issues, gsc_performance. You learn which feed errors hit pages people still visit. Decision: fix those products before the rest.
  4. Is the tracking trustworthy? *"Is GA4 loaded twice? Does the purchase tag fire once? Is the workspace the same as the live version?"* Tools: gtm_inventory, ga4_realtime. You learn whether purchases or page views may be double counted and whether unpublished changes exist. Decision: publish, remove a duplicate tag, or leave it.
  5. Preparing a redesign. *"Which landing pages earn money and organic clicks, which will need a 301, and what is today's speed baseline?"* Tools: ga4_report (dimension landingPage), gsc_performance, gsc_moves, gsc_opportunities, gsc_inspect_url, pagespeed. You learn which URLs to preserve, which redirects to plan, and the before-numbers to compare with after. Decision: the redirect map and what must not change.

Paid media (needs the c

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx