欢迎访问极媒数据 · 新媒体数据服务平台登录免费注册控制台
MCP

把极媒数据接到智能体

MCP 是本机上的调用层。智能体用你自己的 API Key 查询余额、搜索内容和拉取评论,成功才扣费。

这是什么

极媒数据 MCP 把公众号、抖音和小红书的一部分实时接口,做成智能体可以直接调用的工具。它跑在你自己的电脑上,用你在极媒创建的 API Key,请求发到 api.xmedi.cn。

它和手写 HTTP 用的是同一把 Key、同一套按次计费。差别是智能体不用先拼路径和翻页参数。什么时候该搜、什么时候该停,由 Skills 说明;MCP 负责把这一次调用发出去。

  1. 在极媒注册,进入控制台创建 API Key。Key 只放在本机配置里,不要写进仓库或发给别人。
  2. 在本机安装 xmedi-mcp。当前从 GitHub 安装,包还没有发到公共索引。
  3. 把下面的命令写进 Cursor 或 Claude Desktop,把 xm_live_... 换成自己的 Key,然后重启客户端。

安装

在本机安装命令行工具。包还没有发到公共索引,安装命令指向 GitHub 仓库。

pip install "xmedi-mcp @ git+https://github.com/xmedi-data/xmedi-mcp.git"

Cursor

写入 MCP 配置。把 xm_live_... 换成控制台里创建的 Key。命令在本机启动,请求发往 api.xmedi.cn。

{
  "mcpServers": {
    "xmedi": {
      "command": "xmedi-mcp",
      "env": {
        "XMEDI_API_KEY": "xm_live_..."
      }
    }
  }
}

Claude Desktop

打开 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_..."
      }
    }
  }
}

和直接调 API 怎么计费

同一把 Key,同一套价格。MCP 不会另外加价,也不会在失败时偷偷重试。

成功才扣费

参数错误、Key 无效、余额不足或平台侧失败,这次不扣费。调用成功但一条结果都没有,仍算一次成功调用。

一页一次

搜索、作品列表和评论的每一页都是一次独立费用。用户没说要下一页,就停在第一页。

费用写在结果里

响应 _meta.cost_fen 是本次扣了多少分,_meta.balance_fen 是扣完后的余额。100 分等于 1 元。查余额本身不扣费。

失败就停

ok 为 false 时不要改调另一个工具重试。余额不足请到官网充值后再继续。

工具

第一版 12 个工具。字段说明在接口文档。下面按三个技能分组,并写明这一次调用适合什么。

共用

工具什么时候用翻页文档
account_balance想知道钱包还剩多少分时先查余额,这次调用不扣费。不翻页,不扣费account.balance

内容搜索

工具什么时候用翻页文档
wechat_search_articles按关键词找公众号文章,可限一天、七天或半年。回传 next_cursorwechat.search.articles
douyin_search_videos按关键词找抖音视频,可限一天、一周或半年。结果不含互动数。回传 next_cursordouyin.search.videos
xhs_search_notes按关键词找小红书笔记。结果不含点赞和评论数。回传 next_cursorxhs.notes.search
douyin_video_detail已经有一条抖音链接或作品 ID,只要这一条的标题和互动数。不翻页douyin.videos.detail
xhs_note_detail已经有一篇笔记链接或笔记 ID,只要这一篇的标题和互动数。不翻页xhs.notes.detail

账号作品

工具什么时候用翻页文档
douyin_user_posts已经有抖音主页链接或 sec_user_id,拉取这个账号发布的作品。回传 next_cursordouyin.users.posts
xhs_user_notes已经有小红书主页链接或用户 ID,拉取这个账号发布的笔记。回传 next_cursorxhs.users.notes

评论

工具什么时候用翻页文档
douyin_resolve_id手里是 v.douyin.com 短链或整段分享文案,评论接口还不能直接用。不翻页douyin.ids.resolve
douyin_video_comments已经有抖音作品 ID 或 www.douyin.com 长链,要这一条视频的一级评论。回传 next_cursordouyin.videos.comments
xhs_resolve_id分享短链还认不出笔记 ID 时,先解析再决定要不要拉评论。不翻页xhs.ids.resolve
xhs_note_comments已经有笔记 ID、长链或分享文案,要这一篇笔记的一级评论。回传 next_cursorxhs.notes.comments

怎么选择工具、何时停止翻页,写在 Skills。源码仓库:xmedi-data/xmedi-mcp

第一版的边界

  • 第一版能做:公众号文章搜索,抖音和小红书的搜索、单条详情、账号作品、一级评论,以及余额查询。
  • 第一版不做:视频号、微博、快手、B 站、海外平台、热榜、下载、二级评论、公众号历史发文和公众号文章正文。
  • 极媒交的是原始字段。标题改写、情感判断和舆情报告留给你自己的模型,不作为接口结果。

可以直接发给智能体的说法

先装好 MCP,并放入内容搜索技能。下面这句只搜一页,并要求回报本次费用。

搜最近一天「品牌名」的公众号文章,按最新排序,只要第一页。把标题、来源和链接列出来,并告诉我这一次扣了多少分。

常见问题

API Key 应该放在哪里?

放在 Cursor 或 Claude Desktop 的 MCP 配置环境变量 XMEDI_API_KEY 里。请求头是 X-XMEDI-Key。不要把 Key 写进技能文件、聊天记录或公开仓库。

为什么不要一次翻很多页?

每一页都按次计费。智能体若看到 has_more 就自动翻完,一次对话会连扣多次。默认只取第一页,需要更多时由你明确说出页数。

短链能不能直接查?

抖音视频详情可以直接收短链。抖音评论不行,要先解析成作品 ID。小红书详情和评论可以收分享文案。解析或查询失败就停,不要改用关键词再搜。

MCP 和 Skills 怎么配合?

先安装 MCP,智能体才真的能发请求。再放入对应的 Skill,它才知道该选哪个工具、如何翻页、余额不足时停止。只装其中一个,要么不会调,要么容易调错。

和直接调用 API 有什么不同?

账号、价格和返回字段相同,文档仍以接口页为准。MCP 少写一层 HTTP 胶水,适合已经在 Cursor 或 Claude Desktop 里工作的人。批量入库、自建服务仍建议直接调 API。

支持托管在极媒服务器上的远程地址吗?

第一版只有本机命令。Cursor 和 Claude Desktop 都是启动同一个 xmedi-mcp。没有单独的远程接入地址。

注册后创建 API Key

说明您需要的平台、数据量和使用场景,我们会在 1 个工作日内联系您,推荐合适的接口与报价。

在线留言

提交后我们会在 1 个工作日内与您联系