小红书笔记检索与评论选题线索
按关键词查找小红书笔记，阅读内容和评论，把读者反复问的问题整理成下一篇的选题线索。
适用场景
准备做一个新题目，想先看看小红书上已有的讲法，或想知道读者看完仍有哪些疑问时可以用。它提供笔记搜索、详情与评论读取，帮助Agent拿到研究材料；不是只凭一个关键词生成标题的策划模板。
主要功能
按关键词寻找值得阅读的样本
搜索与你的领域、问题或产品有关的笔记，可以按热门或最近发布排序，并区分视频与图文。先看有哪些题目、怎样表达，再挑出与自己受众有关的作品深入阅读；搜索结果不等于完整热榜。
把标题和实际内容放在一起看
读取选中的笔记详情，比较标题承诺和正文、图文或视频信息是否对应。结果可以按结构化格式交给Agent整理，保留笔记链接和可获得的互动字段，避免只看标题就判断这个题目值得做。
从评论里的追问发现内容机会
读取评论和回复，找出读者没有看懂、想知道细节或意见不同的地方。工具负责取回评论；把问题归类、判断哪些适合发展成自己的内容，需要Agent结合账号定位分析，不是CLI自动做出的热度预测。
补充话题和对标账号的研究材料
可以搜索话题、用户，阅读公开主页和作品列表，辅助比较同一问题有哪些讲法。分类热门与推荐内容也可作为样本入口；它们会受账号和接口状态影响，不代表全平台的客观排名。
准备资料
准备几个具体关键词、目标读者和想解决的问题，例如“小户型收纳”“儿童用品分类”。告诉Agent这次只做只读调研，并限制样本数量。实际取数需要可用的小红书登录状态；扫码、验证码或授权由你在自己的环境里完成，不要把Cookie贴到公开对话或交给本站。
使用方法
先安装工具，再确认登录状态
安装固定版本Skill及CLI，确认Python和依赖可用。让Agent先检查状态，再由你完成必要的登录或验证；认证没有成功时先说明原因，不继续假装读取了笔记。
搜索样本，阅读笔记与评论
先用少量关键词各取一页，挑选与你的读者有关的样本，继续读取详情和评论。保留原始链接、搜索条件与读取时间；需要更多材料时再明确数量，不默认无限翻页。
整理问题，再决定下一篇讲什么
让Agent区分原文事实和分析判断，把重复追问、遗漏步骤和不同意见整理成候选方向。每个方向说明适合谁、解决什么问题及依据哪条笔记或评论；没有取到资料就如实报告。
交付内容
工具返回搜索、笔记详情和评论等结构化数据，Agent可据此整理样本表、读者问题和候选选题。候选选题是对材料的分析，需要你结合自己的经验和可提供的信息取舍；本项不承诺播放、收藏或涨粉结果。
- 带来源的笔记研究样本
- 评论追问与内容缺口
- 基于样本的候选选题线索
使用条件与费用
- 这是原生SKILL.md配套命令行工具，需要Python 3.10+；项目定义xhs入口，包含HTTP、浏览器Cookie、签名和扫码登录等依赖。装Skill文件不等于CLI与依赖已经安装好，需由Agent确认。
- 上游pyproject.toml声明Apache-2.0，但固定仓库未附独立LICENSE全文，本次许可核验止于项目元数据声明。运行时使用自己的Agent模型，模型和环境费用按所用服务计算；本批本站没有新增付费调用。
- 实际查询通常需要有效登录态。上游采用非官方逆向接口，包含认证与写入操作；本页用途和示例限只读研究，不将安装视为授权点赞、发评论或发布。
安装细节
安装和使用命令已经备好，按右侧步骤操作即可。需要查看技术配置时，可参考作者说明。
- 原生SKILL.md与完整根目录CLI源码，固定版本安装CLI并确认xhs入口；尚未在本站实际安装。
- Python 3.10+及项目声明的CLI依赖。
使用提醒
- 上游默认pytest排除smoke真实接口测试，CI还显式忽略test_integration.py。单元测试和打包成功不能证明当前账号、登录或真实小红书接口始终可用。
- 项目元数据仍标Alpha。接口变化、验证码和账号状态会影响结果；不要把空结果写成没有需求，也不要把热门排序当真实曝光或全平台排名。
- 上游Skill触发范围覆盖所有小红书操作，示例也包含写入命令。本页仅推荐搜索、阅读和评论研究；超出只读任务的操作应另行得到用户明确指令。
- 本次核对固定版本源码、依赖、认证边界、安装和上游测试记录；未安装CLI、提取Cookie、扫码、调用平台接口或实际生成选题。来源区标明核验范围。
作者与来源
已核对作者文档，未进行运行测试。
查看关键事实的原文依据
Setup
## Setup ```bash # Install (requires Python 3.10+) uv tool install xiaohongshu-cli # Or: pipx install xiaohongshu-cli # Upgrade to latest (recommended to avoid API errors) uv tool upgrade xiaohongshu-cli # Or: pipx upgrade xiaohongshu-cli ``` ## Authentication **IMPORTANT FOR AGENTS**: Before executing ANY xhs command, check if credentials exist first. Do NOT assume cookies are configured. ### Step 0: Check if already authenticated ```bash xhs status --yaml >/dev/null && echo "AUTH_OK" ||来源文档：skill
Reading
### Reading | Command | Description | Example | |---------|-------------|---------| | `xhs search <keyword>` | Search notes | `xhs search "美食" --sort popular --type video` | | `xhs read <id_or_url_or_index>` | Read a note by ID, URL, or short index | `xhs read 1` / `xhs read "https://...?xsec_token=xxx"` | | `xhs comments <id_or_url_or_index>` | Get comments by ID, URL, or short index | `xhs comments 1` / `xhs comments "https://...?xsec_token=..."` | | `xhs comments <id_or_url> --all` | Get ALL来源文档：skill
Agent Defaults
## Agent Defaults All machine-readable output uses the envelope documented in [SCHEMA.md](./SCHEMA.md). Payloads live under `.data`. - Non-TTY stdout → auto YAML - `--json` / `--yaml` → explicit format - `OUTPUT=json` env → global override - `OUTPUT=rich` env → force human output ## Command Reference ### Reading | Command | Description | Example | |---------|-------------|---------| | `xhs search <keyword>` | Search notes | `xhs search "美食" --sort popular --type video` | | `xhs read <id_or_来源文档：skill
Python 3.10+及项目声明的CLI依赖。
requires-python = ">=3.10"来源文档：file7
项目元数据声明Apache-2.0，固定仓库没有独立LICENSE全文，核验止于声明。
license = "Apache-2.0"来源文档：file7
原生SKILL.md与完整根目录CLI源码，固定版本安装CLI并确认xhs入口；尚未在本站实际安装。
## Setup ```bash # Install (requires Python 3.10+) uv tool install xiaohongshu-cli # Or: pipx install xiaohongshu-cli # Upgrade to latest (recommended to avoid API errors) uv tool upgrade xiaohongshu-cli # Or: pipx upgrade xiaohongshu-cli ``` ## Authentication **IMPORTANT FOR AGENTS**: Before executing ANY xhs command, check if credentials exist first. Do NOT assume cookies are configured. ### Step 0: Check if already authenticated ```bash xhs status --yaml >/dev/null && echo "AUTH_OK" ||来源文档：skill
内容有误？告诉我们
01 安装到 Agent
复制安装命令，发给你正在使用的 Agent。
查看完整安装命令
发送后，等待 Agent 回复安装结果。
首次使用请先安装；已安装可直接填写下方任务。
02 填写你的任务
复制后，粘贴到已安装 Skill 的 Agent 对话。
