前言¶

手工做旅行方案时，景点信息散在小红书、抖音，交通要查 12306 和机票平台，住宿还要在多家 OTA 里比价，最后还要整理成可分享的表格或文档。Agent 能写文字，但若没有统一的数据抓取、比价和导出流程，输出往往停留在「建议清单」，难以对齐真实报价和结构化交付物。

下面介绍 SkillHub 社区技能 travel planner v2.0.0（坐标 @user_28299b48/travel-planner-v1-04）。它在 Agent 侧以标准 SKILL.md 说明工作流，并附带可独立运行的 Python 入口，把意图解析、多源数据、比价和 Excel/Word 输出串成一条链路。

这是什么¶

travel planner v2.0.0 是面向「生活出行」场景的 Agent Skill，版本 2.0.0，来源为 community，发布者为 user_28299b48，在 SkillHub 分类为 life-service。包内自述为 AI 智能旅行规划系统（v2.0 重写版），强调多平台真实数据抓取、GLM 智能分析、交通住宿比价，以及 Excel、Word 文档输出。

SkillHub 页面标注标签 requires_api_key=true：未配置密钥时部分能力会走内置兜底数据，无法拿到完整的真实景点、酒店与交通信息。

核心功能¶

以下能力均来自包内 SKILL.md 与 README.md 的模块说明，安装后可对照核对。

意图与行程引擎¶

• Intent Understanding：解析目的地、天数、人数、预算，以及旅行模式 A/B/C/D。
• Planning Engine：按模式优化行程，做预算分配与超支检测。

旅行模式与日均预算（每人）在文档中定义为：A 精选推荐 800 元、B 经济实惠 400 元、C 尊享豪华 2000 元、D 穷游背包 200 元；并对应不同的酒店档次与交通方式偏好。

数据采集与交通住宿¶

• Data Scraping：优先通过浏览器自动化抓取小红书、抖音等平台的真实搜索内容，并用 GLM 提取景点；失败时可降级。
• Transportation：12306 官网查询（文档明确仅查询、不购票），以及携程、去哪儿等机票信息，支持火车与飞机比价。
• Accommodation：携程、美团、去哪儿、小猪、木鸟等多平台酒店比价。
• Mapping：高德地图 Web API，用于地理编码、路线规划与周边搜索（可选）。

交付物¶

• Excel Output：7 个 Sheet——总览、每日行程、景点、住宿比价、交通比价、费用明细等。
• Word Document：旅游手册结构，含封面、目录、每日行程、景点、美食、住宿、交通、费用与注意事项等章节。

三层数据降级策略¶

当上一层获取失败时自动降级：

1. 浏览器自动化（依赖 autoglm-browser-agent 与 AutoClaw Edge CDP，默认端口 18800）
2. API（GLM、高德）
3. 本地兜底（文档示例提及兰州本地数据，以保证仍有输出）

安装与启用¶

通过 SkillHub 装入 Agent¶

官方页面给出的安装提示为：按 SkillHub 安装说明 安装坐标 @user_28299b48/travel-planner-v1-04。

先确认本机已有 SkillHub CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装脚本（文档推荐 CLI 与默认 Skill 一并安装）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。在 Cursor 中常用路径为 ~/.cursor/skills/：

skillhub install @user_28299b48/travel-planner-v1-04 --dir ~/.cursor/skills/

Claude Code 对应 ~/.claude/skills/；Codex 常见为 ~/.codex/skills/ 或项目下的 .agents/skills/。其他客户端路径以 skillhub.md 第四节为准。

安装后重启或刷新 Agent，使其加载新 Skill；具体行为以你所用客户端文档为准。

Python 依赖与 API 配置¶

若直接运行包内脚本，需在技能目录安装依赖：

pip install -r requirements.txt

requirements.txt 当前列为：requests、beautifulsoup4、openpyxl、python-docx、pyyaml。

在技能目录创建 config.yaml（与 main.py 同目录）。SKILL.md 建议复制 config.yaml.example；若包内未附带示例文件，可按文档字段手写：

glm_api_key: "sk-your-key-here"
amap_api_key: "your-amap-key-here"

• glm_api_key（推荐）：智谱开放平台 open.bigmodel.cn 创建，用于景点与美食的智能提取。
• amap_api_key（可选）：高德开放平台 lbs.amap.com 创建 Web 服务 Key，用于地图相关能力。

浏览器抓取无需单独 Key，但需已安装 autoglm-browser-agent skill，且 AutoClaw Edge 已启动并开启 CDP。

典型用法¶

命令行一次性生成方案¶

在技能安装目录执行（引号内为自然语言需求）：

python main.py "去兰州玩7天，2个人，预算8000元"

可选参数（来自 SKILL.md）：

--from FROM      出发站（默认北京 BPM/北京站）
--checkin DATE   入住日期 YYYY-MM-DD
--no-word        不输出 Word 文档
--output DIR     输出目录
--no-api-check   跳过 API 配置检查（不推荐）

首次运行会做 API 配置检测；未配置时会打印获取 Key 的步骤说明。

在 Cursor 等 Agent 中使用¶

将用户意图（目的地、天数、人数、预算、模式）交给已加载该 Skill 的 Agent，由 Agent 按 SKILL.md 调用 main.py 或遵循其中的模块分工与降级策略。需要真实社媒与 OTA 数据时，应提前满足浏览器自动化与 API 配置前置条件。

适用场景与注意¶

适合：需要把「搜攻略 + 查交通住宿 + 比价 + 导出 Excel/Word」合成一次交付的个人或小团队出行规划；已能接受自行申请 GLM、高德 Key，并在必要时配置 AutoClaw 浏览器环境。

限制与注意：

• 12306 仅查询，不支持购票。
• 小红书、抖音真实数据依赖 autoglm-browser-agent 与 CDP；缺省时走 API 或本地兜底，结果可能与线上一致度下降。
• SkillHub 元数据标记 requires_api_key=true；不配置 GLM 时核心抓取分析能力会受限。
• README 注明部分外部 API 需密钥且可能受平台策略限制；生产环境使用前请自行评估合规与频率限制。

SkillHub 统计（以页面抓取为准）：评分 100000，下载 868，安装 1。

结尾¶

travel planner v2.0.0 把旅行规划里分散的抓数、比价和文档导出收进一个可复用的 Skill 与脚本入口，适合作为 Agent 的 life-service 能力扩展。官方 SkillHub 页面：https://www.skillhub.cn/skills/user_28299b48/travel-planner-v1-04；API 入口：https://api.skillhub.cn/user_28299b48/travel-planner-v1-04。