Travel Hacking Toolkit

旅行黑客工具包

人工智能驱动的旅行黑客，包括积分、里程和奖励航班。插入技能和MCP服务器 OpenCode, 克劳德代码，以及 法典.

让你的人工智能为你找到一架飞往东京的60000英里商务舱航班。它将搜索27个里程计划的奖励可用性，与现金价格进行比较，检查您的忠诚度余额，并告诉您最佳游戏。

快速开始

通过插件安装（无克隆）

使用该工具包的最简单方法。选择您的工具：

克劳德代码

在Claude Code内部，运行：

/plugin marketplace add borski/travel-hacking-toolkit
/plugin install travel-hacker@borski

完成。42项技能，6台MCP服务器（5台免费+需要密钥的LiteAPI），以及 travel-hacker 安装了子代理。跑 claude 从任何地方，让它计划一次旅行。

要验证安装，请运行 /travel-hacker:getting-started 克劳德代码内部。它告诉您配置了哪些API键，并指向本地设置脚本以查找缺失的键。或者在你的壳里： claude plugin list | grep travel-hacker 应该显示插件。

法典

在您的终端中：

codex plugin marketplace add borski/travel-hacking-toolkit

然后启动Codex，插件出现在 /plugins.Codex从回购中提取市场目录(.agents/plugins/marketplace.json)以及来自的插件清单 plugins/travel-hacking-toolkit/.codex-plugin/plugin.json，因此install是一个命令。

合作（Claude Desktop的代理小组）

合作本身不会暴露 /plugin slash命令，因此您无法从Cowork聊天中安装插件。首先通过Claude Code安装；Cowork会自动接受它，因为两者共享 ~/.claude/plugins/.

1. 在您的终端，跑 claude
2. 克劳德密码，从运行两个安装命令 上文克劳德代码部分
3. 开放式合作 克劳德桌面内部。插件已经存在。

Claude Desktop的聊天UI尚不支持插件格式，因此请在同一应用程序中使用Cowork以获得完整体验。

配置API密钥

5个免费的MCP服务器（Skiplaged、Kiwi、Trivago、Ferryhopper、Airbnb）可以立即使用零密钥工作。现金航班和酒店搜索工作开箱即用。

要解锁奖励搜索和工具包的其余部分，您需要在shell中将API密钥设置为环境变量。运行本地安装脚本：

macOS/Linux/WSL/Git Bash：

bash  下面的技能表是从自动生成的 `skills/*/SKILL.md` frontmatter通过 `scripts/gen-skill-tables.sh`.编辑源frontmatter，而不是表。注册链接和API密钥URL位于 [API密钥和注册链接](#api-keys--signup-links) 下面的部分。

#### 编排

|技能|它的作用| API密钥|
|-------|-------------|---------|
| **颁奖日历** |跨日期范围内路线的最便宜奖励日期。日历网格视图。| Seats.aero Pro|
| **比较航班** |并行进行所有来源的统一航班比较。自动应用传输优化。|使用个人技能密钥|
| **比较酒店** |跨门户网站、元搜索和Airbnb的统一酒店比较。FHR/编辑堆叠检测。|使用个人技能密钥|
| **开始** |首轮入职培训。检测设置，指向设置键脚本，显示示例提示。|无|
| **计划旅行** |导游旅行计划。工具箱的英雄命令。|无|
| **行程计算器** |现金与积分的决定用数学来回答。转移比率、税收、机会成本。|无（免费，本地数据）|
| **旅行计划** |完整的旅行计划。航班+酒店+积分一次到位。|使用个人技能密钥|

#### 航班

|技能|它的作用| API密钥|
|-------|-------------|---------|
| **行李袋** |主要现金价格。每个票价等级的真实GDS数据。|行李架|
| **谷歌航班** |浏览器自动Google Flights。包括西南航空在内的所有航空公司。|无（需要代理浏览器）|
| **IGN** |快速REST API现金价格。套利的市场选择。|伊格纳夫（1000免费）|
| **座位图** |飞机座位图、机舱尺寸、座位建议。|无（需要代理浏览器）|
| **航空座椅** |27个里程计划均可获得奖励。| Seats.aero专业版/合作伙伴|
| **西南** |SW票价等级、积分定价、同伴通票。更改航班价格下降监控。Docker： `ghcr.io/borski/sw-fares`.|无（需要Patchright）|
| **维基百科机场** |通过维基百科机场页面进行路线发现和航空公司服务健全性检查。答案“X航空公司飞A吗→当票价工具不一致或错过了模糊的地区服务时，“B”和“什么机场为目的地Y服务”。没有API键。|无|

#### 信用卡旅游门户

|技能|它的作用| API密钥|
|-------|-------------|---------|
| **美国运通旅行** |美国运通MR门户网站，提供航班、酒店、IAP折扣、FHR/THC福利。需要白金。Docker： `ghcr.io/borski/amex-travel`.|无（需要Patchright）|
| **bilt** |酒店和航班的Bilt Rewards旅行门户。比尔积分1.25 cpp。Home Away From Home酒店为金卡/白金卡会员提供300多美元的福利。|无（公共API）|
| **追逐旅行** |Chase UR门户网站提供航班、酒店、积分提升、编辑福利。需要蓝宝石。Docker： `ghcr.io/borski/chase-travel`.|无（需要Patchright）|

#### 酒店和住宿

|技能|它的作用| API密钥|
|-------|-------------|---------|
| **高级酒店** |按城市搜索4659家美国运通FHR/THC+Chase Edit酒店。堆积机会。|无（本地数据）|
| **拉皮达皮** |Booking.com酒店价格。|RapidAPI|
| **搜索引擎结果页API** |谷歌酒店搜索和目的地发现。| SerpAPI|
| **票务系统** |TicketsAtWork（EBG）企业福利门户网站。酒店、主题公园门票、景点、现场活动。通常比门户网站高出10-30%。Docker： `ghcr.io/borski/ticketsatwork`.|无（需要TaW帐户+Patchright）|

也使用 **猫途鹰** （在目的地下）用于酒店评级、排名、子评级和评论。

#### 忠诚度和积分

|技能|它的作用| API密钥|
|-------|-------------|---------|
| **美国航空公司** |A优势平衡和精英地位。AwardWallet不支持AA。Docker： `ghcr.io/borski/aa-miles-check`.|无（需要Patchright）|
| **awardwallet** |所有的忠诚平衡，精英地位，历史。|获奖钱包业务|
| **转让合作伙伴** |从信用卡积分到里程计划的最便宜转账方式。|无（本地数据）|
| **何处贷记** |50多个项目中按航空公司和预订舱位划分的里程收益率。|无（免费）|

#### 目的地和过境

|技能|它的作用| API密钥|
|-------|-------------|---------|
| **模糊图集** |任何目的地附近隐藏的宝石和不寻常的景点。|无（免费）|
| **德意志铁路** |通过开源的DB-vento客户端，在德国各地搜索德国联邦铁路（DB）列车，并进入AT/CH/NL/FR/BE。车站、行程、出发板。没有API密钥。与斯堪的纳维亚运输公司配对，实现全欧洲铁路覆盖。|无|
| **斯堪的纳维亚过境** |挪威、瑞典和丹麦的火车、公共汽车、渡轮。包括丹麦票价/区域定价。| Entur+Trafiklab+Rejsepanen|
| **猫途鹰** |酒店评级、餐厅搜索、景点评论、附近搜索。5K个电话/月。| TripAdvisor|

#### 参考和操作（按需自动加载）

这些技能承载了CLAUDE.md中曾经存在的深厚的机构知识。当代理遇到相关触发器时，它们会自动加载，因此主配置保持精简。

|技能|它涵盖了什么|
|-------|---------------|
| **联盟** |星空联盟、寰宇一家、天合联盟会员资格和最近的变化（SAS改为天合联盟、ITA改为星空联盟、夏威夷/斐济改为oneworld）。关键的跨联盟预订关系。 |
| **获奖情况** |根据计划规则，将奖励机票搁置。涵盖6个具有可靠保留的项目（AA 24小时在线、LH 5天、FB 3天、CX 2天、土耳其2天、维珍大西洋1-2天）、新加坡作为代理的自由裁量权以及负空间（UA/as/DL/Aerolan/BA/ANA/卡塔尔/韩国-大多数项目不允许保留）。 |
| **奖励甜蜜点** |传奇、卓越和良好的奖励赎回目录，包括当前利率和贬值历史。 |
| **预订指南** |预订流程、先存后转规则、主要节目的电话号码。 |
| **客舱代码** |合作伙伴可预订库存的IATA客舱代码（F/J/W/Y）和优惠票价等级代码（X/I/O）。 |
| **回退和弹性** |当每个工具都失败时该怎么办。逐个工具的回退路径。 |
| **航班搜索策略** |规范的多源搜索工作流程。源优先级（Duffel>Ignav>Google Flights>其他）、国际航线的市场选择、源精度层次结构、常见故障模式。 |
| **连锁酒店** |将品牌名称（威斯汀、假日酒店等）映射到连锁家庭和忠诚度计划。 |
| **经验教训** |来自真实搜索的来之不易的知识。强制性的Seats.aero工作流程、西南航空的具体细节、Companion Pass的数学计算、来源准确性、小市场警告、行李限制。在任何奖励航班搜索之前加载。 |
| **合作伙伴奖** |哪些计划机票哪些航空公司（联盟+双边）。将信用卡货币与预订计划进行交叉引用。可达性工作流程。 |
| **点数估值** |CPP公式、下限/上限规则、要避免的附加费繁重计划、转移奖金考虑、Chase Points Boost动态、机会成本。 |
| **环球** |RTW+太平洋圈+亚太圈+区域距离奖参考。13个正在运行的程序，4个已停止。 |
| **状态匹配** |每个项目的状态匹配规则，包括终身/每N年一次的警告、免费与付费礼宾服务、实际费用，以及作为替代方案的可续期卡。 |
| **中途停留** |奖励兑换的按节目中途停留规则。包括冰岛航空免费中途停留、Aeroplan、阿拉斯加Atmos、蓝天飞行、新加坡航线，以及没有中途停留计划的负空间（BA、AA、达美航空、捷蓝航空）。 |
| **转移奖金** |带有主要来源引用的主动信用卡转账奖金。告诉代理人在促销期间转移积分时的实际有效比率。 |

#### API密钥和注册链接

这些技能需要外部帐户或API密钥注册。看 [`.env.example`](.env.example) 对于完整的env-var列表（有些技能需要一个没有真正注册的env-vars，例如。 `scandinavia-transit` 需要一个 `ENTUR_CLIENT_NAME` 您选择自己作为Entur所需的标识标头）。

|技能|服务|链接|备注|
|-------|---------|------|-------|
| `duffel` |达夫| [duffel.com](https://duffel.com) |真正的GDS航班搜索。提供免费套餐。 |
| `ignav` 忽略。 [ignav.com](https://ignav.com) |快速航班搜索REST API。1000个免费请求，无需信用卡。 |
| `seats-aero` |Seats.aero| [seats.aero](https://seats.aero) |27个里程计划的奖励航班可用性。专业版（99美元/年）包括API访问。 |
| `rapidapi` |拉皮达皮| [网站 rapidapi.com](https://rapidapi.com) |市场；订阅Booking.com直播+谷歌航班直播。 |
| `serpapi` |SerpAPI| [蛇网](https://serpapi.com) |谷歌航班、谷歌酒店、旅游探索。 |
| `tripadvisor` |TripAdvisor| [www.tripadvisor.com/developers](https://www.tripadvisor.com/developers) |酒店/餐厅/景点数据。5K通话/月免费。 |
| `awardwallet` |AwardWallet| [business.awardwallet.com](https://business.awardwallet.com) |忠诚度计划平衡聚合器。需要业务层。 |
| `ticketsatwork` |Tickets At Work| [www.ticketsatwork.com](https://www.ticketsatwork.com) |企业福利门户。帐户需要雇主关系。相同的证书适用于Working Advantage、Plum、Beneplace（共享EBG后端）。 |
| `scandinavia-transit` |特拉菲克实验室（瑞典）| [网站：www.trafiklab.se](https://www.trafiklab.se) |瑞典过境。免费API密钥。每月30000个电话。 |
| `scandinavia-transit` |雷泽普兰（丹麦）| [labs.旅行计划.cn](https://labs.rejseplanen.dk) |丹麦过境。免费API密钥（需要应用程序）。每月50000次通话，仅限非商业用途。 |

## Docker镜像

五项技能作为Docker容器运行（通过Patchright实现浏览器自动化），外加一项共享技能 `patchright-docker` 它们都是基于基础映像构建的。所有六个映像都在GitHub容器注册表上公开，不需要进行身份验证。 `setup.sh` （以及 `setup.ps1` 在Windows上）根据您选择的工具自动提取所需的工具。

|图片|技能|目的|来源|
|-------|-------|---------|--------|
|  |（基础）|Patchright+Chromium+xvfb基础层，所有其他浏览器技能图像都基于该层构建| [外部](https://github.com/borski/patchright-docker) |

### 用法

Southwest: fare search + price drop monitoring

docker pull ghcr.io/borski/sw-fares:latest docker run --rm ghcr.io/borski/sw-fares --origin SJC --dest DEN --depart 2026-05-15 --points --json docker run --rm -e SW_USERNAME -e SW_PASSWORD ghcr.io/borski/sw-fares \ change --conf ABC123 --first Jane --last Doe --json

American Airlines: AAdvantage balance + elite status (not in AwardWallet)

docker pull ghcr.io/borski/aa-miles-check:latest docker run --rm -e AA_USERNAME=your_number -e AA_PASSWORD=your_pass ghcr.io/borski/aa-miles-check --json

Chase Travel: UR portal pricing, Points Boost, Edit hotels

docker pull ghcr.io/borski/chase-travel:latest docker run --rm -v ~/.chase-travel-profiles:/profiles -v /tmp:/tmp/host \ -e CHASE_USERNAME -e CHASE_PASSWORD \ ghcr.io/borski/chase-travel script /scripts/search_flights.py \ --origin SFO --dest CDG --depart 2026-08-11 --cabin business --json

Amex Travel: MR portal pricing, IAP discounts, FHR/THC hotels

docker pull ghcr.io/borski/amex-travel:latest docker run --rm -v ~/.amex-travel-profiles:/profiles \ -e AMEX_USERNAME -e AMEX_PASSWORD \ ghcr.io/borski/amex-travel script /app/search_flights.py \ --origin SFO --dest NRT --depart 2026-08-15 --cabin business --json

TicketsAtWork (also covers Working Advantage / Plum / Beneplace)

docker pull ghcr.io/borski/ticketsatwork:latest docker run --rm -e TAW_USER -e TAW_PASS ghcr.io/borski/ticketsatwork \ hotels --location "Carlsbad, CA" --checkin 2027-03-04 --checkout 2027-03-07 --json

### 在当地建设

要在本地构建任何映像，而不是从ghcr.io中提取：

docker build -t ghcr.io/borski/:local skills//

这 `Dockerfile` 在每个技能目录中显示图像中的内容。所有五个技能形象都建立在 `ghcr.io/borski/patchright-docker` 作为基础。

## 运作原理

### 技能

技能是标记文件，赋予你的人工智能专门的旅行黑客能力。它们有两种口味：

- **工具技能** (`duffel`, `seats-aero`, `southwest`等等）包装API、浏览器自动化和外部工具。它们包含端点文档、curl示例、有用的jq过滤器和分步使用说明。
- **参考技能** (`flight-search-strategy`, `points-valuations`, `alliances`, `lessons-learned`等）携带决定何时以及如何使用工具技能的机构知识。它们包含工作流规则、查找表和来之不易的经验教训，可以防止常见错误。

OpenCode、Claude Code和Codex都可以加载它们。技能使用 **渐进式披露**：每个人的名字和简短描述在会话开始时加载到上下文中。只有当代理决定使用技能时，它才会读取完整的SKILL.md。这使得始终加载的上下文保持较小，并允许工具包在不增加代理提示的情况下增长。

这 `skills/` 目录是规范的源代码。安装脚本可以是：

- 安装一个指向仓库技能和MCP配置的Codex插件
- 将它们复制到工具的全局技能目录(`~/.config/opencode/skills/` 或 `~/.claude/skills/`)
- 或者创建项目级符号链接，以便在从该目录工作时加载它们

### MCP服务器

MCP（模型上下文协议）服务器为您的AI提供了可以直接调用的实时工具。配置如下：

- `opencode.json` 用于OpenCode（从repo根目录自动发现）
- `.mcp.json` 对于Claude Code（从回购根自动发现）
- `plugins/travel-hacking-toolkit/.mcp.json` 用于Codex插件安装

Skiplaged、Kiwi.com、Trivago、Ferryhopper和Airbnb根本不需要设置。LiteAPI也是一个远程服务器，但需要在您的设置中配置API密钥。

**为什么Codex需要一个插件：** OpenCode和Claude Code都可以从repo本地配置文件中自动发现MCP服务器。Codex没有。它只从以下位置加载MCP服务器 `~/.codex/config.toml` 或者来自已安装的插件。该工具包附带了一个Codex插件（位于 `plugins/travel-hacking-toolkit/`)它捆绑了MCP配置，因此Codex用户可以获得与其他两个工具相同的开箱即用体验。 `setup.sh` 当您选择Codex选项时，会自动将其连接起来。

## 我应该使用哪种技能？

"Plan a trip to Paris" └─→ trip-planner (runs everything below automatically)

"Find flights SFO to CDG" ├─ Know exact dates? → compare-flights (all sources in parallel) └─ Flexible dates? → award-calendar (cheapest dates for a route)

"Find hotels in Paris" ├─ Best overall → compare-hotels (portals + metasearch + Airbnb) ├─ Premium programs → premium-hotels (FHR/THC/Edit) └─ Discount pricing → ticketsatwork (often beats portals 10-30%)

"Should I use points or cash?" └─→ trip-calculator (CPP analysis + opportunity cost) Reference: points-valuations (floor/ceiling rules)

"Which of my points should I use?" └─→ transfer-partners (cheapest transfer path) Reference: partner-awards (cross-alliance reachability)

"Why is this redemption flagged as poor value?" └─→ Reference skills: points-valuations, alliances, award-sweet-spots

"Why am I not finding award space?" └─→ lessons-learned (THE mandatory Seats.aero workflow rules)

"A tool failed. Now what?" └─→ fallback-and-resilience (per-tool recovery paths)

"How do I actually book this?" └─→ booking-guidance (booking flow, phone numbers, hold-before-transfer rule)

"Check my SW reservations for price drops" └─→ southwest (change flight monitor)

这 **编排技能** (`trip-planner`, `compare-flights`, `compare-hotels`)自动调用个人源技能。从这些开始，除非你需要一个特定的来源。

这 **参考技能** (`flight-search-strategy`, `points-valuations`, `partner-awards`, `alliances`, `award-sweet-spots`, `cabin-codes`, `hotel-chains`, `fallback-and-resilience`, `booking-guidance`, `lessons-learned`)自动加载相关上下文，提供深入的机构知识，而无需明确调用它们。

## 旅行黑客工作流程

核心问题： **“我应该烧掉积分还是付现金？”**

1. **搜索所有航班来源** --行李+伊格纳夫+谷歌航班+滑雪+新西兰元兑换现金。Seats.aero获奖。西南方向为SW点。Chase+Amex门户网站，用于积分支付。
1. **优化转账** — `transfer-partners` 找到从信用卡积分到提供最佳交易的忠诚度计划的最便宜路径。
1. **比较** — `trip-calculator` 显示了每个选项的CPP。更高的CPP=更好地利用积分。低于底价=支付现金。
1. **检查余额** --AwardWallet确认您有足够的积分。
1. **预订** --使用Seats.aero、Duffel或Ignav的预订链接。在航空公司网站上确认可用性之前，不要转移积分。

### 示例提示

"Plan a trip to Paris Aug 11-15 in business class" "Find me the cheapest business class award from SFO to Tokyo in August" "When's the cheapest time to fly SFO to NRT on points?" "Compare all options for SFO to CDG round trip" "Find hotels in Stockholm, include Airbnb" "Compare points vs cash for a round trip JFK to London next March" "What are my United miles and Chase UR balances?" "Check my Southwest reservations for price drops" "Find hidden gems near Lisbon" "How do I get from Oslo to Bergen by train?" "What's the seat pitch on Air France 83 in business class?" "How many AAdvantage miles do I have?" "Which FHR and Chase Edit hotels are in Stockholm? Any stacking opportunities?" "What's the Points Boost rate for SFO to Tokyo business class on Chase?" "Compare Amex IAP fares vs cash for business class to Paris"

## 项目结构

travel-hacking-toolkit/ ├── .claude-plugin/ │ ├── plugin.json # Claude Code plugin manifest (this is the install root) │ └── marketplace.json # Claude Code marketplace catalog ├── .agents/ │ ├── plugins/marketplace.json # Codex marketplace catalog │ └── skills -> ../skills # Codex auto-discovery (no plugin install needed) ├── AGENTS.md -> CLAUDE.md # OpenCode project instructions (symlink) ├── CLAUDE.md # Project instructions, agent system prompt (frontmatter at top) ├── agents/ │ └── travel-hacker.md # Plugin agent file (auto-synced from CLAUDE.md) ├── opencode.json # OpenCode MCP server config ├── .mcp.json # Claude Code MCP server config ├── .env.example # API key template (OpenCode/Codex clone path) ├── .claude/ │ └── skills -> ../skills # Symlink to skills ├── .opencode/ │ └── skills -> ../skills # Symlink to skills ├── .github/workflows/ │ └── smoke-test.yml # CI: runs scripts/smoke-test.sh --quick on PRs ├── plugins/ │ └── travel-hacking-toolkit/ │ ├── .codex-plugin/plugin.json # Codex plugin manifest │ ├── .mcp.json # Codex MCP server config │ └── skills -> ../../skills # Codex skill bundle ├── data/ │ ├── alliances.json # Airline alliance membership + booking relationships │ ├── hotel-chains.json # Hotel chains, sub-brands, loyalty programs, reverse lookup │ ├── partner-awards.json # Which programs book which airlines (alliance + bilateral) │ ├── points-valuations.json # Points/miles valuations from 4 sources (floor/ceiling) │ ├── sweet-spots.json # High-value award redemptions + booking windows │ └── transfer-partners.json # Credit card transfer partners + ratios ├── skills/ │ │ │ │ # ── Orchestration ── │ ├── award-calendar/SKILL.md # Cheapest award dates across a date range │ ├── compare-flights/SKILL.md # Unified flight comparison (all sources) │ ├── compare-hotels/SKILL.md # Unified hotel comparison (all sources) │ ├── getting-started/SKILL.md # First-run setup detector + signpost to setup-keys │ ├── plan-trip/SKILL.md # User-invoked guided trip planner (the hero command) │ ├── trip-calculator/SKILL.md # Cash vs points calculator │ ├── trip-planner/SKILL.md # Full trip planning in one shot │ │ │ │ # ── Flights ── │ ├── duffel/SKILL.md # Primary cash prices (GDS) │ ├── google-flights/SKILL.md # Browser-automated Google Flights │ ├── ignav/SKILL.md # Secondary cash prices (REST API) │ ├── seatmaps/SKILL.md # Aircraft seat maps │ ├── seats-aero/SKILL.md # Award flight availability │ ├── southwest/ # Southwest fares + change monitoring │ │ ├── SKILL.md │ │ ├── Dockerfile │ │ └── scripts/ │ │ ├── search_fares.py │ │ ├── check_change.py │ │ └── entrypoint.sh │ │ │ │ # ── Credit Card Portals ── │ ├── amex-travel/ # Amex MR portal (flights + hotels) │ │ ├── SKILL.md │ │ ├── Dockerfile │ │ └── scripts/ │ │ └── search_flights.py │ ├── chase-travel/ # Chase UR portal (flights + hotels) │ │ ├── SKILL.md │ │ ├── Dockerfile │ │ └── scripts/ │ │ ├── search_flights.py │ │ └── record_search.py │ │ │ │ # ── Hotels ── │ ├── premium-hotels/SKILL.md # FHR/THC/Chase Edit local database │ ├── rapidapi/SKILL.md # Booking.com prices │ ├── serpapi/SKILL.md # Google Hotels + destination discovery │ ├── ticketsatwork/ # TaW corporate-perks portal (hotels + tickets) │ │ ├── SKILL.md │ │ ├── Dockerfile │ │ └── scripts/ │ │ ├── search_hotels.py │ │ ├── search_cars.py │ │ ├── browse_tickets.py │ │ ├── taw_common.py │ │ └── entrypoint.sh │ │ │ │ # ── Loyalty ── │ ├── american-airlines/ # AA AAdvantage balance │ │ ├── SKILL.md │ │ ├── Dockerfile │ │ └── scripts/ │ │ └── check_balance.py │ ├── awardwallet/SKILL.md # All loyalty balances │ ├── transfer-partners/SKILL.md # Transfer path optimizer │ ├── wheretocredit/SKILL.md # Mileage earning rates │ │ │ │ # ── Destinations & Transit ── │ ├── atlas-obscura/ # Hidden gems (+ Node.js scraper) │ │ ├── SKILL.md │ │ ├── ao.mjs │ │ └── package.json │ ├── scandinavia-transit/SKILL.md # Nordic trains/buses/ferries │ ├── tripadvisor/SKILL.md # Ratings, reviews, nearby restaurants │ │ │ │ # ── Reference & Operations (auto-load on demand) ── │ ├── flight-search-strategy/SKILL.md # Canonical multi-source search workflow │ ├── points-valuations/SKILL.md # CPP rules, surcharge programs, transfer bonuses │ ├── partner-awards/SKILL.md # Which programs ticket which airlines │ ├── alliances/SKILL.md # Star/oneworld/SkyTeam + cross-alliance plays │ ├── award-sweet-spots/SKILL.md # Legendary redemptions catalog │ ├── cabin-codes/SKILL.md # F/J/W/Y + saver fare classes (X/I/O) │ ├── hotel-chains/SKILL.md # Brand → loyalty program mapping │ ├── fallback-and-resilience/SKILL.md # Tool failure recovery paths │ ├── booking-guidance/SKILL.md # Booking flow + phone numbers │ └── lessons-learned/SKILL.md # Hard-won knowledge from real searches ├── scripts/ │ ├── setup.sh # Interactive installer (macOS/Linux/WSL/Git Bash) │ ├── setup.ps1 # Interactive installer (Windows PowerShell) │ ├── setup.cmd # Windows launcher (invokes setup.ps1) │ ├── setup-keys.sh # Standalone API key setup (no clone needed; curl|bash works) │ ├── setup-keys.ps1 # Standalone API key setup (PowerShell) │ ├── sync-agent.sh # Copies CLAUDE.md to agents/travel-hacker.md (Claude plugin) │ ├── install-hooks.sh # Installs git hooks from scripts/hooks/ (run by setup.sh) │ ├── smoke-test.sh # Static + agent integration tests │ ├── gen-skill-tables.sh # Regenerates skill tables in README.md and llms.txt │ ├── check-data-freshness.sh # Validates data/*.json TTLs │ └── hooks/ │ └── pre-commit # Auto-syncs agents/travel-hacker.md when CLAUDE.md is staged └── LICENSE # MIT

## 贡献

PR欢迎。本README中的技能表和 `llms.txt` 由每个技能自动生成 `SKILL.md` frontmatter——不要手工编辑它们。

看 [贡献.md](CONTRIBUTING.md) 适用于：技能添加流程、正面规则、烟雾测试细节、硬规则列表和房屋风格。

## 学分

- [ajimix/旅行黑客工具包](https://github.com/ajimix/travel-hacking-toolkit) --Fork贡献了谷歌航班技能、ignav技能、市场选择策略和降价表输出格式
- [美卡指南 (US Card Guide)](https://www.google.com/maps/d/viewer?mid=1HygPCP9ghtDptTNnpUpd_C507Mq_Fhec) by Scott--FHR/THC/Chase通过谷歌我的地图KML编辑酒店物业数据

工具包所依赖的其他开源项目、MCP服务器和API在 [技能表](#skills-api-knowledge-for-your-ai) 上面。

## 许可证

麻省理工学院