Et1enneee/tripscout-skill

# TripScout [中文版](README.zh-CN.md) · **无需任何 API 密钥。适用于任何具有网页搜索功能的 LLM 主机。** 将 TripScout 置入 Claude Desktop / Cursor / Codex / Trae / Copilot / 通义灵码 —— 你的 LLM 负责搜索，TripScout 提供策略。 ## 排查员 / 斥候矩阵 | # | 排查员 | 工具 | 研究内容 | |---|---|---|---| | 1 | 酒店 | `research_hotel` | 6平台比价、取消陷阱、用户评价 | | 2 | 航班 | `research_flight` | 6平台航班搜索、行李陷阱、双币种显示（人民币+美元） | | 3 | 签证 | `research_visa` | 官方签证要求、电子签 vs 落地签 vs 使馆签 | | 4 | 铁路 | `research_rail` | 火车票比价、铁路通票 vs 单程票 | | 5 | 租车 | `research_car` | 租车比价、保险（CDW）及里程陷阱 | | 6 | 漫游 | `research_roaming` | eSIM / 当地SIM / 漫游套餐对比 | | 7 | 报销 | `research_reimburse` | 每日津贴标准、增值税退税、收据清单 | | ★ | **旅行** | `research_trip` | **全能版**：一次性生成全部 7 个策略 | ## 快速开始 ``` git clone https://github.com/Et1enneee/tripscout-skill cd tripscout-skill uv sync uv run tripscout # all-in-one # 或选择任一单独的巡检工具： uv run tripscout-hotel uv run tripscout-flight uv run tripscout-visa # tripscout-rail, tripscout-car, tripscout-roaming, tripscout-reimburse ``` 无需令牌。无需 `.env` 文件。无需 API 密钥。 ## 连接你的 LLM 智能体 TripScout 遵循 **MCP 标准协议**。每个工具都是一个独立的 MCP 服务器——根据需要添加即可。 ### Claude Desktop 配置（全部 8 个工具） ``` { "mcpServers": { "tripscout": { "command": "uv", "args": ["run", "tripscout"], "cwd": "/absolute/path/to/tripscout-skill" }, "tripscout-hotel": { "command": "uv", "args": ["run", "tripscout-hotel"], "cwd": "/absolute/path/to/tripscout-skill" }, "tripscout-flight": { "command": "uv", "args": ["run", "tripscout-flight"], "cwd": "/absolute/path/to/tripscout-skill" } } } ``` 按需添加 `tripscout-visa`、`tripscout-rail`、`tripscout-car`、`tripscout-roaming`、`tripscout-reimburse`。或者直接使用 `tripscout` 获取全能版。 ## 工作原理 ``` User: "Plan my trip: Beijing -> Tokyo Jul 1-5" | v Host LLM calls research_trip(...) | v TripScout generates 7 structured research protocols |-- Flight protocol (6 search queries) |-- Hotel protocol (6 search queries) |-- Visa protocol (6 search queries) |-- Rail protocol (6 search queries) |-- Car rental protocol (6 search queries) |-- Roaming/eSIM protocol (6 search queries) +-- Reimbursement protocol (6 search queries) | v Host LLM executes ALL 42 search queries | extracts fields per each schema | applies trap rules per each protocol | fills each template v Complete trip briefing -> User reads everything in one chat ``` **零服务端输入/输出。零 API 密钥。宿主 LLM 即搜索引擎。** ## 架构 ``` tripscout-skill/ |-- pyproject.toml |-- src/tripscout/ | |-- schemas.py # 8 Query models (pydantic) | |-- protocol_hotel.py # 5 blocks, 6 search queries, 3 traps, 2 recos | |-- protocol_flight.py # dual currency CNY+USD | |-- protocol_visa.py # .gov-first, e-visa > VOA > embassy | |-- protocol_rail.py # Trainline/Omio/Rail Europe/official operator | |-- protocol_car.py # CDW/mileage/young driver traps | |-- protocol_roaming.py # eSIM/local SIM/roaming/pocket WiFi | |-- protocol_reimburse.py # per diem/VAT/receipt checklist | |-- server_hotel.py # MCP tool: research_hotel | |-- server_flight.py # MCP tool: research_flight | |-- server_visa.py # MCP tool: research_visa | |-- server_rail.py # MCP tool: research_rail | |-- server_car.py # MCP tool: research_car | |-- server_roaming.py # MCP tool: research_roaming | |-- server_reimburse.py # MCP tool: research_reimburse | +-- server_trip.py # MCP tool: research_trip (all-in-one) |-- tests/ | +-- test_smoke.py # 11 tests covering all 7 protocols |-- README.md / README.zh-CN.md +-- LICENSE ``` **仅有两个依赖：`mcp`、`pydantic`。** ## 发展路线图 - [x] **v1.0** · 7 个排查员，8 个工具，全能版 `research_trip` - [ ] **v1.5** · 可选数据源适配层（适用于无网页搜索功能的主机） - [ ] **v2.0** · 多语言协议输出（英语 / 中文 / 日语） - [ ] **v2.5** · 缓存价格快照 (Upstash Redis) - [ ] **v3.0** · TripScout 餐饮与观光排查员 ## 许可证 MIT

标签：AI助手, eSIM, LLM集成, MCP协议, 价格比较, 商务旅行, 插件化, 旅行科技, 旅行规划, 无API密钥, 漫游, 火车票比较, 租车服务, 签证查询, 系统triage, 自动化旅行, 航班搜索, 评论分析, 财务报告, 费用报销, 逆向工具, 酒店预订