SpyWinAds

SpyWinAds MCP サーバー

ChatGPT、Claude、Cursor、または独自のスクリプトからFacebook動画広告を確認できます。動画広告が実際にいつから使われているか、同じ動画を使用しているすべてのストアを調べられます。

• リモートサーバー： https://spywinads.com/mcp（Streamable HTTP）
• 認証： OAuth 2.1（SpyWinAdsアカウントにサインイン）、またはAuthorizationヘッダー内のAPIキー
• 読み取り専用。 ツールは5つです。無料プランでは1日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 Video Reuse Indexの主要な数値、手法とデータへのリンク。サインイン不要です。

すべてのツールにはreadOnlyHint: true、destructiveHint: falseの注釈が付いています。スコープ：ads:read（検索）およびproduct:export（CSV）。

接続

ChatGPT — 左サイドバーでPluginsを開き、右上のMore → Add custom MCP serverを選択して、https://spywinads.com/mcpを貼り付けます。ツールの使用にアカウントが必要な場合、ChatGPTからSpyWinAdsへのサインインと許可を求められます。

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からいつでも取り消せます。

プロンプトの例

• 「この動画広告は新しいものですか、それとも古い動画が再び使われているのですか？ 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ヘッダーで返されます。

データと制限

• SpyWinAdsライブラリにある、米国で表示されたMeta（Facebook、Instagram）の広告（SpyWinAdsユーザーがスキャンした広告）。
• 件数は確認された広告の最低数であり、販売数ではありません。広告費、リーチ、注文、売上のデータはありません。
• 「最も早く使用したストア」とはライブラリ内で最も早く確認されたストアを指し、動画の所有者として検証されたストアではありません。
• 各呼び出しで返されるのは、無料のSpyWinAdsウェブツールに表示される情報です。ライブラリ全体を横断する検索機能はありません。
• 制限：無料プランは1日30回まで（00:00 UTC+7にリセット）、1分間に20回まで。

セキュリティとプライバシー

• PKCE（S256）を使用する OAuth 2.1、/.well-known/oauth-protected-resource/mcp での保護対象リソースメタデータ（RFC 9728）、認可サーバーメタデータ（RFC 8414）、動的クライアント登録、クライアント ID メタデータドキュメントを使用します。アクセストークンの有効期間は 1 時間です。リフレッシュトークンはローテーションします。
• トークンとキーは SHA-256 ハッシュとしてのみ保存されます。トークンは https://spywinads.com/mcp にバインドされます。
• 記録するのはツール名、成功またはエラー、呼び出し元のアプリであり、プロンプトは記録しません。プライバシーポリシー：spywinads.com/privacy。

サポート

[email protected] · ATT ECOMMERCE COMPANY LIMITED、ベトナム、ハノイ