adextract

Adextract MCP サーバー

Adextract は、AI アシスタントに広告インテリジェンスを提供する MCP（Model Context Protocol）サーバーです。Meta（Facebook と Instagram）、Google Ads、LinkedIn、TikTok の広告ライブラリを検索し、ad_reader で広告クリエイティブを分析します。

ホスト型エンドポイント： https://mcp.adextract.co/mcp 無料枠： 無料検索 50 回。adextract.co で API キーを取得してください。

⭐ Adextract が役に立ったら、このリポジトリにスターを付けてください。他の AI 開発者が見つけやすくなります。

---

デモを見る

• YouTube でもご覧いただけます。*

---

仕組み

1 つの MCP サーバー、1 つの API キー、4 つの広告ライブラリ。AI アシスタントは MCP でやり取りし、Adextract が検索と分析を行います。

---

クイックスタート

1. adextract.co で無料の API キーを取得します（アカウント → API キー）。
2. 以下の設定を使用して、Cursor にサーバーを追加します。
3. AI に次のように尋ねます。「米国で配信中の Nike の Facebook 広告を見せて」。

ローカルにインストールするものはありません。Adextract はホスト型 MCP サーバーとして動作するため、MCP 対応クライアントであればどれでも利用できます。

---

ユースケース

• 競合広告インテリジェンス - Meta、Google、LinkedIn、TikTok で競合他社が出稿している広告を確認できます。
• クリエイティブ分析 - ad_reader が、あらゆる広告クリエイティブを形式、オーディエンス、感情、アーキタイプに分解します。
• ブランドモニタリング - 4 つの広告ライブラリで、あらゆるブランドやドメインの広告を追跡できます。
• チャネル戦略 - 組み込みの MCP プロンプトが広告データをチャネルプランに変換します。

---

インストール

ホスト型 MCP（推奨）

Adextract のホスト型サーバーに接続します。

https://mcp.adextract.co/mcp

adextract.co で API キーを取得してください（アカウント → API キー）。

Cursor

~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "ad-extract": {
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "ad-extract": {
      "type": "http",
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Web（OAuth）

1. Claude を開き、Settings → Connectors → Add custom connector に進みます。
2. 名前：ad-extract
3. URL：https://mcp.adextract.co/mcp
4. プロンプトが表示されたらサインインして承認します（URL に API キーは含めません）。

Claude Desktop（mcp-remote）

{
  "mcpServers": {
    "ad-extract": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.adextract.co/mcp",
        "--header",
        "Authorization: Bearer ***"
      ]
    }
  }
}

その他のクライアントと設定ファイルのパス：docs/CLIENT_SETUP.md

---

利用可能なツール

ツール	プラットフォーム	説明
search_meta_ads	Meta	Facebook と Instagram の広告を検索
search_meta_pages	Meta	ページとロケーション ID を検索
get_meta_page_info	Meta	ページの透明性情報とメタデータ
get_meta_ad_details	Meta	EU／英国の広告透明性情報
search_google_ads	Google	Google Ads Transparency Center
search_google_ads_advertisers	Google	広告主とドメインを検索
get_google_ad_details	Google	クリエイティブの詳細
get_google_ads_advertiser_info	Google	検索広告から広告主プロフィールを取得
search_linkedin_ads	LinkedIn	LinkedIn Ad Library
search_tiktok_ads	TikTok	TikTok Ads Library
search_tiktok_advertisers	TikTok	TikTok の広告主を検索
get_tiktok_ad_details	TikTok	ターゲティングとクリエイティブの詳細
ad_reader	すべて	画像／動画クリエイティブを分析（形式、オーディエンス、感情、アーキタイプ）

全リファレンス：docs/TOOLS.md

---

プロンプトとリソース

よくあるワークフロー向けの組み込み MCP プロンプト：

• adextract_top_ads_for_brand
• adextract_competitor_benchmark
• adextract_channel_strategy
• adextract_analyze_ad_url
• adextract_schedule_watchlist

リソースには、エージェントのスキル説明とプロンプトパックの参照先（adextract://skill/main など）が含まれます。

---

認証

方法	適した用途
OAuth 2.0	Claude Web および OAuth 対応コネクター
Bearer API key	Cursor、VS Code、Claude Desktop、mcp-remote

ディスカバリーエンドポイント：

• https://mcp.adextract.co/.well-known/oauth-protected-resource
• https://mcp.adextract.co/.well-known/oauth-authorization-server/oauth

サーバーカード（レジストリ／クライアントのディスカバリー）：

• https://mcp.adextract.co/.well-known/mcp.json

---

プロンプトの例

Show me the latest Nike ads on Facebook in the US.
→ search_meta_ads({ q: "nike", country: "US", active_status: "active" })

Find Google ads for tesla.com from the last 30 days.
→ search_google_ads({ domain: "tesla.com", time_period: "last_30_days" })

Analyze this ad creative URL with ad_reader.
→ ad_reader({ url: "https://..." })

---

FAQ

Adextract とは何ですか？

Adextract は、AI アシスタントが Meta、Google Ads、LinkedIn、TikTok の公開広告ライブラリを検索し、広告クリエイティブを分析できるホスト型 MCP サーバーです。Claude、Cursor、VS Code、および MCP 対応のあらゆるクライアントで利用できます。

対応している広告ライブラリはどれですか？

Meta Ad Library（Facebook および Instagram）、Google Ads Transparency Center、LinkedIn Ad Library、TikTok Ads Library です。

API キーを取得するにはどうすればよいですか？

adextract.co に登録し、アカウント → API keys に移動してください。キーは作成時に一度だけ表示されます。

無料プランはありますか？

はい。新規アカウントでは、50 回まで無料で検索できます。有料プランは adextract.co でご利用いただけます。

ad_reader は何をしますか？

公開されている画像または動画の広告クリエイティブを分析し、形式、ターゲット層、感情（Plutchik/VAD）、アーキタイプ、業界／ブランドを含む構造化 JSON を返します。

ローカルでコードを実行する必要はありますか？

いいえ。Adextract はホスト型サーバーです。クライアントに設定項目を追加するだけで利用できます。

API キーの代わりに OAuth を使用できますか？

はい。Claude Web やその他の OAuth 対応コネクターでは、URL に API キーを含めずに直接サインインできます。その他のクライアントでは Bearer API キーを使用します。

広告ライブラリに直接クエリする場合と何が違いますか？

広告プラットフォームごとに、ライブラリ、API、アクセスルールが異なります。Adextract では、プラットフォーム固有のコードを書くことなく、4 つすべてに共通する MCP インターフェースとクリエイティブ分析を利用できます。

---

ドキュメント

ドキュメント	目的
docs/CLIENT_SETUP.md	クライアントごとの設定
docs/TOOLS.md	ツール、プロンプト、リソース
docs/TROUBLESHOOTING.md	よくあるエラーと解決方法
REGISTRY_CHECKLIST.md	提出前チェックリスト
SECURITY.md	セキュリティポリシー
SUPPORT.md	サポートの利用方法

---

リンク

• ウェブサイト： adextract.co
• MCP エンドポイント： https://mcp.adextract.co/mcp
• リポジトリ： github.com/ad-vertly/adextract-mcp-server

---

コミュニティ

     

_{広告インテリジェンスのヒント、MCP の最新情報、競合他社が出稿している広告について知るには、ぜひフォローしてください。}

---

_{❤️ を込めてAdextractが開発しました}