# 小红书旅行规划助手

`旅行规划` `小红书` `爬虫` `自动化` `可视化` `Python`

# XHS Travel Planner - 小红书旅行规划助手 🚀

这是一个基于 **Antigravity (Gemini 2.0 Agent)** 构建的技能转换器，旨在通过自动化脚本帮助你从小红书上高效收集、分析并可视化旅行攻略数据。

## 🌟 核心功能

- **自动化爬取**：使用 `patchright` 驱动的浏览器自动化，支持搜索目的地并提取笔记标题、作者、链接及互动数据。
- **智能分类**：自动将收集到的内容按 `交通`、`住宿`、`饮食`、`优惠`、`学生`、`攻略` 等维度进行分类。
- **结构化可视化**：
    - 生成 **Mermaid 语法** 的思维导图（`mindmap.mmd`）。
    - 生成完整的 **Markdown 旅行报告**（`黄山_攻略.md`），附带直接访问链接。
    - 提供 **HTML 离线查看器**，无需专业编辑器即可查看精美导图。

## 🛠️ 反检测与隐私保护

- **安全第一**：内置 `.gitignore` 保护，绝不上传您的 `cookies` 或个人隐私数据。
- **拟人化行为**：模拟滚动、随机 3-8 秒延迟、每 10 篇自动休息，最大程度降低封号风险。
- **一次登录**：支持 Cookie 复用，仅需首次手动登录，后续全自动运行。

## 📖 快速上手

### 1. 安装依赖
```bash
pip install patchright playwright requests
playwright install chrome
```

### 2. 初始化登录
```bash
python .agent/skills/xhs-travel-planner/scripts/scraper.py --login
```

### 3. 一键生成攻略（以黄山为例）
```bash
# 1. 爬取
python .agent/skills/xhs-travel-planner/scripts/scraper.py --destination "黄山" --limit 30
# 2. 分析
python .agent/skills/xhs-travel-planner/scripts/analyzer.py --input xhs_results_latest.json
# 3. 生成报告与导图
python .agent/skills/xhs-travel-planner/scripts/visualizer.py --destination "黄山"
```

---
*由 Antigravity AI 用 ❤️ 创作*