在中国推出产品,或为中国消费者撰写文案之前,你想知道他们彼此都在推荐什么。在小红书上,这些都发生在笔记里:清单、测评和攻略,全是中文,由一个你无法用脚本搜索的 App 排序。Lovely Router 替你执行搜索。发送关键词,每个条目返回一个 JSON 对象,按条目数量从预付费余额中计费。用一个 API 密钥,就能从脚本、研究笔记本或 AI 智能体中调用。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
从小红书笔记研究中国消费趋势. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the inputs (links, keywords or accounts) and how many results you need>工作原理
用中文选关键词
使用消费者会用的词:产品类型、活动、痛点。先从宽泛的词开始,例如一个兴趣爱好,再逐步收窄。
设置上限后运行工具
把关键词连同
max_results发送到POST /v1/tools/xiaohongshu-search/run。运行会从你的余额中预留它的最高费用,并以 JSON 返回笔记。从中读出规律
按点赞最多排序,用模型翻译,再看反复出现的品牌、价位和抱怨。
一次请求搜索笔记
搜索小红书笔记需要一个 operation(这里是 search_notes),加上 keyword 和 sort_type:general、time_descending、like_count_descending、comment_count_descending 或 collect_count_descending。这个工具的 input 中没有上限字段;上限是请求中的 max_results:
curl https://lovelyrouter.com/v1/tools/xiaohongshu-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"operation": "search_notes",
"keyword": "露营",
"sort_type": "like_count_descending"
},
"max_results": 30
}'运行超过 60 秒仍未结束时会返回 202;运行工具介绍了如何轮询。
每个条目包含什么
| 字段分组 | 包含内容 |
|---|---|
| 笔记 | 与你的关键词匹配的小红书笔记 |
| 其他操作 | 同一个工具还支持 search_products、get_note_detail、get_note_comments、list_user_notes、get_user_info、list_topic_notes、search_hot_list 等,各自有不同的字段 |
该工具的描述是"按关键词获取笔记",所以在围绕具体字段搭建流程之前,请先用一次小规模运行确认返回的结构。文本以中文返回。
实用做法
按点赞排序搜索品类关键词,用模型翻译标题,再列出反复出现的品牌和产品。
收集 100 条关于某个痛点的笔记,例如皮肤干燥或小户型收纳,让模型提炼消费者反复使用的短语,再用到商品详情和广告里。
每周用 time_descending 搜索一个季节性关键词,观察哪些子话题在升温。
取一篇高表现笔记的 note id,运行 get_note_comments,读读大家在下面问了什么。
用 search_hot_list 作为每日快照,了解大家在关注什么。
想用大白话操作?连接 MCP 服务器,然后对 Claude Code 或 Cursor 说:"在小红书上搜索"露营",按点赞排序,把标题翻译成英文,并把笔记归为五个主题。把 max_results 设为 50。"
搭配其他中文数据来源
笔记显示人们在说什么,电商平台显示他们在买什么:
按关键词获取小红书笔记。
按关键词获取抖音视频。
按关键词获取微博帖子。
按链接获取淘宝和天猫商品页:标题、价格与促销、店铺、品牌、图片、参数、销量和规格。
按关键词搜索闲鱼二手商品:标题、价格和原价、成色、城市、卖家、图片、发布时间。
douyin-search覆盖同一话题在短视频上的讨论。weibo-search显示微博上的公开讨论。taobao-product给出笔记所推荐商品的价格和销量。xianyu-listings显示同类商品的二手转售价格。
更完整的方案,请参阅中国社交媒体数据。
笔记和评论来自真实用户。如果你要存储或联系他们,需要自行负责合法使用这些数据,包括遵守隐私和反垃圾信息规定。
费用说明
按条目计费:开始运行时会预留最高费用,即单次调用费加上单个条目费用乘以 max_results,运行结束后按实际返回的数量结算,其余预留金额退回你的余额。运行失败或超时只为已交付的条目付费,开始时就被拒绝的运行不收费。
拉取 50 个条目按 50 个条目计费。没有订阅,也没有每月最低消费:最低 $5 起充值,一份余额同时支付工具和模型。上方卡片显示今天的价格;定价列出了所有工具。
常见问题
必须用中文搜索吗?+
中文关键词与用户的写法相匹配。数据中的示例使用的是"露营"。
一次运行最多能返回多少个条目?+
最多 100 个,默认 10 个。把 max_results 设为你想要的数量。
可以读取评论或某位创作者的笔记吗?+
可以,改变 operation 即可,例如 get_note_comments、list_user_notes 或 get_user_info,并配上对应的 note_id 或 user_id。
一篇笔记包含哪些字段?+
该工具只把结果描述为按关键词获取的笔记,并没有列出字段。运行一次小测试就能看到。
需要小红书账号吗?+
不需要。你只需发送关键词和一个 API 密钥。
需要订阅吗?+
不需要。你向预付费余额充值,每次运行从中扣减。失败的运行只为已交付的结果付费,也不会自动续费。