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

> 一条命令把 okdata 的 MCP 服务加进 Claude Code，之后让 Claude 直接拉 10 个平台的笔记、评论和热榜，顺手存成文件。

网页版：https://okdata.online/zh/integrations/claude-code/

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

## 准备

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

```bash
export OKDATA_API_KEY="okd_..."
```

## 添加服务

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

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

```bash
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`：

```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 已经送到了。这一步不花钱。

## 第一句可以这样说

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

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

## 花多少钱

`find`、`describe`、`account` 都免费，只有 `call` 收费，价格就是 `describe` 报出来的那个。[小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)每页 $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` 看一下余额，充值后再试。价格见[定价页](/zh/pricing/)。
- **返回 `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 服务说明](/zh/mcp/)：每个工具做什么，以及该怎么叮嘱智能体。
- [小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)：参数、返回字段和价格。