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

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

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

准备

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

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

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

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

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

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

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

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

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

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

第一句可以这样说

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

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

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

花多少钱

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

出问题时

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

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

接着看

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