SpyWinAds

Name: SpyWinAds
Author: spywinads.com

远程服务

spywinads.com商业与营销01 天前更新

代码仓库访问官网

关于 SpyWinAds

SpyWinAds 为营销人员和电商团队提供 Meta 视频广告的只读研究，可查询视频年龄、复用该视频的商店、主页和商店广告，以及 Shopify 商品导出数据。

主要功能

01查询视频广告年龄及复用情况
02查看商店或 Facebook 主页的广告
03将 Shopify 商品详情导出为 CSV
04查看 Video Reuse Index 研究数据

适用场景

01判断视频广告是新上传还是旧视频复用
02查找使用相同视频创意的商店
03导出 Shopify 商品详情以供导入

MCP 相关

托管的只读 MCP 服务通过 Streamable HTTP 向 MCP 客户端提供五种广告研究和商品导出工具。可使用 OAuth 2.1 或 API 密钥进行身份验证。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://spywinads.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-spywinads https://spywinads.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-spywinads":{"type":"http","url":"https://spywinads.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-spywinads":{"type":"http","url":"https://spywinads.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-spywinads":{"type":"http","url":"https://spywinads.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-spywinads":{"serverUrl":"https://spywinads.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

SpyWinAds MCP 服务

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

远程服务： https://spywinads.com/mcp（Streamable HTTP）
身份验证： OAuth 2.1（使用你的 SpyWinAds 账号登录），或在 Authorization 标头中使用 API 密钥
只读。 5 个工具。免费套餐：每天 30 次调用。
文档：spywinads.com/developers

此仓库仅介绍托管服务，无需安装任何内容。

工具

工具	输入	返回内容
`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 产品 URL	标题、价格、变体、图片、Shopify 导入 CSV 链接（有效期 24 小时）、资料库中的该产品视频广告
`spywin_get_video_reuse_research`	—	SpyWinAds 视频复用指数的主要数据，以及方法说明和数据链接。无需登录

所有工具都标注为 readOnlyHint: true、destructiveHint: false。权限范围：ads:read（查询）和 product:export（CSV）。

连接

ChatGPT — 打开左侧边栏中的 Plugins → 右上角的 More → Add custom MCP server → 粘贴 https://spywinads.com/mcp。工具需要访问你的账号时，ChatGPT 会提示你登录 SpyWinAds 并点击 Allow。

Claude.ai / Claude Desktop — Customize → Connectors → Add custom connector → 粘贴 https://spywinads.com/mcp → 选择 Sign in when needed。

Claude Code

claude mcp add --transport http spywinads https://spywinads.com/mcp
# then run /mcp inside Claude Code to sign in

Cursor / VS Code / Windsurf（从 SpyWinAds Settings → API & MCP 获取 API 密钥）

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

切勿将密钥放入 URL。你可以随时在 SpyWinAds Settings → API & MCP 中撤销密钥和已连接的应用。

SpyWinAds 同意页面

示例提示词

“这个视频广告是新视频，还是旧视频重新投放？https://www.facebook.com/ads/library/?id=1014622548199238”
“zenblux.com 正在投放哪些 Facebook 视频广告？还有多少其他店铺使用相同的视频？”
“把这个 Shopify 产品复制到我可以导入的 CSV 中：https://www.allbirds.com/products/mens-tree-runners”

REST API

脚本、n8n 和 GPT Actions 可通过 HTTPS 调用相同工具：

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：https://spywinads.com/api/v1/openapi.json。错误采用 application/problem+json 格式（RFC 9457）；限额信息通过 RateLimit / Retry-After 标头返回。

数据和限额

美国地区展示的 Meta（Facebook、Instagram）广告，数据来自 SpyWinAds 资料库（由 SpyWinAds 用户扫描的广告）。
数量是观察到的广告最低数，并非销量。不包含广告支出、覆盖人数、订单或收入数据。
“最早的店铺”指资料库中最早出现的店铺，并非经核实的视频所有者。
每次调用返回 SpyWinAds 免费网页工具所显示的内容；无法搜索整个资料库。
限额：免费用户每天 30 次调用（于 00:00 UTC+7 重置），每分钟 20 次调用。

安全与隐私

采用 OAuth 2.1 和 PKCE（S256）、在 /.well-known/oauth-protected-resource/mcp 提供受保护资源元数据（RFC 9728）、提供授权服务器元数据（RFC 8414），并支持动态客户端注册和客户端 ID 元数据文档。访问令牌有效期为 1 小时；刷新令牌会轮换。
令牌和密钥仅以 SHA-256 哈希形式存储。令牌绑定到 https://spywinads.com/mcp。
我们会记录工具名称、成功或错误状态以及调用应用，不会记录你的提示词。隐私政策：spywinads.com/privacy。