使用场景

从小红书笔记研究中国消费趋势

按关键词搜索小红书笔记并以 JSON 获取,了解中国消费者在推荐和询问什么,用于产品上市或进入中国市场之前的调研。

预付费,无订阅REST 或 MCP一个密钥搞定模型、数据和智能体
XiaohongshuRedNotelovelyjsonitems[0]"operation": "search_notes""keyword": "露营""sort_type": "like_count_descending""note_id": "64f0a1b2c3d4e5f607182…"user_id": "5f1c2a9e0000000001001…

在中国推出产品,或为中国消费者撰写文案之前,你想知道他们彼此都在推荐什么。在小红书上,这些都发生在笔记里:清单、测评和攻略,全是中文,由一个你无法用脚本搜索的 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>
01

工作原理

010203
  1. 用中文选关键词

    使用消费者会用的词:产品类型、活动、痛点。先从宽泛的词开始,例如一个兴趣爱好,再逐步收窄。

  2. 设置上限后运行工具

    把关键词连同 max_results 发送到 POST /v1/tools/xiaohongshu-search/run。运行会从你的余额中预留它的最高费用,并以 JSON 返回笔记。

  3. 从中读出规律

    按点赞最多排序,用模型翻译,再看反复出现的品牌、价位和抱怨。

02

一次请求搜索笔记

搜索小红书笔记需要一个 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;运行工具介绍了如何轮询。

03

每个条目包含什么

字段分组包含内容
笔记与你的关键词匹配的小红书笔记
其他操作同一个工具还支持 search_products、get_note_detail、get_note_comments、list_user_notes、get_user_info、list_topic_notes、search_hot_list 等,各自有不同的字段

该工具的描述是"按关键词获取笔记",所以在围绕具体字段搭建流程之前,请先用一次小规模运行确认返回的结构。文本以中文返回。

04

实用做法

上市前摸清一个品类。

按点赞排序搜索品类关键词,用模型翻译标题,再列出反复出现的品牌和产品。

挖掘消费者的用词。

收集 100 条关于某个痛点的笔记,例如皮肤干燥或小户型收纳,让模型提炼消费者反复使用的短语,再用到商品详情和广告里。

跟踪一个季节。

每周用 time_descending 搜索一个季节性关键词,观察哪些子话题在升温。

深入研究一篇爆款。

取一篇高表现笔记的 note id,运行 get_note_comments,读读大家在下面问了什么。

看看现在什么在流行。

用 search_hot_list 作为每日快照,了解大家在关注什么。

想用大白话操作?连接 MCP 服务器,然后对 Claude Code 或 Cursor 说:"在小红书上搜索"露营",按点赞排序,把标题翻译成英文,并把笔记归为五个主题。把 max_results 设为 50。"

06

费用说明

按条目计费:开始运行时会预留最高费用,即单次调用费加上单个条目费用乘以 max_results,运行结束后按实际返回的数量结算,其余预留金额退回你的余额。运行失败或超时只为已交付的条目付费,开始时就被拒绝的运行不收费。

拉取 50 个条目按 50 个条目计费。没有订阅,也没有每月最低消费:最低 $5 起充值,一份余额同时支付工具和模型。上方卡片显示今天的价格;定价列出了所有工具。

07

常见问题

?
必须用中文搜索吗?+

中文关键词与用户的写法相匹配。数据中的示例使用的是"露营"。

一次运行最多能返回多少个条目?+

最多 100 个,默认 10 个。把 max_results 设为你想要的数量。

可以读取评论或某位创作者的笔记吗?+

可以,改变 operation 即可,例如 get_note_comments、list_user_notes 或 get_user_info,并配上对应的 note_id 或 user_id。

一篇笔记包含哪些字段?+

该工具只把结果描述为按关键词获取的笔记,并没有列出字段。运行一次小测试就能看到。

需要小红书账号吗?+

不需要。你只需发送关键词和一个 API 密钥。

需要订阅吗?+

不需要。你向预付费余额充值,每次运行从中扣减。失败的运行只为已交付的结果付费,也不会自动续费。

要跨多个中国平台研究?请参阅中国社交媒体数据、网红调研以及工具目录中的其他内容。

一个预付费密钥,搞定模型、数据和智能体

无需订阅。充值后按需使用,每笔费用都能在日志中查看。