API 和 MCP

直接在 ChatGPT 和 Claude 里问 SpyWinAds。

让 ChatGPT、Claude、Cursor 或你的脚本通过 SpyWinAds 查询 Facebook 视频广告：广告视频的真实年龄，以及所有投放同一视频的店铺。

https://spywinads.com/mcp
只读5 个工具免费方案：每天 30 次调用OAuth 登录

连接

ChatGPT

  1. 在左侧边栏打开“插件”，点击右上角的“更多”，然后选择“添加自定义 MCP 服务器”。
  2. 粘贴 https://spywinads.com/mcp.
  3. 当某个工具需要你的账户时，ChatGPT 会请你登录 SpyWinAds 并点击 Allow.

Claude.ai / Claude Desktop

  1. 访问 Customize → Connectors → Add custom connector.
  2. 粘贴 https://spywinads.com/mcp，选择 Sign in when needed.
  3. 在 Claude 提示时登录，然后点击 Allow.

Claude Code · Cursor · VS Code

Claude Code：运行命令后输入 /mcp 进行登录。

claude mcp add --transport http spywinads https://spywinads.com/mcp

Cursor、VS Code、Windsurf、脚本：在 header 中发送 API 密钥：

{ "mcpServers": { "spywinads": {
  "url": "https://spywinads.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

切勿将密钥放在链接中。你可以随时在 SpyWinAds 的“设置 → API 与 MCP”中撤销密钥并移除已连接的应用。

向 AI 助手提问

“这个广告视频是新的，还是被拿出来重新投放的旧视频？https://www.facebook.com/ads/library/?id=…”
“店铺 example.com 正在投放哪些 Facebook 视频广告？有多少其他店铺在使用同样的视频？”
“把这个 Shopify 产品导出为 CSV 文件，方便我导入店铺：https://store.com/products/…”

工具

只读数据。5 个工具。免费套餐：每天 30 次调用。权限： ads:read 用于查询公开广告数据， product:export 用于生成产品 CSV 文件。不读取账户数据，不写入任何内容。

spywin_lookup_video_ad输入

Meta 广告资料库链接或广告 ID

返回

视频的真实年龄（文件首次上传到 Facebook 的日期，误差 1–2 天）、首条广告、正在投放的广告数、正在投放和曾经投放同一视频的店铺数，以及库中最早投放的店铺

spywin_spy_store_ads输入

店铺域名

返回

正在投放的广告、7 天内的新广告、视频数、产品、公共主页，以及热门视频及其真实年龄和店铺数

spywin_get_page_ads输入

Facebook 公共主页链接或 ID

返回

广告总数和正在投放的广告数、视频数、热门视频，以及该公共主页引流到的店铺

spywin_export_shopify_product输入

Shopify 产品链接

返回

名称、价格、变体、图片、可导入 Shopify 的 CSV 文件下载链接（保留 24 小时），以及库中该产品的广告视频。权限 product:export

spywin_get_video_reuse_research输入

—

返回

SpyWinAds Video Reuse Index 报告的主要数据，附方法和数据链接。无需登录

获取免费 API 密钥

适用于脚本和代码编辑器（Cursor、VS Code）。ChatGPT 和 Claude 无需密钥：它们使用你的 SpyWinAds 账户登录。输入电子邮件，我们会发送确认链接，并仅显示一次密钥。

已有 SpyWinAds 账户？直接在应用中创建密钥：设置 → API 与 MCP。

REST API

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://spywinads.com/api/v1/store?domain=example.com"

调用端点： /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse。OpenAPI 文档： /api/v1/openapi.json （可用于 GPT Actions 和 n8n）。

限制与数据

  • 免费套餐：每天 30 次调用（越南时间 0 点重置），每分钟最多 20 次。试用账户：每天 100 次调用。
  • 数据：在美国展示的 Meta 广告（Facebook、Instagram），来自 SpyWinAds 库。计数为最低值，并非销量。不包含广告花费、覆盖人数或收入。“最早的店铺”指库中最早的店铺，并非视频所有者。
  • 每次调用返回的内容与网页版免费工具显示的完全一致；不支持在整个库中搜索。
  • 库中还没有？结果会附带网页工具的链接，你可以在那里免费提交扫描请求。

问题：support@spywinads.com · 隐私政策 ›