Remote MCP Server
在 Claude 里直接使用 AI 视频分析
i琢片提供远程 MCP 入口。你可以继续在网页端使用,也可以把同一套视频分析能力接入 Claude 兼容客户端,用 API Key 提交任务、查询摘要、关键词和字幕状态。
Claude Code 配置
claude mcp add --transport http ai-douyin https://top9.cc/api/mcp \
--header "Authorization: Bearer $AI_DOUYIN_API_KEY"也可以使用 X-API-Key 请求头;正式线上 endpoint 是 https://top9.cc/api/mcp。其中 ai-douyin 只是 MCP 服务标识,与产品名「i琢片」对应同一个服务。
在浏览器中使用 WebMCP
登录网站后,支持 WebMCP 的浏览器代理可以直接调用视频分析、结果查询和个人历史工具,复用当前网页登录态,无需额外填写 API Key。提交分析仍按网站规则消耗积分,且需要完成邮箱验证。
正在检查 WebMCP 状态…
- 在支持该实验功能的 Chrome 中打开
chrome://flags/#enable-webmcp-testing,设为 Enabled 并重启。 - 通过 HTTPS 或 localhost 打开网站并登录,确认左侧显示「WebMCP 已就绪」。
- 在支持 WebMCP 的浏览器代理中输入「帮我分析这个视频」,附上视频链接;提交后页面会显示任务入口。
需要保持网页打开。WebMCP 仍为实验性能力,浏览器启用 API 后,还需要支持工具调用的代理或调试器。
WebMCP 官方说明接入步骤
V1 使用现有 API Key 认证,不需要本地部署,也不需要 OAuth 授权流程。
- 1登录 i琢片账号并完成邮箱验证。
- 2进入 API 密钥页面,创建或复制一个 active 状态的 API Key。
- 3在 Claude Code 或兼容 MCP 客户端中添加远程 HTTP MCP Server。
- 4在 Claude 中粘贴视频链接,让它调用 analyze_video 并继续查询结果。
可用工具
analyze_video
提交抖音、小红书、B站或 X/Twitter 视频链接、分享文本,创建 AI 分析任务。
get_analysis_result
通过 analysis_id 或 task_id 查询结果;任务处理中时用于轮询。
list_my_analyses
列出当前 API Key 所属账号最近提交的视频分析任务。
请求与认证
MCP Server 接受 Bearer token,也兼容现有 API Key 请求头。所有分析任务都会复用网页端的余额、扣费和任务历史。
Header
Authorization: Bearer <AI_DOUYIN_API_KEY>
# or
X-API-Key: <AI_DOUYIN_API_KEY>常见状态
401API Key 缺失、无效、已撤销或已过期。请重新复制 active API Key。
402账号余额不足。请回到网页端充值后重试。
pending视频仍在处理中。等待 5-10 秒后再次调用 get_analysis_result。
常见问题
- 使用 i琢片 MCP Server 需要在本地部署服务吗?
- 不需要。i琢片提供的是远程 HTTP MCP Server,地址为 https://top9.cc/api/mcp,在 Claude Code 或兼容 MCP 客户端里添加该地址并带上 API Key 即可使用,无需本地部署,V1 也不需要 OAuth 授权流程。
- MCP Server 支持哪些平台的视频?
- 支持抖音、小红书、B站以及 X/Twitter 的视频链接或分享文本,提交后会创建 AI 分析任务并返回摘要、关键词和字幕状态。
- 通过 MCP 提交的分析任务会和网页端的记录分开吗?
- 不会。MCP 提交的任务复用网页端同一账号的余额、扣费和任务历史,可以在网页端继续查看或追问。
- 调用 analyze_video 之后要等多久才能拿到结果?
- 任务通常在几十秒内完成。返回 pending 说明视频仍在处理中,建议间隔 5-10 秒再次调用 get_analysis_result 轮询,直到状态变为 completed 或 failed。