AdRecast

AdRecast MCP 服务

AdRecast 可为你的产品重新制作经过验证的电商视频广告：它会拆解参考广告的镜头、节奏和钩子，编写供你确认的脚本，并生成包含你的产品和演员的完整多场景广告，同时检查每一帧中的产品准确性。

端点

• URL：https://adrecast.com/api/mcp
• 传输方式：Streamable HTTP。
• 身份验证：仅支持 API 密钥。将其作为 Bearer 令牌发送：Authorization: Bearer rk_live_...
  • 在 Settings → API keys 中创建密钥。从 read、write 和 spend 中选择权限范围。
  • 密钥只会显示一次。创建密钥时，请将其存放在安全的地方。
  • 不支持 OAuth。

功能

MCP 服务运行与 Web 应用相同的重制流程：查找模板 → 上传产品图片 → 审核脚本 → 估算费用 → 生成 → 轮询 → 导出。

工具（共 46 个），按类别分组。此 README 自行对工具进行分组；文档则按端点列出工具。

• 模板与上传：search_templates、create_upload_url
• 项目：create_project、list_projects、get_project、get_script、update_script、rewrite_script、get_rewrite、add_line、delete_line、reorder_lines、confirm_script
• 生成与导出：estimate_cost、generate_video、list_jobs、list_clips、get_job、export_video、get_export
• 角色与声音：create_character、list_characters、delete_character、update_character、clone_character_voice、keep_character_voice、list_voices、set_project_character
• 变体：list_hook_formulas、list_variant_styles、create_hook_variant、estimate_variants、create_variants、list_variants、get_variant_manifest、add_variant_product、cancel_variant_batch
• Studio：studio_quote、create_studio_generation、list_studio_generations、list_studio_assets、get_studio_generation、confirm_studio_video、discard_studio_video、save_studio_output
• 账户：get_balance

视频按场景生成，各个镜头使用相同的演员、产品和声音。视频包含字幕、旁白或歌曲以及音乐。你可以只修复一个镜头，无需重新制作整条视频。

支出安全

• 价格以积分计。100 积分 = $1。分析、脚本、分镜静帧以及视频生成前的脚本编辑均免费。
• 视频按生成时长计费。720p 为 40 积分/秒，1080p 为 50 积分/秒，2K 为 60 积分/秒。项目创建时会固定分辨率。
• generate_video 和 export_video 只有在 confirm: true 时才会扣费。否则，它们会返回费用估算（402 confirmation_required）。在设置 confirm: true 之前，请先调用 estimate_cost 并向用户展示费用估算。
• 使用 1:1 或 16:9 画面重构的 export_video 按 20 积分/秒计费。9:16 导出免费。
• 视频生成后修改镜头，每重新生成一秒需支付视频费用的 80%。
• clone_character_voice 固定消耗 1000 积分。调用时也需要设置 confirm: true。
• 创建项目前，必须先购买 $1 试用或充值；否则会返回 402 payment_required。
• 自动生成（create_project 上的 auto_generate=true）需要 spend 权限范围。
• Studio 的价格为对应重制价格的 0.8 倍。
• 失败的任务会退还冻结的积分。
• 对于 REST 调用，每个会创建资源或产生费用的 POST 请求都应发送 Idempotency-Key，这样重试就不会重复扣费。

快速开始

在 Settings → API keys 中创建 API 密钥，然后在客户端运行的 shell 中导出该密钥：

export ADRECAST_API_KEY=rk_live_...

通用 MCP 客户端

对于任何接受 url 和 headers 的客户端，请使用以下 JSON：

{
  "mcpServers": {
    "adrecast": {
      "url": "https://adrecast.com/api/mcp",
      "headers": { "Authorization": "Bearer ${ADRECAST_API_KEY}" }
    }
  }
}

Claude Code

claude mcp add --transport http adrecast https://adrecast.com/api/mcp --header "Authorization: Bearer $ADRECAST_API_KEY"

Cursor

将以下内容添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "adrecast": {
      "url": "https://adrecast.com/api/mcp",
      "headers": { "Authorization": "Bearer ${ADRECAST_API_KEY}" }
    }
  }
}

Codex

将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.adrecast]
url = "https://adrecast.com/api/mcp"
bearer_token_env_var = "ADRECAST_API_KEY"

examples/ 文件夹包含这些片段的独立文件。

示例提示词

• “查找一个车内自拍护肤类 UGC 模板，并估算为我的产品制作 1080p 版本的成本。”
• “上传这三张产品照片，从 Problem → Agitate → Solve 模板创建一个项目，并在生成任何内容之前先给我看脚本。”
• “重写脚本，让开头突出保证内容，并以 30 秒为目标，然后给我看修改后的台词。”
• “为这个项目规划三个不同版本的开场，并给我看估算结果。未经我批准，不要开始制作。”
• “查看我的余额，并告诉我这个项目导出 2K 版本是否在余额范围内。”

链接

• 网站：https://adrecast.com/en
• 定价：https://adrecast.com/en/pricing
• 模板：https://adrecast.com/en/templates
• 使用场景：https://adrecast.com/en/use-cases
• 案例（实际成品和广告参考）：https://adrecast.com/en/cases
• API 和 MCP 文档：https://adrecast.com/en/docs/api
• 联系方式：https://adrecast.com/en/contact
• 完整页面索引：https://adrecast.com/llms-full.txt

许可证

该服务由 AdRecast 托管和运营。此代码库仅包含文档和配置示例（MIT）。