成功才扣费
参数错误、Key 无效、余额不足或平台侧失败,这次不扣费。调用成功但一条结果都没有,仍算一次成功调用。
极媒数据 MCP 把公众号、抖音和小红书的一部分实时接口,做成智能体可以直接调用的工具。它跑在你自己的电脑上,用你在极媒创建的 API Key,请求发到 api.xmedi.cn。
它和手写 HTTP 用的是同一把 Key、同一套按次计费。差别是智能体不用先拼路径和翻页参数。什么时候该搜、什么时候该停,由 Skills 说明;MCP 负责把这一次调用发出去。
在本机安装命令行工具。包还没有发到公共索引,安装命令指向 GitHub 仓库。
pip install "xmedi-mcp @ git+https://github.com/xmedi-data/xmedi-mcp.git"
写入 MCP 配置。把 xm_live_... 换成控制台里创建的 Key。命令在本机启动,请求发往 api.xmedi.cn。
{
"mcpServers": {
"xmedi": {
"command": "xmedi-mcp",
"env": {
"XMEDI_API_KEY": "xm_live_..."
}
}
}
}打开 claude_desktop_config.json,在 mcpServers 里写入同一段配置,然后重启。可选环境变量 XMEDI_BASE_URL,默认是 https://api.xmedi.cn/api/v1。
{
"mcpServers": {
"xmedi": {
"command": "xmedi-mcp",
"env": {
"XMEDI_API_KEY": "xm_live_..."
}
}
}
}同一把 Key,同一套价格。MCP 不会另外加价,也不会在失败时偷偷重试。
参数错误、Key 无效、余额不足或平台侧失败,这次不扣费。调用成功但一条结果都没有,仍算一次成功调用。
搜索、作品列表和评论的每一页都是一次独立费用。用户没说要下一页,就停在第一页。
响应 _meta.cost_fen 是本次扣了多少分,_meta.balance_fen 是扣完后的余额。100 分等于 1 元。查余额本身不扣费。
ok 为 false 时不要改调另一个工具重试。余额不足请到官网充值后再继续。
第一版 12 个工具。字段说明在接口文档。下面按三个技能分组,并写明这一次调用适合什么。
| 工具 | 什么时候用 | 翻页 | 文档 |
|---|---|---|---|
account_balance | 想知道钱包还剩多少分时先查余额,这次调用不扣费。 | 不翻页,不扣费 | account.balance |
| 工具 | 什么时候用 | 翻页 | 文档 |
|---|---|---|---|
wechat_search_articles | 按关键词找公众号文章,可限一天、七天或半年。 | 回传 next_cursor | wechat.search.articles |
douyin_search_videos | 按关键词找抖音视频,可限一天、一周或半年。结果不含互动数。 | 回传 next_cursor | douyin.search.videos |
xhs_search_notes | 按关键词找小红书笔记。结果不含点赞和评论数。 | 回传 next_cursor | xhs.notes.search |
douyin_video_detail | 已经有一条抖音链接或作品 ID,只要这一条的标题和互动数。 | 不翻页 | douyin.videos.detail |
xhs_note_detail | 已经有一篇笔记链接或笔记 ID,只要这一篇的标题和互动数。 | 不翻页 | xhs.notes.detail |
| 工具 | 什么时候用 | 翻页 | 文档 |
|---|---|---|---|
douyin_user_posts | 已经有抖音主页链接或 sec_user_id,拉取这个账号发布的作品。 | 回传 next_cursor | douyin.users.posts |
xhs_user_notes | 已经有小红书主页链接或用户 ID,拉取这个账号发布的笔记。 | 回传 next_cursor | xhs.users.notes |
| 工具 | 什么时候用 | 翻页 | 文档 |
|---|---|---|---|
douyin_resolve_id | 手里是 v.douyin.com 短链或整段分享文案,评论接口还不能直接用。 | 不翻页 | douyin.ids.resolve |
douyin_video_comments | 已经有抖音作品 ID 或 www.douyin.com 长链,要这一条视频的一级评论。 | 回传 next_cursor | douyin.videos.comments |
xhs_resolve_id | 分享短链还认不出笔记 ID 时,先解析再决定要不要拉评论。 | 不翻页 | xhs.ids.resolve |
xhs_note_comments | 已经有笔记 ID、长链或分享文案,要这一篇笔记的一级评论。 | 回传 next_cursor | xhs.notes.comments |
怎么选择工具、何时停止翻页,写在 Skills。源码仓库:xmedi-data/xmedi-mcp
先装好 MCP,并放入内容搜索技能。下面这句只搜一页,并要求回报本次费用。
搜最近一天「品牌名」的公众号文章,按最新排序,只要第一页。把标题、来源和链接列出来,并告诉我这一次扣了多少分。
放在 Cursor 或 Claude Desktop 的 MCP 配置环境变量 XMEDI_API_KEY 里。请求头是 X-XMEDI-Key。不要把 Key 写进技能文件、聊天记录或公开仓库。
每一页都按次计费。智能体若看到 has_more 就自动翻完,一次对话会连扣多次。默认只取第一页,需要更多时由你明确说出页数。
抖音视频详情可以直接收短链。抖音评论不行,要先解析成作品 ID。小红书详情和评论可以收分享文案。解析或查询失败就停,不要改用关键词再搜。
先安装 MCP,智能体才真的能发请求。再放入对应的 Skill,它才知道该选哪个工具、如何翻页、余额不足时停止。只装其中一个,要么不会调,要么容易调错。
账号、价格和返回字段相同,文档仍以接口页为准。MCP 少写一层 HTTP 胶水,适合已经在 Cursor 或 Claude Desktop 里工作的人。批量入库、自建服务仍建议直接调 API。
第一版只有本机命令。Cursor 和 Claude Desktop 都是启动同一个 xmedi-mcp。没有单独的远程接入地址。
说明您需要的平台、数据量和使用场景,我们会在 1 个工作日内联系您,推荐合适的接口与报价。