能拿到什么
| 支持的能力 | 搜推文 / 搜账号 / 账号详情 / 账号作品 / 推文详情 / 拉评论 |
|---|---|
| 返回字段 | 推文 url、文案、作者（id/handle/昵称）、时间、点赞转发回复、封面 |
| 接入方式 | MCP（Streamable HTTP）或 REST（GET/POST 均可） |
| 计费 | 按次计费，失败自动退款 |
字段长什么样
不管哪个平台，帖子类返回都是同一套结构：items[] 里放 platform / id / url / author{id,handle,name} / text / created_at / stats{...} / cover；达人类是 handle / name / bio / followers / following / posts / verified / avatar / url。换平台不用改解析代码。
用 MCP 还是 REST
给模型用走 MCP：把 https://lucydomi.com/mcp 加进客户端配置，它自己选工具。写程序用走 REST：https://lucydomi.com/mcp/v1/search_posts，GET 传查询参数、POST 传 JSON body 都行，返回结构完全一致。
复制即可运行
cURL
curl -s https://lucydomi.com/mcp/v1/search_posts \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"platform": "twitter", "keyword": "coffee", "limit": 3}'Python（标准库，无需依赖）
import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/search_posts",
data=json.dumps({"platform": "twitter", "keyword": "coffee", "limit": 3}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for it in data["items"]:
print(it.get("url"), it.get("text", "")[:60])真实返回样例
下面这段是线上真实返回（已截断到 1 条，去掉了计费字段）。
{
"ok": true,
"platform": "twitter",
"tool": "search_posts",
"count": 1,
"items": [
{
"platform": "twitter",
"id": "2113381699765628934",
"url": "https://x.com/quietwolfzz/status/2113381699765628934",
"author": {
"id": "2034537496894398464",
"handle": "quietwolfzz",
"name": "𝚀𝚞𝚒𝚎𝚝 𝚆𝚘𝚕𝚏"
},
"text": "Nobody ever asked if you wanted coffee with your rest.\n\nIn 1952, coffee sellers gave your break a product’s name. Your boss kept the minutes.\n\nWatch. Learn. Go quiet. 🐺\n\n📖 The 7 levers they use on all of us (free guide): \nhttps://t.co/3QtN8q53jr\n\n🎬 Made with @higgsfield_ai 👇\n\nhttps://t.co/vMzUntJTnl\n\n#coffeebreak #coffee #history #psychology",
"created_at": "Thu Oct 22 21:27:16 +0000 2026",
"stats": {
"likes": 1806,
"comments": 34,
"shares": 280,
"views": 37304,
"collects": 780
},
"cover": null
}
]
}常见问题
要不要自己准备爬虫或代理？
不用。接口在服务端已经处理好抓取与清洗，你只拿到结构化 JSON；失败会自动退款。
可以商用吗？
返回的都是公开可见内容，可用于分析与产品功能；具体边界见「数据使用规范」页。
返回条数能调大吗？
limit 可以调，但单次调用是同步返回，建议按需分批拉取，避免单次超时。