小红书数据挖掘与分析工具，通过 CDP 协议抓取笔记和评论，结合 LLM 进行结构化提取与报告生成。
npx claudepluginhub xueyouluo/rednote_mining小红书数据挖掘与分析工具插件，支持关键词搜索、笔记采集、LLM 结构化提取、实体归一化和报告生成。
xueyouluo小红书数据挖掘与分析工具。通过 Chrome DevTools Protocol (CDP) 抓取笔记和评论，结合 LLM 进行结构化提取与报告生成，无需逆向 API 签名。
本项目是一个 Claude Code 插件，安装后可通过 /rednote-mining:xxx 命令直接使用。
1. 在 Claude Code 中添加插件市场：
/plugin marketplace add xueyouluo/rednote_mining
2. 安装插件：
/plugin install rednote-mining@rednote-mining
3. 初始化环境（首次使用）：
/rednote-mining:setup
setup 命令会引导你完成依赖安装、API Key 配置和 Chrome 登录，全程交互式进行。插件安装时代码已复制到本地 cache，无需单独克隆项目。
| 命令 | 说明 |
|---|---|
/rednote-mining:setup | 初始化环境（首次使用必须先运行） |
/rednote-mining:search <关键词> | 搜索小红书笔记 |
/rednote-mining:crawl <关键词> | 批量爬取笔记和评论 |
/rednote-mining:note <feed-id> <xsec-token> | 获取单篇笔记详情 |
/rednote-mining:comments <feed-id> <xsec-token> | 获取笔记评论 |
/rednote-mining:rednote-research | 完整数据挖掘与分析工作流（见下方说明） |
这是本插件的核心 skill，适合对某个主题做深度研究。告诉 Claude 你想分析的主题，它会自动完成全套流程：
帮我分析小红书上关于"防晒霜推荐"的内容
搜索小红书"杭州赏花"话题并出报告
用小红书数据研究"上海咖啡店"
六步自动化流程：
Step 1: Claude 生成搜索关键词 → 用户确认
Step 2: 爬取笔记与评论 → raw_notes.json
Step 3: LLM 分析样本，提出结构化 schema → 用户确认
Step 4: LLM 批量提取结构化数据 → extracted_data.json
Step 5: LLM 实体归一化（地名/品牌合并）→ normalized_data.json
Step 6: Claude 分析数据，生成报告 → report.md 或 report.html
所有中间文件保存在 analysis/{主题}/ 目录下，支持断点续跑。
不使用插件系统，也可以直接克隆仓库使用：
git clone https://github.com/xueyouluo/rednote_mining.git
cd rednote_mining
uv sync
cp .env.example .env
# 编辑 .env 填入 ARK_API_KEY 和 ARK_MODEL
详细使用说明见 rednote_miner/README.md。