SpyWinAds

com.spywinads由 spywinads.com 發布官方發布者v1.0.0更新於 Oct 30, 2026

Facebook video ad intel: a video ad's real age and every store running the same video.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

SpyWinAds 是託管、唯讀的 MCP 伺服器,用來查詢 Facebook 影片廣告情報:影片真正的上傳時間,以及有多少商店投放同一支影片。

可以做什麼
  • 依 Meta 廣告檔案庫連結或廣告 ID 查詢影片真實年齡、首次投放日期、投放中廣告與重用該影片的商店
  • 查看某個 Shopify 或線上商店正在投放的 Facebook 影片廣告、7 天內新廣告、商品、粉絲專頁與熱門影片
  • 查看某個 Facebook 粉絲專頁的廣告、投放中廣告、影片,以及該專頁導流的商店
  • 讀取公開的 Shopify 商品頁,取得標題、價格、規格、圖片,以及有效期 24 小時的 CSV 匯入連結
  • 取得 SpyWinAds 影片重用指數的主要數據與方法連結
適用情境
適合電商與選品研究:判斷某支 Facebook 影片廣告是新素材,還是舊影片重新投放,以及同一支影片被多少商店重用。也適合把公開的 Shopify 商品整理成可匯入的 CSV。
執行需求
遠端 Streamable HTTP 端點,無需安裝。需以 SpyWinAds 帳號透過 OAuth 2.1 登入,或在 Authorization 標頭提供 API 金鑰(於 SpyWinAds 設定取得)。免費方案每天 30 次呼叫、每分鐘 20 次;研究工具無需登入。
安裝前請注意
需要 SpyWinAds 帳號或 API 金鑰;不要把金鑰放進網址,外洩後可在設定中撤銷。資料僅涵蓋美國地區的 Meta 廣告,計數是觀測到廣告的最低值,且不含花費、觸及、訂單或營收資料,因此無法證明商品好賣。CSV 匯出連結 24 小時後失效。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SpyWinAds,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.spywinads%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "spywinads": {
      "type": "http",
      "url": "https://spywinads.com/mcp"
    }
  }
}

README

[SpyWinAds]

SpyWinAds MCP server

Check Facebook video ads from ChatGPT, Claude, Cursor or your own scripts: how old a video ad really is, and every store running the same video.

  • Remote server: https://spywinads.com/mcp (Streamable HTTP)
  • Auth: OAuth 2.1 (sign in with your SpyWinAds account), or an API key in the Authorization header
  • Read-only. 5 tools. Free plan: 30 calls a day.
  • Docs: spywinads.com/developers

This repository only documents the hosted server. There is nothing to install.

Tools

ToolInputReturns
spywin_lookup_video_adMeta Ad Library link or ad IDWhen the video file was first uploaded to Facebook (within 1–2 days), first ad date, live ads, stores running the same video now and ever, earliest stores in the library
spywin_spy_store_adsStore domainLive ads, new ads in 7 days, videos, products, Pages, top videos with real age and store count
spywin_get_page_adsFacebook Page link or IDAds and live ads, videos, top videos, stores the Page sends traffic to
spywin_export_shopify_productShopify product URLTitle, prices, variants, images, a Shopify-import CSV link (24 hours), the product's video ads in the library
spywin_get_video_reuse_research—Headline numbers of the SpyWinAds Video Reuse Index, with method and data links. No sign-in needed

All tools are annotated readOnlyHint: true, destructiveHint: false. Scopes: ads:read (look-ups) and product:export (CSV).

Connect

ChatGPT — open Plugins in the left sidebar → More (top right) → Add custom MCP server → paste https://spywinads.com/mcp. When a tool needs your account, ChatGPT asks you to sign in to SpyWinAds and click Allow.

Claude.ai / Claude Desktop — Customize → Connectors → Add custom connector → paste https://spywinads.com/mcp → choose Sign in when needed.

Claude Code

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

Cursor / VS Code / Windsurf (API key from SpyWinAds Settings → API & MCP)

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

Never put a key in a URL. Keys and connected apps can be revoked any time in SpyWinAds Settings → API & MCP.

[SpyWinAds consent screen]

Example prompts

REST API

Same tools over HTTPS for scripts, n8n and GPT Actions:

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

Endpoints: /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. Errors are application/problem+json (RFC 9457); limits come back in RateLimit / Retry-After headers.

Data and limits

  • Meta (Facebook, Instagram) ads shown in the US, from the SpyWinAds library (ads scanned by SpyWinAds users).
  • Counts are minimums of ads observed, not sales. No ad spend, reach, orders or revenue data.
  • "Earliest store" means earliest in the library, not the verified owner of the video.
  • Each call returns what the free SpyWinAds web tools show; there is no search across the whole library.
  • Limits: free 30 calls a day (resets 00:00 UTC+7), 20 calls a minute.

Security and privacy

  • OAuth 2.1 with PKCE (S256), protected resource metadata (RFC 9728) at /.well-known/oauth-protected-resource/mcp, authorization server metadata (RFC 8414), dynamic client registration and client ID metadata documents. Access tokens last 1 hour; refresh tokens rotate.
  • Tokens and keys are stored only as SHA-256 hashes. Tokens are bound to https://spywinads.com/mcp.
  • We log the tool name, success or error and the calling app, not your prompts. Privacy policy: spywinads.com/privacy.

Support

[email protected] · ATT ECOMMERCE COMPANY LIMITED, Hanoi, Vietnam

來源:README.md,提交 6f2c337

工具

5

spywin_lookup_video_ad

Look up a Facebook video ad

Check how old a Facebook video ad really is and which stores run the same video. Input: a Meta Ad Library link or ad ID. Returns the day the video file was first uploaded to Facebook (accurate to 1-2 days), the first ad date, live ads, how many stores run the same video now and ever, and the earliest stores in the SpyWinAds library.

輸入參數ad必填

spywin_spy_store_ads

Spy on a store's Facebook ads

See the Facebook video ads a Shopify / online store is running. Input: the store domain. Returns live ads, new ads in 7 days, number of videos, products and Pages, and the top videos with their real age and how many stores run each one.

輸入參數domain必填

spywin_get_page_ads

Video ads of a Facebook Page

See the video ads a Facebook Page runs: total and live ads, videos, top videos with real age, and the stores the Page sends traffic to. Input: Facebook Page link or Page ID.

輸入參數page必填

spywin_export_shopify_product

Copy a Shopify product to CSV

Read a public Shopify product page and return its title, prices, variants and images, plus a download link to a Shopify-import CSV (valid 24 hours) and the product's video ads if the SpyWinAds library has them.

輸入參數url必填

spywin_get_video_reuse_research

Video Reuse Index (research)

Headline numbers from SpyWinAds Research 'Video Reuse Index': how often Facebook video ads are old videos brought back, how many stores share a video, and how fast a video spreads to 5 stores. With method link.

無需輸入參數。

版本歷史

1
  1. v1.0.0最新Oct 29, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。