convez.ai
SkillAutomaçãoAvançado
huanyuzhilv

Gerador de Roteiros de Viagem com IA

huanyuzhilv/skills-travel-planner

Converta briefings de viagem em roteiros HTML/PDF entregáveis em um comando

Ver no GitHub
BomPluginScore · de 0 a 100

Skill de IA que converte briefings de itinerários simples (txt/docx) em roteiros estruturados JSON e HTML/PDF prontos para clientes, enriquecidos com imagens de plataformas chinesas (Xiaohongshu, Fliggy) e opcionalmente polidos por LLM. Integra-se nativamente com Cursor, Claude Code e Codex.

Instalação

$npx convez-ai huanyuzhilv/skills-travel-planner

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
16
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v1.0.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Consultores de turismo customizado gerando roadbooks automatizados
  • Agentes de IA criando itinerários estruturados a partir de descrições textuais
  • Produção em lote de roteiros de viagem com enriquecimento automático de imagens

Veredito

Ferramenta especializadae robusta para automação de geração de roteiros de viagem, com pipeline completo de intake, enriquecimento e entrega. Melhor para consultores de turismo e agentes de IA com demandas específicas de formatação e integração com APIs chinesas.

README

A tradução para o português deste README ainda está na fila.

skills-travel-planner — 开源 AI 路书生成工具

English: Open-source AI roadbook / travel itinerary generator for Cursor, Claude Code & Codex agents.
Converts txt/docx itinerary briefs → structured tripData.json → client-ready HTML/PDF roadbooks with Xiaohongshu image enrichment, optional LLM copywriting, and FlyAI hotel data.
One-command deliver: python3 scripts/deliver_roadbook_v2.py tripData.json output.html --check-in YYYY-MM-DD --check-out YYYY-MM-DD

面向定制游顾问与 AI Agent(Cursor / Claude Code / Codex) 的专业 路书(Roadbook)生成 Skill。
把 txt/docx/截图里的简版行程,自动变成结构化 tripData.json 与客户可交付的 HTML/PDF 路书。

关键词:AI 路书生成、AI 行程单、定制游行路书、travel itinerary generator、roadbook generator、Agent Skill、小红书配图、LLM 文案润色。

License: MIT Website Release

与其他方案对比

skills-travel-plannerChatGPT 聊行程Word/Notion 模板通用 trip planner App
输出tripData.json + 交付级 HTML/PDF纯文本手工排版App 内行程
Agent 集成Cursor / Claude Skill 原生无 Skill 规范无无
配图小红书 + 飞猪自动搜图无或手动手动有限
一键交付流水线deliver_roadbook_v2.py无无无
开源可 forkMIT否否否

特性

  • Intake:解析简版行程表(txt/docx)→ 结构化 tripData.json
  • Enrich:每日正文(小红书 + 可选 LLM)、住宿简介(飞猪 FlyAI)、亮点/费用/服务文案
  • 配图:TikHub 小红书搜索 + 飞猪/Wikimedia 兜底链,strict https 校验
  • 交付:一键 deliver_roadbook_v2.py 生成 roadbook-v2 HTML,可导出 PDF/长图

快速开始

git clone https://github.com/huanyuzhilv/skills-travel-planner.git
cd skills-travel-planner
cp .env.example .env
# 编辑 .env:填入 TIKHUB_API_KEY(https://user.tikhub.io 申请)
# 可选:OPENAI_API_KEY 或 DEEPSEEK_API_KEY(LLM 润色,见 docs/deepseek-llm-setup.md)

# 从简表生成路书目录
python3 scripts/roadbook_intake.py \
  --input docs/examples/guizhou-brief.txt \
  --output-dir generated-roadbooks/demo \
  --render --html-name demo.html

# 一键交付(须填写入住/离店日期)
python3 scripts/deliver_roadbook_v2.py \
  generated-roadbooks/demo/tripData.json \
  generated-roadbooks/demo/demo.html \
  --check-in 2026-05-01 \
  --check-out 2026-05-07

或使用 npm:

npm run roadbook:deliver -- tripData.json output.html --check-in YYYY-MM-DD --check-out YYYY-MM-DD

安装为 Agent Skill

./install.sh              # 交互式安装到 Claude Code / Codex
./install.sh --user       # 用户级安装
curl -fsSL https://raw.githubusercontent.com/huanyuzhilv/skills-travel-planner/main/setup.sh | bash

安装后 Agent 应阅读 AGENTS.md(交付禁令)与 skill.md(完整规范)。

环境变量

变量说明
TIKHUB_API_KEY推荐 — 小红书搜索/配图/正文(TikHub)
OPENAI_API_KEY可选 — 每日正文与亮点 LLM 润色(优先)
DEEPSEEK_API_KEY可选 — DeepSeek 替代 LLM(见 docs/deepseek-llm-setup.md)

密钥写入仓库根 .env(勿提交);scripts/repo_dotenv.py 会在 deliver 时自动加载。

可选依赖

工具用途
flyai飞猪酒店/交通配图
TikHub MCPCursor 内小红书搜索(见 .cursor/mcp.json 示例)
pip install -r requirements-roadbook-images.txt感知哈希去重(可选)

文档

可选后端集成

默认交付保留远程 https 配图 URL。若你有自有 CMS/CRM,可在后端将配图与品牌 Logo(roadbook-images/logo-brand-wdtrip.png)转存对象存储;Skill 侧仅维护 tripData.json 与 HTML 渲染。

License

MIT © huanyuzhilv

Ver o original no GitHub

Bom para

Relacionados