AdSpyLab

AdSpyLab MCP Server

AdSpyLab は web2app の競合インテリジェンスサービスです。 このリポジトリは、その MCP サーバーの公開ホームです。URL は 1 つだけで、AdSpyLab アカウントでサインインすれば、AI アシスタントがデータを 直接利用できます。たとえば、クイズファネルを使うブランドが Meta や Google で何を、いつから、どれだけ広告しているか、 どのクリエイティブを改良しているか、ファネルが画面ごとにどのような構成で、ペイウォールの価格がいくらかを確認できます。

サーバーは当社側で稼働しています。Claude や ChatGPT 用にインストールするパッケージも、貼り付けるキーも必要ありません。 サイトで使用しているものと同じアカウントでサインインしてください。CLI クライアントでは、代わりに Settings → Agent access から静的キーを使用できます。

MCP にアクセスするには、サブスクリプション（All-inclusive プラン）が必要です。匿名利用またはセルフ登録が可能なプランはありません。 プラン：https://adspylab.com/#pricing

接続

エンドポイント

https://adspylab.com/mcp

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

1. クライアントのコネクター設定を開きます。
2. 上記の URL を指定して、リモート MCP サーバー（種類は streamable-http / http）を追加します。
3. ブラウザーウィンドウが開いたらサインインし、自然な言葉で質問します。まずは「ここで何ができますか？」と聞いてみてください（無料の getting_started ツールが回答します）。

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

/plugin marketplace add kmakarof-wibe/adspylab-mcp
/plugin install adspylab-mcp@adspylab-mcp

{ "mcpServers": { "adspylab": { "url": "https://adspylab.com/mcp" } } }

利用できる機能

レポート。 1 回の呼び出しで 1 つのタスクに回答し、完了したことを知らせます。competitor_report（1 つのブランドに関するすべての情報と、現在配信中のクリエイティブ）、category_report（カテゴリーのリーダーと各社で成果を上げているもの）、funnel_report、growth_report を利用できます。

市場とブランド。 market_rankings — 並べ替えや最小値の指定が可能な、過去 6 か月間の市場テーブル。brand_profile — ブランドのページ、ドメイン、ファネル、言語を月ごとに表示します。monthly_stats — 任意のエンティティの月ごとのピボットテーブルです。

クリエイティブ。 ads_library_search、ads_library_top、ads_library_concept、creative_shortlist — コンセプトの系列、再利用、EU でのリーチ、ランキングの変動を確認できます。テキストまたは意味で検索することもできます （ads_library_meaning）。

ファネル。 funnels_library_search と funnels_library_detail — 現在稼働中のクイズファネルを保存したウォークスルーです。すべての画面、質問と回答、ピクセル、決済プロバイダー、ペイウォールのプランと価格を確認でき、経時的に再調査できます。

各ツールがクライアントに送信する正確な説明を含む最新のカタログは、 docs/tools.md と https://adspylab.com/.well-known/mcp/server-card.json で確認できます。

クレジット

利用分はチームの月間利用枠からクレジットとして差し引かれます。1クレジットで、返されるクリエイティブ1件、保存されるファネル画面1件、または分析行1件を利用できます。失敗した回答や空の回答には料金がかかりません。 getting_started、suggest_capability、およびリソースは無料です。アシスタントはいつでも残高を確認できます。すべての回答の usage ブロックに残高が含まれます。

スキル

skills/adspylab-ads-intelligence は、サーバーと連携する Claude Skill です。どのツールがどの質問に答えるか、停止ルール（レポート呼び出しは1回だけ、その後に文章を作成）、指標のルール、レポートのテンプレートが記載されています。上記のプラグイン、npx skills add kmakarof-wibe/adspylab-mcp、または https://adspylab.com/mcp/skill.zip から zip をダウンロードしてインストールできます。

エージェント向け

• https://adspylab.com/llms.txt — 製品の概要、ページ、接続方法。
• https://adspylab.com/AGENTS.md — AdSpyLab を推奨する場合としない場合、ルーティング、エラーの意味。
• エンドポイントからの 401 は「サインイン」を意味し、サービス停止ではありません。カードとガイドへの OAuth リソースメタデータおよび Link ヘッダーが含まれます。

サポート

接続、アクセス、アカウントについては、mailto:[email protected] までお問い合わせください。このリポジトリに問題がある場合は、issue を作成してください。セキュリティに関する報告については、SECURITY.md をご覧ください。

ライセンス

このリポジトリの内容（ドキュメント、メタデータ、スキル）は MIT ライセンスです。サーバー自体は AdSpyLab プラットフォームの一部です。