Skip to content

QUICK_START.md

Latest commit

 

History

History
214 lines (150 loc) · 5.02 KB

QUICK_START.md

File metadata and controls

214 lines (150 loc) · 5.02 KB

⚡ 5分钟快速上手指南

🎯 目标

5分钟内完成安装并导出第一个CSV文件！

⏱️ 第1分钟：安装插件

步骤1：下载插件文件夹

  • 下载整个 chrome-extension 文件夹到你的电脑

步骤2：打开Chrome扩展页面

  • 地址栏输入：chrome://extensions/
  • 回车

步骤3：加载插件

  1. 打开右上角"开发者模式"开关 ✅
  2. 点击"加载已解压的扩展程序"
  3. 选择 chrome-extension 文件夹
  4. 完成！

没看到图标？ 点击Chrome右上角拼图🧩→找到插件→点📌固定

⏱️ 第2-3分钟：打开小红书

步骤1：访问小红书

https://www.xiaohongshu.com

步骤2：找一个热门帖子

  • 随便点击一个有很多评论的帖子
  • 进入帖子详情页

步骤3：检查插件状态

✅ 正常情况：

  • 页面右侧出现悬浮工具栏
  • 工具栏显示帖子标题和作者信息
  • 插件图标是彩色的

❌ 异常情况：

  • 没有悬浮工具栏 → 刷新页面（F5）
  • 插件图标是灰色 → 检查是否在帖子详情页

⏱️ 第4分钟：抓取评论

方式A：使用悬浮工具栏（推荐）

  1. 找到页面右侧的悬浮工具栏
  2. 点击 ▶️ 开始抓取 按钮
  3. 观察评论数增加
  4. 等待自动完成（状态显示"抓取完成"）

方式B：使用插件弹窗

  1. 点击Chrome工具栏的插件图标
  2. 在弹窗中点击 ▶️ 开始抓取
  3. 观察评论数增加
  4. 等待完成

提示：

  • 页面会自动滚动，这是正常现象
  • 评论越多，时间越长（通常1-3分钟）
  • 可以点击"停止"按钮随时中断

⏱️ 第5分钟：导出数据

步骤1：点击导出按钮

  • 悬浮工具栏：点击 📥 导出CSV
  • 或插件弹窗：点击 📥 导出CSV

步骤2：选择保存位置

  • Chrome会弹出保存对话框
  • 选择文件夹（建议：桌面）
  • 点击"保存"

步骤3：打开CSV文件

  • 找到刚保存的文件（例如：小红书评论_帖子标题_时间戳.csv）
  • 双击用Excel打开
  • 查看抓取的数据

🎉 恭喜！你已经成功导出了第一个评论数据文件！

📊 验证数据

打开CSV文件，应该看到以下列：

| 帖子ID | 帖子标题 | 发帖人昵称 | 评论ID | 评论内容 | 评论人昵称 | IP属地 | ... |

检查点：

  • ✅ 有数据（不是空文件）
  • ✅ 中文正常显示（不乱码）
  • ✅ 评论数和插件显示一致
  • ✅ 包含IP属地信息

🎓 进阶技巧

技巧1：批量抓取多个帖子

  1. 打开第一个帖子 → 抓取 → 导出
  2. 打开第二个帖子 → 抓取 → 导出
  3. 重复...

提示： 每个帖子会生成独立的CSV文件，文件名包含时间戳

技巧2：只抓取部分评论

  1. 点击"开始抓取"
  2. 评论数达到你需要的数量时
  3. 点击"停止"
  4. 导出

技巧3：重新抓取

如果对结果不满意：

  1. 刷新页面（F5）
  2. 重新点击"开始抓取"
  3. 系统会清空之前的数据重新开始

技巧4：查看实时数据

不导出也能看数据：

  1. 按 F12 打开开发者工具
  2. 切换到"Console"标签
  3. 输入：xhsScraperDebug()
  4. 按回车，查看所有数据

🐛 遇到问题？

问题1：没有评论数据

原因： 可能帖子本来就没评论，或评论未加载

解决：

  1. 手动滚动到评论区
  2. 等待评论加载出来
  3. 再点击"开始抓取"

问题2：导出的CSV是空的

原因： 还没开始抓取就点了导出

解决：

  1. 确保评论数 > 0
  2. 等待"抓取完成"提示
  3. 再点击导出

问题3：CSV中文乱码

原因： Excel版本或编码问题

解决方法A： 用记事本打开

  • 右键CSV文件 → 打开方式 → 记事本
  • 文件 → 另存为
  • 编码选择：UTF-8
  • 保存后再用Excel打开

解决方法B： 导入到Excel

  • 打开Excel → 数据 → 导入文本
  • 选择CSV文件
  • 文件原始格式：65001 UTF-8
  • 完成导入

问题4：插件不工作

  1. 检查是否在小红书网站
  2. 刷新页面（F5）
  3. 检查插件是否启用（chrome://extensions/）
  4. 重新加载插件

📚 下一步

⏰ 时间回顾

✅ 第1分钟 - 安装插件
✅ 第2-3分钟 - 打开小红书
✅ 第4分钟 - 抓取评论
✅ 第5分钟 - 导出数据

总用时：5分钟 ⏱️

💡 小贴士

  1. 第一次使用建议选评论较少的帖子测试（10-50条评论即可）
  2. 评论多的帖子可能需要3-5分钟，耐心等待
  3. 导出前记得等待"抓取完成"提示
  4. 文件名包含时间戳，不用担心覆盖之前的文件
  5. 遇到问题先试试刷新页面（F5）

开始享受高效的评论数据收集吧！ 🚀