# 在扣子里用 okdata：MCP 插件或 API 插件

> 在扣子开发平台把 okdata 建成插件（MCP 类型或基于已有服务），智能体和工作流就能查小红书、抖音、微博等平台的公开数据。

网页版：https://okdata.online/zh/integrations/coze/

配好之后，你在扣子里搭的智能体可以直接查社媒数据。比如给运营同事做一个“小红书选题助手”：有人问“这周小红书上‘早八妆容’点赞最高的笔记都在讲什么”，智能体去搜两页最热笔记，归纳出共同点，再附上原文链接。数据是实时取的，不是模型凭印象编的。

先说一个变化：扣子现在分成了几块。插件、低代码智能体和工作流都在**扣子开发平台**里，它是扣子编程的旧版本，可以在扣子编程首页右上角点 **回到旧版** 进入。下面的步骤都在扣子开发平台里操作。

## 准备

- 扣子（coze.cn）账号，能进入扣子开发平台。
- 一个 okdata 的 key，以 `okd_` 开头。新 key 自带 $0.10 额度。怎么拿 key 见[快速开始](/zh/docs/quickstart/)。

其他接入页都建议把 key 放在环境变量 `OKDATA_API_KEY` 里。扣子是云端平台，key 要填进插件的授权设置，由扣子保存。用这个插件的智能体，不管谁在用，花的都是你的余额；如果要把智能体发布到扣子商店、微信或飞书给外人用，先想清楚这笔账。

## 方式一：建一个 MCP 类型的插件（推荐）

只建一次，四个工具自动同步进来，智能体自己会找接口、看价格。

1. 在页面顶部选好工作空间，左侧点 **资源库**，右上角选 **+资源 > 插件**。
2. 填基础信息：插件名称填 `okdata`，**类型** 选 **MCP**，**插件 URL** 填 `https://api.okdata.online/mcp`。
3. 授权方式选 **Service > Service token / API key**：
   - **位置**：Header
   - **Parameter name**：`Authorization`
   - **Service token / API key**：`Bearer okd_...`（`Bearer`、空格、完整的 key）
4. 点 **确认**。扣子会自动同步服务里的工具：`find`、`describe`、`call`、`account`。
5. 试运行 `find`，参数 `query` 填“小红书 搜索”，能返回接口列表就说明连通了，这一步免费。再试 `account`，能看到余额就说明 key 生效。
6. 点 **发布**。发布之后，智能体和工作流里才能添加这个插件。

扣子的文档没写明 MCP 插件用哪种传输方式；okdata 的服务是 Streamable HTTP。如果第 4 步同步不到工具，改用方式二。

## 方式二：基于已有服务建 API 插件

适合只用一两个固定接口的工作流，比如每天取一次小红书搜索结果。

1. 同样在 **资源库** 里选 **+资源 > 插件**，创建方式选 **云侧插件-基于已有服务创建**。
2. **插件 URL** 填 `https://api.okdata.online`，授权方式和方式一一样：**Service > Service token / API key**，位置 Header，Parameter name 填 `Authorization`，值填 `Bearer okd_...`。
3. 在插件里新建一个工具：路径填 `/v1/xiaohongshu/notes/search`，请求方法选 GET，输入参数加一个 `query`（字符串、必填、放在 Query 里），需要的话再加 `sort`。
4. 调试一次，让扣子根据返回结果生成输出参数，然后发布。

也可以用插件页右上角的 **导入**，在 **URL 和原始数据** 里填 `https://okdata.online/openapi.json`。不过扣子文档给的示例只有 OpenAPI 3.0、Swagger 和 Postman，我们的文件是 OpenAPI 3.1，可能导入报错；就算导入成功，三十多个工具默认都是未启用、未调试的状态，要一个个打开。只用几个接口的话，手动建反而更快。

## 第一句可以这样说

把插件加进智能体后，在预览里问：

```text
这周小红书上“早八妆容”点赞最高的笔记都在讲什么？搜两页最热的，
归纳三个共同点，每点附一篇代表笔记的链接。告诉我这次花了多少钱。
```

建议在智能体的人设与回复逻辑里加一句：“调用 okdata 前先说明费用，每个问题最多两次收费调用。”

## 花多少钱

`find`、`describe`、`account` 免费，只有 `call` 收费。[小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)每页 $0.02，上面这句话搜两页，花 $0.04。微博热搜一次 $0.002，抖音热搜一次 $0.002。调用失败不扣费。智能体用到的大模型由扣子另行计量，和 okdata 的费用是两笔账。

## 出问题时

- **返回 `unauthorized`（401）。** key 没带上或格式不对。检查授权里的 Parameter name 是不是 `Authorization`，值是不是 `Bearer ` 加完整 key。如果确认无误还是 401，试试值里只填 `okd_...`，看扣子是否自己加了前缀。
- **返回 `insufficient_balance`（402）。** 余额不够这次调用，没有扣费。充值后再试，价格见[定价页](/zh/pricing/)。
- **返回 `rate_limited`（429）。** 短时间内调用太多，常见于工作流里的循环。返回里有 `retry_after_seconds`，等这么多秒再调用，不扣费。
- **插件里没有工具，或者智能体里找不到插件。** MCP 插件确认地址以 `/mcp` 结尾，且用的是 https 域名；插件要先**发布**，智能体和工作流里才看得到。

国际版 Coze（coze.com）的导入和“Register for existing services”流程和国内版基本一样，但它的文档里还没有 MCP 类型插件的说明，所以在国际版上请用方式二。

## 接着看

- [MCP 服务说明](/zh/mcp/)：四个工具做什么，以及该怎么叮嘱智能体。
- [小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/)：参数、字段和价格。