adtest-mcp

AdTest.AI MCP サーバー

· レジストリ名：ai.adtest/adtest-mcp · ライセンス：MIT

Claude（Desktop、Code、または任意の MCP クライアント）に単一の analyze_advert ツールを追加し、広告（画像、動画、またはテキスト）を AdTest.AI の AI のみによる13次元分析にかけ、詳細なスコアレポートを返します。（人間のパネルによる検証はウェブアプリでのみ利用でき、このサーバーからは利用できません。）

Claude Code へのクイック追加：

claude mcp add adtest -e ADTEST_API_KEY=adk_your_key_here -- npx -y adtest-mcp

セットアップ

1. API キーを取得します： https://app.adtest.ai にサインインし、Developer（歯車）アイコン → Generate key を選択します。ウォレットに残高があることを確認してください。分析が成功するたびに $1 かかります。

2. Claude の設定にサーバーを追加します（Claude Desktop： claude_desktop_config.json；Claude Code：.mcp.json）：

   {
     "mcpServers": {
       "adtest": {
         "command": "npx",
         "args": ["-y", "adtest-mcp"],
         "env": { "ADTEST_API_KEY": "adk_your_key_here" }
       }
     }
   }
   

   または、ローカルのチェックアウトから実行します（このフォルダーで npm install を実行した後）：

   {
     "mcpServers": {
       "adtest": {
         "command": "node",
         "args": ["/absolute/path/to/mcp-server/index.js"],
         "env": { "ADTEST_API_KEY": "adk_your_key_here" }
       }
     }
   }
   

3. Claude を再起動し、次のように依頼します：

   • 「この広告を分析してください：https://example.com/ad.jpg」
   • 「この広告動画ファイルを分析してください：/Users/me/promo.mp4」
   • 「この広告コピーを採点してください：今週末はすべての靴が50％オフ — 今すぐお買い求めください。」

ツール

analyze_advert — 次のいずれか1つを指定します：

引数	意味
url	画像または動画広告の公開 URL（ダウンロードされます）
file_path	アップロードするローカルの画像／動画ファイル
text	分析する広告コピー
brand_url (任意)	広告主のウェブサイト — ブランド／ロゴの検出精度が向上します

AI 分析テキストに加えて、請求額と残高が返されます。

仕組み（非同期 — 動画にも対応）

サーバーは POST /developer/ai-analysis/jobs にジョブを送信し、すぐに job_id を受け取ります。その後、complete または failed になるまで数秒ごとに GET /developer/ai-analysis/jobs/{job_id} をポーリングします。これにより動画にも対応できます。同期リクエストは CDN のエッジタイムアウト（約100秒）で中断されますが、動画の分析には数分かかる場合があります。請求はジョブの完了時、成功した場合に1回だけ発生します。失敗したジョブに請求されることはありません。

注意事項

• 公式 MCP レジストリに ai.adtest/adtest-mcp として登録されています。

• 認証には ADTEST_API_KEY から設定される x-api-key ヘッダーを使用します。

• エンドポイントの既定値は https://app.adtest.ai/adtest-api です。ステージング環境では ADTEST_API_BASE で変更できます。

• ポーリングの上限時間は既定で15分です。非常に長い動画の場合は ADTEST_POLL_TIMEOUT_MS（ミリ秒）で変更できます。

• レート制限：キーごとに送信は毎分30件、1日2000件（IPごとに毎分60件）です。ポーリングには余裕があり（毎分240件）、サーバーが処理します。

• エラーは読みやすいテキストで返されます：invalid_api_key、insufficient_funds、no_creative、invalid_url、unsupported_media_type、too_many_requests、analysis_failed（最後のエラーでは請求されません）。

• Node ≥ 18 が必要です。

リンク

• 製品：https://adtest.ai
• セットアップガイドと FAQ：https://adtest.ai/mcp/
• アプリと API キー：https://app.adtest.ai
• 課題：https://github.com/menaker/adtest-mcp/issues

ライセンス

MIT — LICENSE を参照してください。