能拿到什么
| 支持的能力 | 搜笔记 / 搜达人 / 达人详情 / 达人作品 / 笔记详情 / 拉评论 |
|---|---|
| 返回字段 | 笔记 url、正文、作者、时间、点赞收藏评论、封面 |
| 接入方式 | MCP(Streamable HTTP)或 REST(GET/POST 均可) |
| 说明 | 国内平台按分组授权,需累计充值满 $30 解锁;调用失败自动退款 |
字段长什么样
不管哪个平台,帖子类返回都是同一套结构: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": "xiaohongshu", "keyword": "昆明 买房", "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": "xiaohongshu", "keyword": "昆明 买房", "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": "xiaohongshu",
"tool": "search_posts",
"count": 1,
"items": [
{
"platform": "xiaohongshu",
"id": "6a8a775e000000002901a04b",
"url": "https://www.xiaohongshu.com/explore/6a8a775e000000002901a04b",
"author": {
"id": "6743d0a9000000001d02ca46",
"handle": "11547479444",
"name": "安家小记"
},
"text": "我爱昆明💕110w拿下滇池124㎡四代宅~\n🥹之前观望了大半年迟迟没下手 这次终于碰到符合预期的好价位 ✨在家就能拥有270°环幕大露台 约26㎡超大拓展空间 建",
"created_at": "2026-09-30T08:44:24+00:00",
"stats": {
"likes": 28,
"comments": 103,
"shares": 44,
"views": 0,
"collects": 25
},
"cover": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k83246ta201mu005pq3q2kndii6pc6sfq0?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=b0aa3175b103c4e71e025849df8dfda5&t=6adcac1a"
}
]
}常见问题
要不要自己准备爬虫或代理?
不用。接口在服务端已经处理好抓取与清洗,你只拿到结构化 JSON;失败会自动退款。
可以商用吗?
返回的都是公开可见内容,可用于分析与产品功能;具体边界见「数据使用规范」页。
返回条数能调大吗?
limit 可以调,但单次调用是同步返回,建议按需分批拉取,避免单次超时。