参数
| 参数 | 必填 | 取值 |
|---|---|---|
platform | 是 | 固定 xiaohongshu |
keyword | 是 | 搜索词；search_posts 用，支持中文，建议带地域或品类限定 |
post_id | 是 | get_comments 用，笔记 id（explore/ 后面那串） |
limit | 否 | 返回条数，默认 20 |
关键词搜索返回什么
items[]：id、url、author（含 handle）、text（笔记正文含话题标签）、stats（likes / comments / shares / collects / views）、cover、created_at。
小红书搜索结果里 collects（收藏）是有值的，比点赞更能反映“愿意存下来用”，做选品时优先看它。
已知边界（如实说明）
- 个别笔记上游结构异常：会返回
{"error": "normalize_failed"}这一项。请按 item 级容错，跳过这条继续处理其余结果，不要让整批失败。 - 时间字段可能为空：小红书部分笔记不给发布时间，此时
created_at为null，不要当成 1970 年。 - 图片是带签名的临时链接：
cover会过期，要长期保存请立刻转存。
复制即可运行
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": "xiaohongshu", "keyword": "昆明 咖啡", "limit": 20}'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": "xiaohongshu", "keyword": "昆明 咖啡", "limit": 20}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for n in data["items"]:
if n.get("error"):
continue
print(n["stats"]["likes"], n["stats"]["collects"], n["text"][:40].replace("\n", " "))
真实返回样例
下面这段来自线上真实调用，已截断并去掉图片/签名类字段。
{
"ok": true,
"platform": "xiaohongshu",
"tool": "search_posts",
"count": 3,
"items": [
{
"id": "6ada5f59000000002a01f993",
"url": "https://www.xiaohongshu.com/explore/6ada5f59000000002a01f993",
"author": {"id": "5b8d355f8e9cff00019f0a0c", "handle": "294505110", "name": "小杜要天天开心_"},
"text": "近期在昆明喝到的14杯细糠（无广合集）",
"created_at": null,
"stats": {"likes": 183, "comments": 15, "shares": 95, "views": 0, "collects": 198}
},
{
"platform": "xiaohongshu",
"error": "normalize_failed"
}
]
}常见问题
能按点赞排序或按时间过滤吗？
搜索接口按平台默认相关性返回，不支持指定排序；需要筛选请在拿到结果后本地排序（字段都在）。
评论能拿多少条？
按
limit 取，受上游单次上限约束。要做全量评论分析，先用评论洞察抽样看结论更省。笔记正文里的表情和话题标签会保留吗？
保留原始文案，话题标签和表情标记都在
text 里，自己做清洗。国内平台有什么门槛？
抖音、小红书属国内分组，需要国内分组密钥；新注册账户有 5 次免费试用，用完再充值解锁。