xiaohongshu-search-summarizer

小红书搜索与总结

此技能可自动从小红书提取高质量的多模态内容（文本 + 图片），并主动协助你生成一份深度整合、分析性的最终报告。由于小红书采取了严格的反爬机制，直接发送 HTTP 请求或使用简单的抓取方法通常会导致 404 错误或访问受阻。此技能通过在有头浏览器窗口中使用 playwright-cli 模拟真实用户，从而原生绕过这些限制。

它分为两个不同的阶段：

阶段 1：子 Agent 收集数据

1. 在有头浏览器中模拟在小红书上搜索关键词。
2. 浏览图片轮播，确保完整加载排名前 N 篇笔记中的所有延迟加载图片。
3. 提取标题、描述、热门评论和所有高分辨率图片。
4. 将这些图片下载到本地目录，并生成原始数据文档（[keyword]_raw_data.md）。

阶段 2：AI 多模态综合分析（你的工作）

5. 你必须使用文件读取功能读取 [keyword]_raw_data.md 文件。
6. 在原始数据 Markdown 中，你会找到图片文件的路径。你必须使用文件读取 / 视觉功能打开这些图片文件路径，以实际读取并“查看”图片内容。如果跳过这一步，你读取的就只是文件名，而不是图片本身！
7. 你需要分析文本，总结真正有用的评论（剔除“私信我”等无关内容），并解读你刚刚查看的图片的语义内容（例如图表、指南、分步 UI 流程）。
8. 你需要将所有内容整合为一份精心编写的综合报告，而不是简单地按顺序罗列笔记。

依赖项

• playwright-cli（必须已加入 PATH）
• python3（用于下载图片并汇总原始数据 Markdown）
• Python 包 requests（pip install requests）——parse.py 用它来下载图片

---

使用说明

第 1 步：运行提取脚本

执行包装脚本 scripts/run.sh。它接受以下参数：

/bin/bash <skill_dir>/scripts/run.sh "YOUR KEYWORD" <MAX_POSTS> <OUTPUT_DIRECTORY>

• YOUR KEYWORD：要在小红书上搜索的词。
• <MAX_POSTS>：（可选，默认值 = 10）要扫描的热门笔记数量。
• <OUTPUT_DIRECTORY>：（可选，默认值 = ./）保存原始数据和图片的目录。

执行示例：

/bin/bash ~/.claude/skills/xiaohongshu-search-summarizer/scripts/run.sh "openclaw使用场景" 10 "./xhs_report_openclaw_scenarios"

第 2 步：读取原始数据和图片

Bash 脚本成功运行后，进入 OUTPUT_DIRECTORY，并使用文件读取功能读取生成的 [keyword]_raw_data.md 文件。

在此文件中，你会找到描述、评论，以及指向 post_X_img_Y.webp 或 post_X_img_Y.jpg 的文件路径。

第 3 步：综合与总结

**这是最关键的一步。**不要直接将原始 Markdown 文件返回给用户。请撰写一份经过润色、内容全面的 Markdown 报告，以逻辑清晰的方式重新组织信息，同时保留较高的细节丰富度。

请严格遵守以下整理规则：

• 不要逐条列出帖子（例如，避免使用“帖子 1：……帖子 2：……”）。
• **查看图片：**必须使用文件读取和视觉能力，解读原始数据目录中的 .webp 或 .jpg 图片文件。
• **详细且全面地综合：**提供高度详细的总结，涵盖不同帖子中的多种观点、细微差异和具体示例。避免过度概括或丢失重要背景；保留信息的丰富性和多样性。
• **提取并整合主题：**按照概念、步骤、反复出现的主题或优缺点对观点进行归类。
• **评估评论：**将有价值评论中的见解直接融入核心叙述。跳过无用或重复的评论，但保留评论区中的不同观点或有帮助的反驳意见。
• **结合图片：**在最终报告中直接嵌入最相关、质量最高的图片，以支持分析要点。根据视觉能力所观察到的内容，描述图片所表达的含义。
• **保存到 OUTPUT_DIRECTORY：**使用文件写入能力，将精心整理的最终 Markdown 报告直接保存到与原始数据相同的 <OUTPUT_DIRECTORY> 中（例如 <OUTPUT_DIRECTORY>/[keyword]_synthesis.md），并将文件路径告知用户。

错误处理

如果在调用浏览器时遇到 404 Not Found 或“元素不可见”错误：

• 请注意，小红书可能会要求登录验证。如果网站暂停并等待登录，请让用户检查 playwright-cli 浏览器窗口并手动完成必要的身份验证，然后再次运行脚本。