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 → 点击开发者（齿轮）图标 → 生成密钥。确保钱包余额充足——每次成功分析收费 $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”
   • “给这段广告文案打分：本周末所有鞋款五折优惠——立即选购。”

工具

analyze_advert — 提供以下参数中的一个：

参数	含义
url	图片或视频广告的公开 URL（我们会下载）
file_path	要上传的本地图片/视频文件
text	要分析的广告文案
brand_url (可选)	广告主网站——有助于改进品牌/标志检测

返回 AI 分析文本、收费金额和剩余余额。

工作原理（异步——因此支持视频）

服务将任务提交到 POST /developer/ai-analysis/jobs，立即获取 job_id，随后每隔几秒轮询一次 GET /developer/ai-analysis/jobs/{job_id}，直到任务状态变为 complete 或 failed。这就是视频可用的原因：单次同步请求会因 CDN 边缘超时（约 100 秒）而中断，但视频分析可能需要几分钟。仅在任务成功完成时收费一次——任务失败不会收费。

注意事项

• 已在官方 MCP Registry 中注册，名称为 ai.adtest/adtest-mcp。

• 使用 x-api-key 标头进行身份验证，其值由 ADTEST_API_KEY 设置。

• 端点默认为 https://app.adtest.ai/adtest-api；可通过 ADTEST_API_BASE 覆盖，以用于预发布环境。

• 轮询时限默认为 15 分钟；处理超长视频时，可通过 ADTEST_POLL_TIMEOUT_MS（毫秒）进行调整。

• 速率限制：每个密钥每分钟提交 30 次、每天提交 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
• 设置指南和常见问题：https://adtest.ai/mcp/
• 应用和 API 密钥：https://app.adtest.ai
• 问题反馈：https://github.com/menaker/adtest-mcp/issues

许可证

MIT — 参见 LICENSE。