同事发来小红书短链,怎样读笔记、找评论里的真实问题?
要研究同事发来的小红书笔记,把原分享链接作为 share_text 传给与任务对应的 App 动作。读描述用 xiaohongshu.app_v2.get_image_note_detail 或 xiaohongshu.app_v2.get_video_note_detail;看讨论,直接用 xiaohongshu.app_v2.get_note_comments 查这篇笔记的一级评论。已经拿到核对过的笔记编号时,改传 note_id。
比如同事发来一篇咖啡机清洁教程,想知道用户卡在哪一步。已经读过教程时,直接从评论开始,保存问题原句和评论里提到的机型。需要核对教程本身写了什么时,再查笔记详情。
手里的链接或编号该放哪里?
短链末尾的短码不是笔记编号。笔记编号和用户编号可能长得相似,判断时看编号来自哪一类页面。原链接里的查询参数随链接一起保留,不需要自己生成访问令牌。
按这次要完成的事选择
给目标笔记选一个定位输入:有准确 ID 就用 ID,只有分享链接就用链接;已知图文或视频类型时,选对应的详情动作。详情动作返回的描述只是文本,不识别图片内容,也不转写视频;任务需要这些材料时另行补充。
下面以读取图文详情为例,把 <note_share_link> 换成真实笔记链接:
拿到结果后,怎样继续?
- 确认就是这篇。 图文详情位于
data.data[].note_list[],视频详情位于data.data[]。对照标题、作者和原链接,保存目标笔记的id;返回多篇时选出对应的笔记对象。 - 保留能回看的来源。 记录原链接、确认的笔记ID、查询时间和
request_id。同一篇的后续观察按笔记ID关联,分享短链仍可作为来源保留。 - 围绕问题读评论。 评论中的
note_id指所属笔记,id指这条评论本身。整理“观众原话—涉及步骤/条件—需要补充的回答”,不要只统计清洁、难用等关键词。 - 有歧义再补回复。 用
xiaohongshu.app_v2.get_note_sub_comments查回复时,把一级评论的id作为comment_id传入。回复里的target_comment.id可能指向另一条回复,所以要保留父子上下文。后续分页按返回的游标继续。
比如“这个刷子所有机型都能用吗”归入兼容性待回答项;“我这台不用拆这一步”是带机型背景的经验,先保留原句和上下文再判断。缺少原句或目标笔记对不上时,先补材料,不要生成看似完整的结论。导出步骤见笔记评论研究指南。
把任务交给已接入工具的助手时,可以这样写:
研究这条分享链接对应的咖啡机清洁教程。已有描述可复用,优先读评论,整理大家卡住的步骤、适用条件和待回答问题。每项附原句、所属笔记和必要回复;说明本次读到的范围,再列出值得补读的讨论。
为什么有的动作还要xsec_token?
App 动作和 Web 详情动作的输入不同。上面三个 App 动作不需要另外提供 xsec_token;xiaohongshu.web_v3.fetch_note_detail 则同时要求 note_id 和 xsec_token。按所选动作声明的输入传参。
X-S、X-T、x-S-Common 是直连网页客户端使用的签名头;笔记ID、链接访问令牌和 BeatAPI Key 各有各的用途。上述 App 动作只需常规 BeatAPI 鉴权和声明的定位参数,不需要网页签名库,也不需要复制浏览器 Cookie。MediaCrawler客户端源码展示的是 MediaCrawler 自己直连请求的签名方式,不是本流程的步骤。
链接打不开,下一步怎么处理?
先核对复制的链接确实指向目标笔记。手里有完整笔记链接或已确认的笔记 ID 时,改用链接或 ID 继续;否则保留原链接、返回消息和 request_id,把这篇笔记列为待补材料。返回结果的处理方法见业务错误问答。
按价格页的当前价格规划。只读评论的任务只计评论页;需要描述时才加详情查询,已有结果直接复用。
用本地小工具准备请求(可选)
保存下方的 prepare_note_request.py。已知内容类型时选对应类型,任务是评论研究时选 comments。prepare_note_request.py 接受一个 24 位十六进制笔记 ID,或列明分享域名上的一个完整 HTTPS URL;xiaohongshu.com 长链接必须带 /explore/NOTE_ID 或 /discovery/item/NOTE_ID 路径,主页和登录页不是笔记目标。脚本会拒绝整段分享文案、带账号密码的 URL、端口、片段和其他域名。脚本比 API 更严格,API 可能接受其他 share_text 格式。prepare_note_request.py 不联网、不展开短链,也不检查笔记是否存在。
示例里的 ID 只是示意,换成自己已核实的 ID,或用引号把真实 URL 作为一个参数传入。URL 可能含访问令牌,请求文件要私有保存,不要贴到公开工单。生成的文件只有 action/params,不含 API Key 或浏览器请求头,也不会覆盖已有文件。执行前核对所选动作和当前价格,再用通常的私有 Bearer 头提交文件:
只有上面这条 curl 会产生调用,不要用示例 ID 执行这条 curl。按上文步骤核对返回的动作和目标笔记身份,评论任务接着走完整的评论导出流程。短链后缀仍然不是笔记 ID;内容缺失时停下批次核查,不要自动改用另一个详情动作重试。

