在 Dify 里用 okdata：MCP 服务或 Swagger API 工具

配好之后，团队里的 Dify 应用就能拿到实时社媒数据。举个我们常用的：给内容组做一个“选题助手”。有人输入“B站和抖音今天什么在火？给咖啡品牌出三个短视频选题”，Agent 读两个平台的热榜，再看几条相关视频，最后给出选题和链接。Dify 有两种接法：MCP 服务更快，Agent 能用到全部接口；Swagger API 工具适合固定流程，只挑你需要的接口。

准备

Dify 云版，或者足够新的自部署 Dify（1.9 及以上，MCP 服务才能加自定义请求头）。
一个 okdata 的 key，以 okd_ 开头。新 key 自带 $0.10 额度。怎么拿 key 见快速开始。

其他接入页都建议把 key 放在环境变量 OKDATA_API_KEY 里。在 Dify 里则是直接填进工具设置，跟着工作空间保存。工作空间里能运行这些应用的人，花的都是你的余额，所以最好给这个工作空间单独用一个 key。

方式一：添加 MCP 服务

进入 Integrations > Tools，打开 MCP 标签页。
添加一个 HTTP 方式的 MCP 服务：
- Server URL：https://api.okdata.online/mcp
- Name 填 okdata，Server Identifier 也可以填 okdata。应用是靠这个标识找到服务的，定下来就别再改。
在高级选项里加一个自定义请求头：名称 Authorization，值 Bearer okd_...（换成完整的 key）。
保存。Dify 会连上服务并导入四个工具：find、describe、call、account。

然后打开你的 Agent 应用（或工作流里的 Agent 节点），加上 okdata 的工具，在指令里写明预算，比如“每个问题最多发起三次收费调用”。

方式二：用 OpenAPI 文件建 Swagger API 工具

适合每次都调同一个接口的工作流，比如每天早上取一次热榜。

进入 Integrations > Tools，打开 Swagger API 标签页，新建一个自定义工具。
从网址 https://okdata.online/openapi.json 导入 schema，Dify 会把每个操作列成一个工具。
鉴权方式选 API Key，位置选 Header，类型选 Bearer，键名填 Authorization，值填你的 key。选了 Bearer 之后 Dify 会自动加上 Bearer 前缀，所以这里只粘贴 okd_...。
保存后，只把需要的操作加进应用或工作流，比如 bilibili_trends_list 和 douyin_trends_list。

第一句可以这样说

B站热门榜和抖音热搜现在都有什么？给一个咖啡品牌出三个短视频选题，
每个选题对应一个正在热的话题，附上链接。最后告诉我这次 okdata 调用花了多少。

花多少钱

用 find、describe 查接口和价格免费，account 也免费。上面这句话要读两个热榜：B站 $0.002，抖音 $0.002，合计 {{cost:bilibili.trends.list1+douyin.trends.list1}}。如果 Agent 还去搜视频，抖音视频搜索一页 $0.02，小红书笔记搜索一页 $0.02。调用失败不扣费。

出问题时

401 unauthorized。 MCP 服务：请求头名称必须是 Authorization，值要以 Bearer 开头。Swagger 工具：类型选了 Bearer 就只填 key，别再写 Bearer，不然会重复。
402 insufficient_balance。 余额不够这次调用，没有扣费。充值后再运行，价格见定价页。
429 rate_limited。 短时间内调用太多，常见于工作流里的循环。返回里有 retry_after_seconds，等这么多秒再发下一次，不扣费。
加了 MCP 服务却没有工具。 检查地址是不是以 /mcp 结尾，你的 Dify 能不能访问 https://api.okdata.online；防火墙很严的自部署环境可能访问不了。然后刷新一下服务的工具列表。
Swagger 导入失败。 改成直接粘贴文件内容，看具体报错。还不行就用方式一。

接着看

MCP 服务说明：四个工具做什么，以及该怎么叮嘱 Agent。
抖音热搜榜：字段和价格。