adextract

Adextract MCP 服务

Adextract 是一款 MCP（Model Context Protocol）服务，为 AI 助手提供广告情报。它可搜索 Meta（Facebook 和 Instagram）、Google Ads、LinkedIn 和 TikTok 的广告库，并通过 ad_reader 分析广告创意素材。

托管端点： https://mcp.adextract.co/mcp 免费套餐： 50 次免费搜索。前往 adextract.co 获取 API 密钥。

⭐ 如果 Adextract 对你有帮助，请为这个仓库点亮星标。这有助于其他 AI 开发者发现它。

---

观看演示

也可在 YouTube 上观看。

---

工作原理

一个 MCP 服务，一个 API 密钥，四个广告库。你的 AI 助手通过 MCP 通信，Adextract 负责搜索和分析。

---

快速开始

1. 前往 adextract.co 获取免费 API 密钥（账户 → API 密钥）。
2. 使用以下配置将服务添加到 Cursor。
3. 向 AI 提问：“显示 Nike 在美国投放的 Facebook 活跃广告。”

无需在本地安装任何内容。Adextract 以托管 MCP 服务的形式运行，因此可用于任何支持 MCP 的客户端。

---

使用场景

• 竞争对手广告情报 - 查看竞争对手在 Meta、Google、LinkedIn 和 TikTok 上投放的广告。
• 创意分析 - ad_reader 可将任意广告创意素材拆解为格式、受众、情绪和原型。
• 品牌监控 - 跨四个广告库跟踪任意品牌或域名的广告。
• 渠道策略 - 内置 MCP 提示词可将广告数据转化为渠道计划。

---

安装

托管 MCP（推荐）

连接到 Adextract 托管服务：

https://mcp.adextract.co/mcp

前往 adextract.co 获取 API 密钥（账户 → API 密钥）。

Cursor

添加到 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "ad-extract": {
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "ad-extract": {
      "type": "http",
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Web（OAuth）

1. 打开 Claude → 设置 → 连接器 → 添加自定义连接器
2. 名称：ad-extract
3. URL：https://mcp.adextract.co/mcp
4. 按提示登录并批准（URL 中无需填写 API 密钥）。

Claude Desktop（mcp-remote）

{
  "mcpServers": {
    "ad-extract": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.adextract.co/mcp",
        "--header",
        "Authorization: Bearer ***"
      ]
    }
  }
}

更多客户端和配置路径： docs/CLIENT_SETUP.md

---

可用工具

工具	平台	描述
search_meta_ads	Meta	搜索 Facebook 和 Instagram 广告
search_meta_pages	Meta	发现主页和位置 ID
get_meta_page_info	Meta	主页透明度信息和元数据
get_meta_ad_details	Meta	欧盟/英国广告透明度详情
search_google_ads	Google	Google Ads 透明度中心
search_google_ads_advertisers	Google	搜索广告主和域名
get_google_ad_details	Google	创意素材详情
get_google_ads_advertiser_info	Google	Search 广告中的广告主资料
search_linkedin_ads	LinkedIn	LinkedIn 广告库
search_tiktok_ads	TikTok	TikTok 广告库
search_tiktok_advertisers	TikTok	发现 TikTok 广告主
get_tiktok_ad_details	TikTok	定向和创意素材详情
ad_reader	全部	分析图片/视频创意素材（格式、受众、情绪、原型）

完整参考：docs/TOOLS.md

---

提示词与资源

针对常见工作流的内置 MCP 提示词：

• adextract_top_ads_for_brand
• adextract_competitor_benchmark
• adextract_channel_strategy
• adextract_analyze_ad_url
• adextract_schedule_watchlist

资源包括 Agent 技能说明和提示词包参考（adextract://skill/main 等）。

---

身份验证

方式	最适用场景
OAuth 2.0	Claude Web 和支持 OAuth 的连接器
Bearer API key	Cursor、VS Code、Claude Desktop、mcp-remote

发现端点：

• https://mcp.adextract.co/.well-known/oauth-protected-resource
• https://mcp.adextract.co/.well-known/oauth-authorization-server/oauth

服务卡片（注册表／客户端发现）：

• https://mcp.adextract.co/.well-known/mcp.json

---

示例提示词

Show me the latest Nike ads on Facebook in the US.
→ search_meta_ads({ q: "nike", country: "US", active_status: "active" })

Find Google ads for tesla.com from the last 30 days.
→ search_google_ads({ domain: "tesla.com", time_period: "last_30_days" })

Analyze this ad creative URL with ad_reader.
→ ad_reader({ url: "https://..." })

---

常见问题

Adextract 是什么？

Adextract 是一个托管式 MCP 服务，可让 AI 助手搜索 Meta、Google Ads、LinkedIn 和 TikTok 的公开广告库，并分析广告创意。它兼容 Claude、Cursor、VS Code 以及任何支持 MCP 的客户端。

它涵盖哪些广告库？

Meta 广告资料库（Facebook 和 Instagram）、Google Ads 透明度中心、LinkedIn 广告资料库和 TikTok 广告资料库。

如何获取 API key？

在 adextract.co 注册，然后前往账户 → API keys。密钥在创建时仅显示一次。

有免费套餐吗？

有。新账户可免费搜索 50 次。付费套餐可在 adextract.co 获取。

ad_reader 有什么作用？

它会分析任何公开的图片或视频广告创意，并返回结构化 JSON：格式、目标受众、情绪（Plutchik/VAD）、原型以及行业／品牌。

我需要在本地运行代码吗？

不需要。Adextract 是托管式服务。你只需在客户端添加一条配置即可。

可以使用 OAuth 代替 API key 吗？

可以。Claude Web 和其他支持 OAuth 的连接器可直接登录，无需在 URL 中提供 API key。其他客户端则使用 Bearer API key。

这与直接查询广告库有何不同？

每个广告平台都有自己的资料库、API 和访问规则。Adextract 通过一个 MCP 接口统一接入所有四个平台，还提供创意分析，无需编写特定平台的代码。

---

文档

文档	用途
docs/CLIENT_SETUP.md	各客户端的配置
docs/TOOLS.md	工具、提示词、资源
docs/TROUBLESHOOTING.md	常见错误及解决方法
REGISTRY_CHECKLIST.md	提交前检查清单
SECURITY.md	安全政策
SUPPORT.md	获取帮助的方法

---

链接

• 网站： adextract.co
• MCP 端点： https://mcp.adextract.co/mcp
• 代码仓库： github.com/ad-vertly/adextract-mcp-server

---

社区

     

_{关注我们，获取广告情报技巧、MCP 更新，以及竞争对手正在投放的广告。}

---

_{由 Adextract 倾心打造}