小红书关键词内容调研

用户提供一个或多个搜索词以及每个词要抓取的篇数（1–20 篇），它在用户扫码登录自己的小红书账号后，以只读方式搜索该关键词下的公开笔记内容（不点赞、不评论、不私信、不发布），自动下载笔记图文和视频，用 PaddleOCR 提取图片文字、用 Whisper 转写视频音频，再通过 AI 逐篇分析每篇笔记的选题、结构、卖点和用户反馈，最终生成一份 Markdown 格式的《小红书内容研究报告》（可按配置复制到 Obsidian），供外贸营销团队做关键词内容和竞品研究参考——本质上是从"搜词"到"看同行前 N 篇笔记怎么写"的自动化调研流水线，与之前的 keyword-filter（筛选关键词）互补。

小红书关键词调研

本 Skill 自带研究程序，但不携带任何账号 Cookie、API Key、缓存、媒体或历史报告。首次使用或配置发生变化时读取 references/setup.md。

执行规则

提取两个必填参数：①搜索词，可填写一个或多个；②每个搜索词抓取的篇数，范围为 1–20。不得自行补默认值。
任意参数缺失时，只提示用户补充，不检查状态、不调用脚本、不开始抓取。提示中应明确写出：“搜索词可以填写多个，请同时指定每个搜索词需要抓取的篇数。”
两项参数齐全后，向用户复述：“搜索词：……；每个词：前 N 篇”，并等待明确确认。用户首次提供参数不等于确认；确认前不得执行。
运行 scripts/check-status.ps1，检查依赖、配置和登录状态。不得输出 Cookie 或 API Key。
依赖缺失时，只有在用户同意下载依赖后才运行 scripts/setup.ps1。
未登录时请用户运行 scripts/login.ps1 并扫码。不得绕过验证码、平台风控或访问限制。
状态正常后运行 scripts/run-research.ps1，将确认过的关键词用英文逗号连接后传入 -Keywords，将确认过的篇数传入 -TopN。
成功后确认 REPORT_PATH 指向的文件存在，返回报告路径和实际处理篇数。

失败处理

不删除 progress.json、原始数据、缓存或失败目录。
普通网络瞬断最多重试一次；登录失效、验证码、限流或风控立即停止。
单篇 OCR、转写或 AI 分析失败时保留降级结果，并明确提示人工复核。

数据边界

只使用状态查询、搜索和读取操作。
不执行点赞、收藏、评论、关注、私信、发布、投放或批量账号操作。
搜索结果受账号、时间和平台排序影响，不代表全平台固定排名。
报告仅供内部研究，不公开转载他人的完整内容。