在 Claude Code 里用 okdata：通过 MCP 拿社媒数据

配好之后，Claude Code 在你的项目目录里干活时，可以顺手去小红书、抖音、X、YouTube 等平台取公开数据。比如周一例会要一张本周小红书“防晒霜”笔记的表：你用一句中文交代，Claude 自己找到对应接口，先报价，再翻两页，把 notes.csv 存到目录里。整个过程不用写一行接口代码。

准备

装好 Claude Code，终端里输入 claude 能进入会话。
一个 okdata 的 key，以 okd_ 开头。新 key 自带 $0.10 额度，够试几次搜索。怎么拿 key 见快速开始。
把 key 放进环境变量 OKDATA_API_KEY，这样它不会出现在配置文件和聊天记录里。Mac 上把下面这行加到 ~/.zshrc（Linux 是 ~/.bashrc），然后新开一个终端：

export OKDATA_API_KEY="okd_..."

添加服务

两种方式选一种就行，效果一样：都会向 https://api.okdata.online/mcp 带上请求头 Authorization: Bearer <key>。

只给自己用，所有项目都能用。 执行一次：

claude mcp add --transport http --scope user okdata https://api.okdata.online/mcp \
  --header 'Authorization: Bearer ${OKDATA_API_KEY}'

注意要用单引号。单引号能挡住 shell，不让它把 key 的真实值写进 Claude Code 的配置文件；配置里只留变量名，Claude Code 每次启动时再去读。

团队共用一个项目。 在项目根目录放一个 .mcp.json：

{
  "mcpServers": {
    "okdata": {
      "type": "http",
      "url": "https://api.okdata.online/mcp",
      "headers": { "Authorization": "Bearer ${OKDATA_API_KEY}" }
    }
  }
}

这个文件里没有密钥，可以提交进仓库，每个人在自己电脑上设好 OKDATA_API_KEY 即可。第一次在这个项目里打开 Claude Code，它会问要不要启用 .mcp.json 里的服务，选同意。

确认连上了

终端里运行 claude mcp list，okdata 那一行应该显示 Connected。在会话里输入 /mcp，能看到这个服务和它的四个工具：find、describe、call、account。

再对 Claude 说一句：“用 okdata 的 account 工具查一下我的余额。”能报出余额，就说明 key 已经送到了。这一步不花钱。

第一句可以这样说

用 okdata 找到小红书笔记搜索接口，先告诉我单价。
然后搜“防晒霜 推荐”，按最新排序，最多两页，
把每篇笔记的标题、作者、点赞数和链接存到 notes.csv，最后告诉我花了多少。

Claude 一般会依次调用 find、describe，再调用两次 call。每一步你都看得到，也可以逐个批准。

花多少钱

find、describe、account 都免费，只有 call 收费，价格就是 describe 报出来的那个。小红书笔记搜索每页 $0.02，一页约 20 篇，上面这句话最多花 $0.04。抖音热搜榜一次 $0.002。调用失败不扣费。

智能体做事容易“多翻几页更保险”。开工前先给它划个线：“先说要花多少钱，最多翻三页。”

出问题时

返回 unauthorized（401）。 key 没送到服务端。因为工具列表和 find 不需要 key，服务看起来一切正常，直到第一次 call 才报错。在你启动 Claude 的那个终端里运行 [ -n "$OKDATA_API_KEY" ] && echo 已设置 || echo 没有设置，把变量设好后重启 Claude Code。
返回 insufficient_balance（402）。 余额不够这次调用，没有扣费。用 account 看一下余额，充值后再试。价格见定价页。
返回 rate_limited（429）。 短时间内调用太密。错误里有 retry_after_seconds，等这么多秒再发同一个调用就行，这次不扣费。
看不到工具，或者显示 Failed to connect。 检查地址是不是以 /mcp 结尾，网络或代理能不能访问 https://api.okdata.online。用浏览器直接打开这个地址会看到 “Method not allowed”，这是正常的，它只接受 MCP 请求。如果当初 claude mcp add 用的是双引号，key 已经被写进配置文件了：先运行 claude mcp remove okdata --scope user，再用单引号重新添加。

接着看

MCP 服务说明：每个工具做什么，以及该怎么叮嘱智能体。
小红书笔记搜索：参数、返回字段和价格。