社媒数据 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_searchGET13xhs_note_search
笔记详情/v1/xhs/note_detailGET10xhs_note_detail
笔记评论/v1/xhs/note_commentsGET13xhs_note_comments
账号信息/v1/xhs/user_infoGET13xhs_user_info
账号作品/v1/xhs/user_notesGET13xhs_user_notes
文章详情/v1/wechat_mp/article_detailPOST10wechat_mp_article_detail
文章评论/v1/wechat_mp/article_commentsPOST13wechat_mp_article_comments
账号信息/v1/wechat_mp/account_profilePOST13wechat_mp_account_profile
账号文章/v1/wechat_mp/account_articlesPOST13wechat_mp_account_articles
视频搜索/v1/wechat_channels/video_searchPOST13wechat_channels_video_search
视频详情/v1/wechat_channels/video_detailPOST10wechat_channels_video_detail
视频评论/v1/wechat_channels/video_commentsPOST13wechat_channels_video_comments
视频分享链接/v1/wechat_channels/video_share_urlPOST13wechat_channels_video_share_url
账号信息/v1/wechat_channels/user_profilePOST13wechat_channels_user_profile
账号作品/v1/wechat_channels/user_videosPOST13wechat_channels_user_videos
视频搜索/v1/douyin/video_searchPOST13douyin_video_search
视频详情/v1/douyin/video_detailGET10douyin_video_detail
视频评论/v1/douyin/video_commentsGET2douyin_video_comments
账号信息/v1/douyin/user_infoGET2douyin_user_info
账号作品/v1/douyin/user_videosGET2douyin_user_videos

错误码

HTTPcodemsg
4001001参数错误
4011401密钥无效
4021402积分不足
4041404能力不存在
4291429请求过于频繁
4042404内容不存在或未收录
5021502上游数据源暂不可用
5031503服务繁忙
5041504上游超时

平台文档