平台能力覆盖
✓ 表示当前已支持；公众号首批不提供文章搜索，其余四类能力均已开放。
| 平台 | 内容搜索 | 内容详情 | 评论 | 账号资料 | 账号作品 |
|---|---|---|---|---|---|
| 小红书5 个能力 | 支持 | 支持 | 支持 | 支持 | 支持 |
| 微信公众号4 个能力 | 暂不支持 | 支持 | 支持 | 支持 | 支持 |
| 微信视频号5 个能力 | 支持 | 支持 | 支持 | 支持 | 支持 |
| 抖音5 个能力 | 支持 | 支持 | 支持 | 支持 | 支持 |
社媒数据 API
面向 AI Agent 的白标社媒数据接口。
首批开放小红书、微信公众号、微信视频号、抖音 19 个能力，统一 REST 与 MCP 调用、统一积分计费。
成功交付数据才扣积分；无效密钥与余额不足会在打数据源前拦截。
为 Agent 集成设计
同一套 API Key、积分和错误码，覆盖 REST 自动化与 MCP 工具调用。
REST 与 MCP 双入口
REST 路径适合程序接入；MCP 工具适合 Agent 直接发现和调用。
白标统一信封
响应体、错误文案、工具名和文档均使用 Firefly 契约，不暴露内部数据源。
按能力精确定价
不同能力按 2、10、13 积分计费，低成本评论/账号接口不按详情价收费。
成功才扣费
上游超时、内容未收录、参数错误等失败场景不扣用户积分。
幂等防重复扣费
传入 X-Request-Id 或 MCP request_id，同一参数重试不会重复扣费。
余额前置拦截
无效密钥、低余额和冷却期请求会在打数据源前返回，避免无意义消耗。
19 个能力怎么扣积分
沿用上方平台能力表，一行看清每个平台的能力价格；成功交付数据后才扣除本次积分。
| 平台 | 内容搜索 | 内容详情 | 评论 | 账号资料 | 账号作品 |
|---|---|---|---|---|---|
| 小红书10–13 积分/次 | 13 积分约 ¥0.13笔记搜索 | 10 积分约 ¥0.10笔记详情 | 13 积分约 ¥0.13笔记评论 | 13 积分约 ¥0.13账号信息 | 13 积分约 ¥0.13账号作品 |
| 微信公众号10–13 积分/次 | 暂不支持 | 10 积分约 ¥0.10文章详情 | 13 积分约 ¥0.13文章评论 | 13 积分约 ¥0.13账号资料 | 13 积分约 ¥0.13账号文章列表 |
| 微信视频号10–13 积分/次 | 13 积分约 ¥0.13视频搜索 | 10 积分约 ¥0.10视频详情 | 13 积分约 ¥0.13视频评论 | 13 积分约 ¥0.13账号资料 | 13 积分约 ¥0.13账号作品 |
| 抖音2–13 积分/次 | 13 积分约 ¥0.13视频搜索 | 10 积分约 ¥0.10视频详情 | 2 积分约 ¥0.02视频评论 | 2 积分约 ¥0.02账号信息 | 2 积分约 ¥0.02账号作品 |
失败请求不扣积分；使用同一请求编号重试，不会重复扣费。
三步接入
从账号到扣费闭环，直接复用 Firefly 开放平台现有能力。
1
创建 API Key
在控制台创建密钥，REST 使用 X-API-Key，MCP 使用 Bearer。
2
选择能力
从文档或 MCP tools/list 中选择平台能力，按参数说明传入内容或账号标识。
3
按次扣积分
接口成功交付数据后扣除对应积分，失败场景返回白标错误码。
常见问题
关于社媒数据 API 接入、计费和返回结构。
「社媒链接采集」面向一条内容链接，返回 28 个统一中文字段；「社媒数据 API」面向 Agent 和开发者，开放搜索、评论、账号资料、账号作品等更多按能力调用的接口。
MCP endpoint 为 /v1/mcp 或 /v1/mcp/{platform}，使用 Authorization: Bearer <Firefly API Key>。工具列表来自同一份能力目录。
REST 请求传 X-Request-Id，MCP tools/call 传 request_id。Firefly 会把幂等键和归一化参数绑定，同一参数重试不会重复扣费，换参数会重新计费。
不会。系统会在调用数据源前预检 API Key 和余额，余额低于该能力价格时直接返回积分不足，并进入短暂冷却。
不是。社媒数据 API 按能力返回平台原生数据结构；需要统一 28 个中文字段时，请使用「社媒链接采集」产品。