社媒数据 API
面向 AI Agent 的白标社媒数据 REST 与 MCP API。
Firefly 社媒数据 API 提供统一的 REST 与 MCP 调用入口,首批开放 20 个能力,覆盖小红书、微信公众号、微信视频号和抖音。
快速开始
curl "https://api.example.com/v1/douyin/video_comments?aweme_id=AWEME_ID" \
-H "X-API-Key: $FIREFLY_API_KEY" \
-H "X-Request-Id: demo-001"成功响应统一为 Firefly 信封:
{
"code": 0,
"msg": "success",
"request_id": "agent-request-id",
"credits_charged": 2,
"balance": 98,
"data": {}
}调用入口
- REST:
/v1/{platform}/{capability} - MCP:
/v1/mcp或/v1/mcp/{platform} - 鉴权:
X-API-Key: <Firefly API Key>或Authorization: Bearer <Firefly API Key> - 幂等: 可传
X-Request-Id或 MCP 参数request_id;同一参数重试不会重复扣费。
能力总览
| 能力 | REST 路径 | 方法 | 积分/次 | MCP 工具 |
|---|---|---|---|---|
| 笔记搜索 | /v1/xhs/note_search | GET | 13 | xhs_note_search |
| 笔记详情 | /v1/xhs/note_detail | GET | 10 | xhs_note_detail |
| 笔记评论 | /v1/xhs/note_comments | GET | 13 | xhs_note_comments |
| 账号信息 | /v1/xhs/user_info | GET | 13 | xhs_user_info |
| 账号作品 | /v1/xhs/user_notes | GET | 13 | xhs_user_notes |
| 文章详情 | /v1/wechat_mp/article_detail | POST | 10 | wechat_mp_article_detail |
| 文章评论 | /v1/wechat_mp/article_comments | POST | 13 | wechat_mp_article_comments |
| 账号信息 | /v1/wechat_mp/account_profile | POST | 13 | wechat_mp_account_profile |
| 账号文章 | /v1/wechat_mp/account_articles | POST | 13 | wechat_mp_account_articles |
| 视频搜索 | /v1/wechat_channels/video_search | POST | 13 | wechat_channels_video_search |
| 视频详情 | /v1/wechat_channels/video_detail | POST | 10 | wechat_channels_video_detail |
| 视频评论 | /v1/wechat_channels/video_comments | POST | 13 | wechat_channels_video_comments |
| 视频分享链接 | /v1/wechat_channels/video_share_url | POST | 13 | wechat_channels_video_share_url |
| 账号信息 | /v1/wechat_channels/user_profile | POST | 13 | wechat_channels_user_profile |
| 账号作品 | /v1/wechat_channels/user_videos | POST | 13 | wechat_channels_user_videos |
| 视频搜索 | /v1/douyin/video_search | POST | 13 | douyin_video_search |
| 视频详情 | /v1/douyin/video_detail | GET | 10 | douyin_video_detail |
| 视频评论 | /v1/douyin/video_comments | GET | 2 | douyin_video_comments |
| 账号信息 | /v1/douyin/user_info | GET | 2 | douyin_user_info |
| 账号作品 | /v1/douyin/user_videos | GET | 2 | douyin_user_videos |
错误码
| HTTP | code | msg |
|---|---|---|
| 400 | 1001 | 参数错误 |
| 401 | 1401 | 密钥无效 |
| 402 | 1402 | 积分不足 |
| 404 | 1404 | 能力不存在 |
| 429 | 1429 | 请求过于频繁 |
| 404 | 2404 | 内容不存在或未收录 |
| 502 | 1502 | 上游数据源暂不可用 |
| 503 | 1503 | 服务繁忙 |
| 504 | 1504 | 上游超时 |