BusyBee — Social Media Data

BusyBee MCP

面向 AI Agent 的公开社交媒体数据。 十种业务级工具，一个 Schema——TikTok、Instagram、YouTube、X (Twitter)、Douyin 和 Xiaohongshu。

向你的 Agent 提问：“现在 TikTok 上增长最快的咖啡创作者有哪些？他们的评论区都在抱怨什么？”——它会在一次对话中用真实数据作答。

Endpoint    https://lucydomi.com/mcp
Protocols   MCP Streamable HTTP · MCP SSE (legacy) · REST/JSON · stdio
Tools       10
Billing     pay per call; every response returns cost_usd + balance_usd

---

适用于各种 Agent

大多数“面向 AI 的社交数据”产品只提供一种传输方式，并寄希望于你的客户端支持它。本服务支持四种传输方式，均托管在同一主机上，并使用同一套 10 种工具。

你的 Agent	支持方式	连接方法
Claude Code	Streamable HTTP	claude mcp add busybee --transport http https://lucydomi.com/mcp --header "Authorization: Bearer sk-..."
Cursor / Cline / Windsurf / VS Code	Streamable HTTP	添加到 mcp.json（见下文）
Claude Desktop	stdio	使用 BUSYBEE_API_KEY 运行 uvx busybee-mcp
较旧的 MCP 客户端（2024-11 时代）	仅 SSE	https://lucydomi.com/sse + https://lucydomi.com/messages/
Dify / n8n / Coze / FastGPT	OpenAPI / 普通 HTTP	导入 https://lucydomi.com/mcp/openapi.json（3.1），较旧的导入器可用 ?spec=3.0
LangChain / LlamaIndex / 自定义代码	tools JSON 或 HTTP	使用 https://lucydomi.com/mcp/tools?format=openai，或直接调用 REST
GPT Actions / Zapier / Make	OpenAPI 3.x	使用相同的 spec URL，并进行 bearer 身份验证
只能 GET URL 的任何客户端	查询字符串	https://lucydomi.com/mcp/v1/search_creators?platform=tiktok&keyword=coffee&api_key=sk-...

发现文档（机器可读，告知 Agent 可用功能）：https://lucydomi.com/mcp/info

---

10 种工具

工具	可回答的问题
list_platforms	有哪些平台、每个平台支持哪些工具，以及需要哪组密钥
search_creators	“帮我找 TikTok 上规模中等的咖啡创作者”
search_posts	“本周有哪些关于冷萃咖啡的帖子？”
get_creator	“这个账号有多大？简介是什么？”
list_creator_posts	“这个账号最近发了什么？”
get_post	“告诉我这条视频的详细信息”
get_comments	“人们在这条帖子下都说了什么？”
get_trending	“现在 Douyin 上什么最热门？”
get_comment_insights	“总结评论区：情绪、问题、抱怨”
check_balance	“我还剩多少额度？”

get_comment_insights 是大家一直在用的工具：它会抽样评论，然后返回情绪分布、问题占比、高频短语和获赞最多的评论——让 Agent 能回答“用户真正想要什么”，而不是倾倒 50 条原始记录。

---

一个 Schema，适用于所有平台

无论内容来自 TikTok、Instagram、YouTube、X、Douyin 还是 Xiaohongshu，字段名称都相同：

{
  "ok": true, "platform": "tiktok", "tool": "search_posts", "count": 6,
  "items": [
    {
      "platform": "tiktok",
      "id": "7690199760430566669",
      "url": "https://www.tiktok.com/@laceyglasley/video/7690199760430566669",
      "author": { "id": "7066058701889012782", "handle": "laceyglasley", "name": "Lacey" },
      "text": "Salted Honey Spanish Latte … #coffeetok #spanishlatte",
      "created_at": "2026-09-27T13:03:24+00:00",
      "stats": { "likes": 68357, "comments": 165, "shares": 7691, "views": 1009685, "collects": 17806 },
      "cover": "https://…"
    }
  ],
  "cost_usd": 0.003, "balance_usd": 3.93
}

这是实际响应，不是演示样例——内容取自实时调用，仅裁去了分享 URL 的查询字符串和文案。仓库中包含两份完整的原始响应： examples/1_tiktok_coffee.json（search_posts）和 examples/2_youtube_insights.json（针对 20 条评论的评论洞察）。

每个响应都包含 cost_usd 和 balance_usd，因此 Agent 可以自行控制预算，你也能查看任务的实际费用。

---

按客户端配置

首先需要密钥：在 lucydomi.com 注册 → Console → API Keys → New key（sk-…）。海外平台和中国平台使用不同的密钥组。

Claude Code

claude mcp add busybee --transport http https://lucydomi.com/mcp \
  --header "Authorization: Bearer sk-YOUR_KEY"

Cursor / Cline / Windsurf / VS Code（~/.cursor/mcp.json）

{
  "mcpServers": {
    "busybee": {
      "url": "https://lucydomi.com/mcp",
      "headers": { "Authorization": "Bearer sk-YOUR_KEY" }
    }
  }
}

Claude Desktop（本地 stdio）

{
  "mcpServers": {
    "busybee": {
      "command": "uvx",
      "args": ["busybee-mcp"],
      "args": ["busybee-mcp"],
      "env": { "BUSYBEE_API_KEY": "sk-YOUR_KEY" }
    }
  }
}

旧版 SSE 客户端

SSE URL      https://lucydomi.com/sse
Messages URL https://lucydomi.com/messages/?session_id=<from the SSE event>
Header       Authorization: Bearer sk-YOUR_KEY

Dify / n8n / Coze / GPT Actions

导入 OpenAPI 架构，将身份验证设置为 Bearer sk-YOUR_KEY。如果导入器不接受 3.1，请使用 3.0 视图。

平台	粘贴位置	URL
Dify	Tools → Custom → Add OpenAPI tool	https://lucydomi.com/mcp/openapi.json?spec=3.0
n8n	HTTP Request 节点，或导入为受凭据保护的 API	https://lucydomi.com/mcp/openapi.json
Coze	Plugin → Import from OpenAPI	https://lucydomi.com/mcp/openapi.json?spec=3.0
OpenAI GPT Actions	Actions → Import from URL	https://lucydomi.com/mcp/openapi.json

服务端端点会根据架构自动生成；每个操作都与一个工具名称一一对应，因此架构中的 search_posts 对应 POST https://lucydomi.com/mcp/v1/search_posts。

LangChain / 自定义 Python（无需 MCP）

import json, urllib.request
req = urllib.request.Request(
    "https://lucydomi.com/mcp/v1/search_creators",
    data=json.dumps({"platform": "tiktok", "keyword": "coffee", "limit": 3}).encode(),
    headers={"Content-Type": "application/json", "Authorization": "Bearer sk-YOUR_KEY"},
)
print(json.load(urllib.request.urlopen(req)))

用于函数调用的工具架构：GET https://lucydomi.com/mcp/tools?format=openai

本地软件包

pip install busybee-mcp
BUSYBEE_API_KEY=sk-YOUR_KEY busybee-mcp          # stdio
BUSYBEE_API_KEY=sk-YOUR_KEY busybee-mcp http     # serve all transports on :3013

---

值得了解的设计决策

• 十个工具，而不是一千个。 调用业务意图，而非端点。模型看到的工具越多，选错的概率就越高，花费也越多。
• 字段已规范化。 author / text / created_at / stats 在所有平台上含义相同。
• 每种协议背后都是同一套实现。 MCP、SSE 和 REST 共用同一个分发层，因此不同客户端之间的行为不会出现偏差。
• 按调用次数计费，按端点定价。 低价调用的费用不到一美分。价格可在控制台中查看。
• 结果中明确显示费用。 每个响应都包含 cost_usd + balance_usd。
• 失败不收费。
• 错误信息简洁明了。 不会泄露堆栈跟踪、第三方供应商名称或上游文档链接到 Agent 的上下文中。
• 已启用 CORS，基于浏览器的 Agent 和 Web 小组件可以直接调用。

错误

error	含义	处理方法
no_api_key	未提供密钥	添加 Authorization: Bearer sk-...、X-API-Key 或 ?api_key=
unauthorized	密钥无效或已删除	在控制台中创建新密钥
insufficient_balance	余额不足	充值
forbidden	密钥组不包含该平台	在正确的组中创建密钥
rate_limited	请求过多	降低请求频率，然后重试
unsupported_tool	该平台未提供此工具	调用 list_platforms 查看支持情况
upstream_error	服务提供方暂时出错	重试一次；不收费

范围与合规

BusyBee 仅提供公开社交媒体数据，且仅面向中国大陆以外的用户。请勿将其用于分析个人隐私信息、抓取私人账号、操纵互动，或在缺乏合法依据的情况下使用个人数据训练模型。请参阅数据政策。

许可证

MIT — 请参阅 LICENSE。此仓库是客户端 MCP 服务；托管服务需另行按使用量计费。

---

中文速览

BusyBee MCP 将 TikTok、Instagram、YouTube、X、抖音、小红书六个平台的公开数据，整合为 10 个业务级工具 + 一套统一字段，同一台服务器支持四种接入方式：

你的 AI 工具	接入地址
Claude Code / Cursor / Cline（新版 MCP）	https://lucydomi.com/mcp
仅支持旧版 SSE 的客户端	https://lucydomi.com/sse
Dify / n8n / Coze / GPT Actions（OpenAPI）	https://lucydomi.com/mcp/openapi.json
任何能发送 HTTP 请求的程序	https://lucydomi.com/mcp/v1/<工具名>

• 密钥：注册后在控制台创建一个以 sk- 开头的字符串
• 计费：按次计费，每次响应都包含本次费用与余额；失败不扣费
• 错误信息使用简洁的中文或英文，不暴露任何上游信息