参数
| 参数 | 必填 | 取值 |
|---|---|---|
| platform | 是 | tiktok / youtube / twitter / douyin / xiaohongshu |
| keyword | 是 | 搜索词,支持中文;建议带地域或品类限定 |
| limit | 否 | 返回条数,默认 10 |
返回什么
字段与平台无关:帖子类 items[](url、文案、作者、时间、互动数据、封面),达人类 items[](handle、昵称、简介、粉丝数、认证),洞察类直接给 sentiment / questions / top_phrases / top_liked / summary。
在 MCP 客户端里怎么用
不需要记参数——把端点加进客户端后,直接用自然语言描述需求,模型会自己挑工具和参数。写代码时再用上面的 REST 形式。
复制即可运行
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": "tiktok", "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": "tiktok", "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": "tiktok",
"tool": "search_posts",
"count": 1,
"items": [
{
"platform": "tiktok",
"id": "7690199760430566669",
"url": "https://www.tiktok.com/@laceyglasley/video/7690199760430566669?_r=1&u_code=f0m7125f4ia4bk&preview_pb=0&sharer_language=en&_d=f0m710il3k0l0c&share_item_id=7690199760430566669&source=h5_m",
"author": {
"id": "7066058701889012782",
"handle": "laceyglasley",
"name": "Lacey"
},
"text": "One for me, one for you 🤎🍯 Salted Honey Spanish Latte (1-16oz drink) • 1 tbsp sweetened condensed milk • 1 tsp honey • Dash of cinnamon • Pinch of salt • Dash of cinnamon • 2 tsp instant espresso + 2oz warm water (or double shot of espresso) • Ice • 3-4oz milk Enjoy! #coffeetok #coffeeathome #instantespresso #coffeerecipe #spanishlatte ",
"created_at": "2026-09-27T13:03:24+00:00",
"stats": {
"likes": 68801,
"comments": 169,
"shares": 7732,
"views": 1017504,
"collects": 17981
},
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/owpgeRFaArQERuSqRE9CDLMEBEI3EAF5ACAufD~tplv-tiktokx-origin.image?biz_tag=musically_video.video_cover&dr=8593&idc=useast8&ps=933b5bde&refresh_token=9ebdfa7c&s=SEARCH&sc=cover&shcp=c1333099&shp=d05b14bd&t=bacd0480&x-expires=1792933200&x-signature=lpbiHJbGP7CmVDG3kmOcPkenHQo%3D"
}
]
}常见问题
这个工具和直接搜关键词有什么区别?
搜关键词给你原始条目,评论洞察给你结论(情绪比例、提问占比、高频词、高赞评论),省一轮后处理。
采样条数越大越准吗?
更稳但更慢。判断选题 20-50 条足够;要严谨统计再往上调。
失败会扣次数吗?
不会。上游失败自动退款,只有拿到数据才算一次。