Spytrend

Spytrend MCP サーバー

Spytrend は広告分析プラットフォームです。 このリポジトリは、その MCP サーバーの公式情報を掲載しています。URL は 1 つ、ブラウザーでサインインするだけで、AI アシスタントが Meta と TikTok の広告データを直接扱えるようになります。広告、その広告に使われている画像や動画、広告主、そして広告を運用している人まで確認できます。インストールもキーの貼り付けも不要です。サーバーは当社側で稼働しており、サイトで使っているものと同じ Spytrend アカウントでサインインします。無料プランを含むすべてのプランで接続できます。利用量はトークン単位で計測され、質問ではなく結果に対して課金されます。何も返さない呼び出しは無料です。広告は 1 つのフレームにすぎません。ここでは、競合他社が運用しているすべての広告を確認できます。

---

このリポジトリについて

このリポジトリには、当社がホストするサーバーの公開カタログメタデータ（server.json を参照）と、セットアップ手順および活用例が含まれています。サーバー自体は Spytrend プラットフォームの一部であり、そのソースは公開されていません。ダウンロードするパッケージも、実行するコードもありません。URL とサインインボタンだけで接続できます。

---

接続

エンドポイント

https://mcp.spytrend.com/mcp

サインイン： ブラウザーで Spytrend アカウントを使用します。API キーも、貼り付けるトークンも不要です。

アカウント内での場所： Settings → AI / MCP、または接続ページ https://spytrend.com/mcp/?utm_source=github&utm_medium=repo&utm_campaign=mcp-launch。

使用するクライアントにかかわらず、手順は 3 つです。

1. クライアントのコネクター設定を開きます。
2. リモート MCP サーバーを追加し、上記の URL を設定します。
3. ブラウザーウィンドウが開いたらサインインして、質問を始めます。

クライアント別の手順：docs/quickstart.md。

ワンクリックでインストール：

Claude — デスクトップ、CLI、ウェブ

Settings → Connectors でカスタムコネクターを追加し、エンドポイント URL を貼り付けて、開いたブラウザーウィンドウでサインインを完了します。詳しい手順：docs/quickstart.md#claude。

ChatGPT

Settings でエンドポイントをコネクターとして追加し、Spytrend アカウントでサインインします。 詳しい手順：docs/quickstart.md#chatgpt。

Cursor · Codex · VS Code

上記のエンドポイントを、タイプ streamable-http のリモート MCP サーバーとして追加し、求められたらブラウザーからサインインします。詳しい手順：docs/quickstart.md。

Streamable HTTP に対応するクライアントならどれでも動作します。上記の 4 つは、手順をまとめているクライアントです。

---

得られる情報

検索。 市場、カテゴリ、国で何が宣伝されているかを、キーワード、ビジネスカテゴリ、フォーマット、配信期間で検索できます。広告素材そのもの、つまり実際に目にする画像や動画も検索できます。

1件のレコードをすべて確認。 1件の広告、広告主、または複数の広告を管理するアカウントを開き、テキスト、素材、ページ、ドメイン、国、配信期間を含むすべての情報を確認できます。

ランキング。 国、カテゴリ、アプリで新たに注目を集めているものを確認できます。具体的な競合が思い浮かばないときの手がかりになります。

フォルダーと残高。 見つけた情報をフォルダーに保存し、後から取り出せます。残高はいつでも無料で確認できます。

自律型エージェント。 エージェントは自ら登録し、誰かがサインアップする前にデータベースのサンプリングを開始できます。検索結果のアーカイブ、市場レベルのランキング、1回あたり10行、メディアなしで利用できます。Spytrend アカウントと連携すると、ほかの機能も利用できます。docs/quickstart.md をご覧ください。

---

競合が出稿している広告のすべて

1件の広告は1つのフレームにすぎません。ここでは、すべての広告、動画、ページ、ドメイン、国、配信期間をまとめた、活動の全体像を確認できます。広告の背後にあるアカウントを一度開けば、全体像がすでにまとまっているため、自分でタブを行き来して情報を集める必要はありません。

ほとんどのサービスが答えるのは、この広告を見せて という問いです。このサービスが答えるのは、別の問いです。誰が広告を出稿していて、ほかに何を出稿しているのか？

---

ツール

ツール	機能	コスト
search_ads	キーワード、国、ビジネスカテゴリ、フォーマット、配信期間でMetaとTikTokの広告を検索します	返された行ごとに1トークン
search_creatives	広告素材そのもの、つまり実際に人が目にする画像や動画を検索します	返された行ごとに1トークン
search_advertisers	名前、ドメイン、国、ビジネスカテゴリで広告主を検索します	返された行ごとに1トークン
search_webmasters	広告グループの背後にいる企業や人物を検索します。1つのアカウントで、複数のページ、ドメイン、国にわたって多数の広告を配信しています	返された行ごとに1トークン
search_hubs	広告の誘導先を、ソーシャルプラットフォーム、アプリストア、マーケットプレイス、ショップなどの種類別に調べます	誘導先のカタログ：無料。カタログ内のプロフィール：行ごとに1トークン
search_shops	トラフィックの受け皿としてドメインを調べ、月間訪問数の推定値と各推定値の信頼度を確認します	返された行ごとに1トークン
get_ad	1件の広告の完全なレコードを返します。テキスト、素材、広告主、国、配信期間、誘導先ページが含まれます	1トークン
get_advertiser	1社の広告主の完全な情報を返します。ページ、国、ビジネスカテゴリが含まれます	1トークン
get_webmaster	広告グループの背後にいるアカウントが配信するすべての内容を、1つのレコードで返します	1トークン
get_creative	1件の画像または動画のレコードを返します。配信先と再配信された回数が含まれます	1トークン
get_shop	1つのドメインの完全なプロフィールを返します	1トークン
get_media	画像または動画のファイル自体をダウンロードします	広告1件あたり1トークン・クリエイティブ1件あたり10トークン
get_trends	国、カテゴリ、アプリのランキングを返します。新たに勢いを増しているものも確認できます	返された行ごとに1トークン
get_ads_analytics	広告自体ではなく、選択した広告の全体像を返します。広告数や、ステータス、国、ビジネスカテゴリ、誘導先、広告主ごとの内訳を確認できます	Pro以上・内訳の行ごとに1トークン
find_similar_ads	既存の広告と同じ素材を使用している広告を検索します	返された行ごとに1トークン
find_similar_creatives	既存の画像や動画と見た目が同じものを検索します	返された行ごとに1トークン
find_similar_webmasters	既存のアカウントと同様の広告を配信しているアカウントを検索します	返された行ごとに1トークン
get_webmaster_similarity_facets	類似アカウントの一覧を取得する前に、2つのアカウントがどの点で似ているかを表示します	無料
add_to_favorites	広告、画像や動画、広告主、誘導先、アカウントをフォルダーに保存します	広告：1トークン・クリエイティブ：10トークン・その他すべて無料
list_favorites	フォルダーに保存されている内容を返します	無料
get_usage	プラン、残高、各呼び出しのコストを表示します	無料

1ページあたりの返却行数は、指定がない場合は20行、最大でも200行です。料金は 実際に返された行数に応じて課金されます。ページの行数が少ない場合は、差額が自動で返金されます。TikTokのデータセット （source=tiktok、Proプラン以上）は別料金で、返された行ごとに100トークンです。

各ツールの「使用する場合」／「使用しない場合」のガイダンス、返却形式、リクエスト例については、 docs/tools.md をご覧ください。

用語の説明。 この製品では、webmaster は広告グループの背後にいる企業や人物を指します。1つのアカウントで、複数のページ、ドメイン、国にわたって多数の広告を配信しています。ツール名には元の用語が使われていますが、説明文はこの用語に依存しません。

---

スキル

Claude Code と Codex 向けのすぐに使える6つのワークフローをskills/に用意しています。特定の業界を調査したり、広告主や複数の広告を掲載しているアカウントを分析したり、ウェブサイトをレビューしたり、キーワード検索やショップの発見を行ったりできます。各スキルは単なるフォルダーです。アシスタントのスキルディレクトリにコピーして、普段の言葉で依頼してください。スキルが呼び出すツールを選び、レポートを作成します。インストール手順と共通仕様については、skills/README.mdをご覧ください。

ワンコマンドでインストールできます。Claude Code では /plugin marketplace add Spytrend/spytrend-mcp の後に /plugin install spytrend-mcp-skills@spytrend-mcp を実行します。Claude Code、Codex、Cursor、Copilot、Gemini CLI など70以上の環境では npx skills add Spytrend/spytrend-mcp を実行します。

---

シナリオアダプター

同じホストサーバーを利用する、より小規模な stdio アダプターです。それぞれ固有のツール名で1つの調査シナリオを提供します。アシスタントにカタログの一部だけを表示したい場合にご利用ください。

• facebook-ads-library-mcp — Meta / Facebook 広告ライブラリの検索。データソースは Meta に固定されています。
• tiktok-ads-library-mcp — TikTok 広告の調査。データソースは TikTok に固定されています（Pro プラン）。

すべてのアダプターは https://mcp.spytrend.com/mcp に接続し、同じアカウント、プラン、トークンを共有します。

---

コミュニティ

コミュニティによって構築されたもので、Spytrend チームはメンテナンスしていません。

• dvygolov/spytrend-cli：Daniel Vygolov による、単独で動作する Python CLI と、エージェントスキルとしてそのまま使えるツールです。MCP ホストなしで動作するエージェントやスクリプト向けに、OAuth2 クライアントクレデンシャルを使用して Streamable HTTP 経由でこのサーバーを呼び出します。

Spytrend MCP を使って何かを作成しましたか？リンクを添えてイシューを作成してください。ここに追加します。

---

レシピ

初日にアシスタントによく尋ねられる内容を紹介します。依頼を自分の言葉で入力すると、アシスタントがツールを選びます。

レシピ	依頼する内容
市場でほかに広告を出している企業を見つける	今、自分の業界で広告を出しているのは誰で、どんな広告を配信しているか
業種から探す	競合他社の名前を指定せず、自社と同じような業種の企業の広告を探す
1つの市場で人気の広告	あるカテゴリで配信されている広告を、掲載期間の長い順に確認する
業界で今配信中の広告	新しく登場して勢いのある広告と、しばらく配信されている広告を確認する

---

クレジットとプラン

利用料は1つの残高からトークン単位で差し引かれます。**依頼ではなく、結果に対して料金が発生します。**結果が返されない呼び出しは無料で、依頼した件数より少ないページが返された場合は差額が払い戻されます。

• 返された行またはレコード1件 — 1トークン。検索結果の1行、ランキングの1行、広告主、アカウント、遷移先、またはクリエイティブの詳細表示が対象です。
• 素材自体のダウンロード — 広告は1トークン、クリエイティブは10トークン。
• TikTok のデータセット（source=tiktok、Pro 以上） — 返された行1件につき100トークン。
• 残高の確認、フォルダーの一覧表示、遷移先カタログの確認 — 無料。

無料の Starter プランには500トークンが含まれており、有効期限はありません。有料プランにはすべて、月40,000トークンが含まれています。これはデフォルトサイズの検索約2,000回分に相当します。Enterprise の上限についてはサポートにお問い合わせください。

無料プランを含むすべてのプランで接続できます。**無料の Starter プランではアーカイブに限られ、直近90日間のデータは表示されません。**新しい広告を利用できるのは有料プランです。この制限は、サイトの無料プランと同じです。アシスタントはいつでも get_usage を呼び出して使用状況を確認できます。無料で、サーバー自体から回答が返されます。最新の料金については、こちらをご覧ください。 https://spytrend.com/pricing/?utm_source=github&utm_medium=repo&utm_campaign=mcp-launch

残高がなくなったときにアシスタントに表示される内容など、詳細については**docs/limits.md**をご覧ください。

---

ドキュメント

ファイル	内容
docs/quickstart.md	クライアントごとの5分でできる接続方法
docs/tools.md	各ツールの機能、使用するタイミング、使用しないタイミング、返される内容
docs/limits.md	クレジット、制限、プラン、エラーの表示例
examples/	4つのレシピ：質問する内容、返される内容、その読み方
skills/	Claude Code と Codex 用の、インストール手順と共通の仕様を含む6つのすぐに使えるワークフロー
server.json	公式 MCP レジストリに公開されているカタログのメタデータ
llms.txt	AI アシスタント向けに、この接続を機械可読形式で簡潔にまとめたマップ

---

サポート

接続、アクセス、アカウントについてのご質問は、こちらをご覧ください：https://spytrend.com/contact/

このリポジトリに問題がある場合（リンク切れ、画面の表示と一致しない手順など）は、issue を作成してください。

セキュリティに関する報告には専用の窓口をご利用ください。issue では受け付けていません。SECURITY.md をご覧ください。

---

ライセンス

MIT — LICENSE をご覧ください。ライセンスの対象は、このリポジトリの内容（ドキュメント、メタデータ、サンプル）です。サーバー自体は Spytrend プラットフォームの一部です。