287 v0.45.0 更新于 2026-11-16

AdLoop MCP Server

在您的 AI 客户端中使用 Google Ads、Reddit Ads、GA4 和 Tag Manager,每次更改前都可预览。

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
远程接入
任意支持远程 MCP(streamable-http)的客户端,如 Claude、ChatGPT 开发者模式、自建 Agent

安装配置

本地运行(pypi)
{
  "mcpServers": {
    "adloop": {
      "command": "uvx",
      "args": [
        "adloop"
      ]
    }
  }
}
远程接入(streamable-http)
{
  "mcpServers": {
    "adloop": {
      "url": "https://mcp.getadloop.com/mcp"
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 13 个工具

health_check
一次性测试 OAuth、GA4 和 Ads 的连接状态,并在出现问题时给出可操作的错误信息。
get_account_summaries
列出 GA4 账户和媒体资源。
run_ga4_report
生成自定义 GA4 报告:会话、用户、关键事件、页面表现,支持维度与指标过滤、排序、分页和对比时段。
run_realtime_report
获取实时数据,用于在部署后验证跟踪是否生效。
get_tracking_events
列出所有已配置的事件及其数据量。
list_key_events
列出媒体资源的关键事件(转化),包含计数方式、创建时间及是否可删除。
list_ga4_dimensions_and_metrics
列出该媒体资源可报告的所有维度和指标(含自定义项),并支持搜索。
list_accounts
发现可访问的 Google Ads 账户。
get_campaign_performance
获取广告系列指标:展示、点击、花费、转化、CPA 及搜索展示份额与丢失份额。
get_ad_performance
分析广告文案:标题、描述、CTR、政策审批状态和主题。
get_keyword_performance
获取关键词表现,包括质量得分和竞争指标。
get_search_terms
获取用户点击前实际搜索的搜索词报告。
get_negative_keywords
列出广告系列级否定关键词。