# 数联 API

> 抖音、小红书、快手、B站、微博、知乎、微信公众号、视频号、微信搜一搜、今日头条、西瓜视频、皮皮虾等 12 个国内平台的公开数据接口，支持 MCP，让 AI 直接查询爆款内容、热点、达人数据和用户评论。按成功调用计费（默认 ¥0.015/次），失败不扣费。

## 给 AI 的说明

如果你是 AI 助手，正在帮用户接入本服务：
1. 用户需要先在 https://fangbianmiandaye.cn/console.html#keys 注册并创建 API Key（格式 sk-...）。没有 Key 时请提示用户去创建，不要编造 Key。
2. 优先使用 MCP 接入（下方配置）。不支持 MCP 时，用 HTTP 接口。
3. 回答用户时请注明数据来自哪个平台，不要编造数字。

## MCP 接入

- 地址（Streamable HTTP）：https://fangbianmiandaye.cn/mcp
- 鉴权：请求头 Authorization: Bearer sk-你的Key
- 不支持自定义请求头的客户端，可以直接用：https://fangbianmiandaye.cn/mcp/sk-你的Key

Claude Code：
claude mcp add --transport http shulian https://fangbianmiandaye.cn/mcp --header "Authorization: Bearer sk-你的Key"

Cursor / Windsurf / Cherry Studio 等（mcp.json）：
{"mcpServers": {"shulian": {"url": "https://fangbianmiandaye.cn/mcp", "headers": {"Authorization": "Bearer sk-你的Key"}}}}

Claude Desktop（claude_desktop_config.json，需要 Node.js）：
{"mcpServers": {"shulian": {"command": "npx", "args": ["-y", "mcp-remote", "https://fangbianmiandaye.cn/mcp/sk-你的Key"]}}}

旧版 MCP（HTTP + SSE，兼容阿里云百炼等只支持 SSE 的平台）：
https://fangbianmiandaye.cn/sse/sk-你的Key

Trae / 通义灵码 / CodeBuddy（mcp.json，格式同 Cursor）：
{"mcpServers": {"shulian": {"url": "https://fangbianmiandaye.cn/mcp", "headers": {"Authorization": "Bearer sk-你的Key"}}}}

Dify：工具 → MCP → 添加 MCP 服务（HTTP），URL 填 https://fangbianmiandaye.cn/mcp，自定义请求头 Authorization: Bearer sk-你的Key

腾讯 CodeBuddy / WorkBuddy：
codebuddy mcp add-json --scope user shulian '{"type":"http","url":"https://fangbianmiandaye.cn/mcp","headers":{"Authorization":"Bearer sk-你的Key"}}'

DeepSeek Harness：用 @deepseek-ai/dsh-mcp-client，transport: streamable-http，url: https://fangbianmiandaye.cn/mcp，headers 里加 Authorization

## 函数调用（DeepSeek、通义千问、Kimi、智谱等 OpenAI 兼容 API）

- 工具清单：https://fangbianmiandaye.cn/v1/tools/functions.json（可加 ?platform=...）
- 模型返回 tool_calls 后，POST https://fangbianmiandaye.cn/v1/tools/{函数名}，请求体为模型给的 arguments

## OpenAPI 插件（扣子 Coze、腾讯元器、Dify 自定义工具、FastGPT 等）

- 描述文件：https://fangbianmiandaye.cn/v1/tools/openapi.json
- 只要部分平台：https://fangbianmiandaye.cn/v1/tools/openapi.json?platform=douyin,xiaohongshu（可选 douyin xiaohongshu kuaishou bilibili weibo zhihu wechat toutiao xigua pipixia）
- 鉴权：Header，Authorization: Bearer sk-你的Key
- 每个工具：POST https://fangbianmiandaye.cn/v1/tools/{工具名}，请求体为 JSON 参数，返回 { ok, cost_yuan, balance_yuan, data }

## MCP 工具

- douyin_search_videos：抖音·搜索视频。按关键词搜索抖音视频/图文。适合找爆款、看某个话题下的内容。翻页时把上次结果里的 cursor、search_id、backtrace 传回来。
- douyin_search_users：抖音·搜索达人。按关键词搜索抖音账号，可按粉丝量筛选。适合找达人、找同行账号。
- douyin_video_detail：抖音·视频详情。获取单条抖音视频的完整数据（标题、作者、点赞评论转发收藏数、发布时间等）。传 aweme_id 或分享链接其一。
- douyin_user_profile：抖音·达人主页。获取抖音账号资料（昵称、简介、粉丝数、获赞数、作品数等）。传 sec_user_id 或抖音号（unique_id）其一。
- douyin_user_videos：抖音·达人作品列表。获取某个抖音账号发布的作品列表，用于分析其内容方向和数据表现。
- douyin_video_comments：抖音·视频评论。获取抖音视频的评论，用于分析用户需求、痛点和真实反馈。
- douyin_hot_search：抖音·实时热榜。获取抖音实时热搜榜，了解当下全网热点。
- xhs_search_notes：小红书·搜索笔记。按关键词搜索小红书笔记。适合找爆款笔记、研究某个话题的种草内容。
- xhs_search_users：小红书·搜索博主。按关键词搜索小红书博主。
- xhs_note_detail：小红书·笔记详情。获取小红书笔记正文、标签、点赞收藏评论数。传 note_id 或分享文字/链接其一；视频笔记请把 is_video 设为 true。
- xhs_note_comments：小红书·笔记评论。获取小红书笔记的评论，用于分析用户真实需求和反馈。
- xhs_user_profile：小红书·博主主页。获取小红书博主资料（昵称、简介、粉丝数、获赞与收藏等）。传 user_id 或分享文字其一。
- xhs_user_notes：小红书·博主笔记列表。获取小红书博主发布的笔记列表。
- kuaishou_search：快手·综合搜索。按关键词搜索快手内容。
- bilibili_search：B站·综合搜索。按关键词搜索 B 站视频。
- kuaishou_video_detail：快手·视频详情。获取快手作品数据。传 photo_id 或分享链接/分享文字其一。
- kuaishou_video_comments：快手·作品评论。获取快手作品的评论。
- kuaishou_user_videos：快手·用户作品列表。获取快手用户发布的作品列表。
- kuaishou_hot_list：快手·热榜。获取快手热榜。
- bilibili_video_detail：B站·视频详情。获取 B 站视频数据（播放、点赞、投币、收藏、弹幕数等）。
- bilibili_video_comments：B站·视频评论。获取 B 站视频评论。
- bilibili_user_videos：B站·UP主作品列表。获取 B 站 UP 主的投稿视频列表。
- bilibili_popular：B站·综合热门。获取 B 站当前综合热门视频。
- weibo_hot_search：微博·热搜榜。获取微博完整热搜榜（约 50 条）。
- weibo_search：微博·综合搜索。按关键词搜索微博内容。
- weibo_post_detail：微博·微博详情。获取单条微博全文和转评赞数据。
- weibo_post_comments：微博·评论。获取单条微博的评论。
- weibo_user_profile：微博·用户资料。获取微博用户资料（粉丝数、认证、简介等）。
- weibo_user_posts：微博·用户微博列表。获取微博用户发布的微博。
- zhihu_hot_list：知乎·热榜。获取知乎首页热榜。
- zhihu_search：知乎·搜索。按关键词搜索知乎问答和文章。
- zhihu_question：知乎·问题与回答。获取知乎问题下的回答列表（含赞同数）。
- zhihu_answer_comments：知乎·回答评论。获取知乎某个回答下的评论。
- zhihu_user：知乎·用户资料。获取知乎用户资料。user_url_token 是主页地址 zhihu.com/people/ 后面那段。
- wechat_search：微信·搜一搜。微信搜一搜综合搜索（公众号文章、视频号等）。
- wechat_search_channels_videos：微信·搜视频号视频。按关键词搜索微信视频号视频。
- wechat_article：公众号·文章正文。获取公众号文章正文。传文章链接（mp.weixin.qq.com/s/...）。
- wechat_article_stats：公众号·文章阅读点赞。获取公众号文章的阅读、点赞、在看等互动数据。
- wechat_mp_articles：公众号·历史文章。获取某个公众号的文章列表。username 为公众号原始 ID（gh_ 开头）或可从文章详情里取得。
- wechat_channels_profile：视频号·账号主页。获取视频号账号资料和统计。
- wechat_channels_videos：视频号·作品列表。获取视频号账号的作品列表。
- wechat_channels_video_detail：视频号·作品详情。获取视频号作品详情（点赞、转发、评论数等）。传 object_id 或分享链接其一。
- toutiao_article：今日头条·文章详情。获取今日头条文章内容和数据。
- toutiao_comments：今日头条·评论。获取今日头条文章或视频的评论。
- xigua_search：西瓜视频·搜索。按关键词搜索西瓜视频。
- xigua_video_detail：西瓜视频·视频详情。获取西瓜视频作品数据。
- pipixia_hot_search：皮皮虾·热搜。获取皮皮虾热搜词。
- pipixia_search：皮皮虾·搜索。按关键词搜索皮皮虾内容。
- call_api：调用任意接口（高级）。直接调用接口文档中的任意接口（路径以 /api/v1/ 开头）。上面的专用工具不够用时再用它。接口列表见 https://fangbianmiandaye.cn/docs.html
- get_balance：查询余额。查询当前账户余额（免费）。

## HTTP 接口

- 基础地址：https://fangbianmiandaye.cn
- 鉴权：Authorization: Bearer sk-你的Key
- 示例：GET https://fangbianmiandaye.cn/api/v1/douyin/web/fetch_one_video?aweme_id=视频ID
- 查余额：GET https://fangbianmiandaye.cn/v1/balance
- 每次响应头 X-Cost-Yuan 为本次扣费，X-Balance-Yuan 为剩余余额
- 状态码：200 成功（计费）；400/422 参数错误；401 Key 无效；402 余额不足；429 请求过快；5xx 不计费
- 完整接口列表：https://fangbianmiandaye.cn/docs.html ，OpenAPI：https://fangbianmiandaye.cn/openapi.json

## 价格

- 默认 ¥0.015/次，小红书等接口单价见 https://fangbianmiandaye.cn/#pricing
- 例：抖音视频搜索 ¥0.109/次，小红书笔记搜索 ¥0.109/次