China Travel Kit (华行志)

What it does

• One data layer, three interfaces: python3 -m china_travel_kit CLI (zero runtime deps, Python 3.10+), a local HTTP API, and MCP tools for AI clients
• Every attraction record carries sources and last_verified; prices and reservation rules are deliberately nullable — unknown is safer than confidently outdated
• An explainable requirement matcher drives the recommend / plan commands (travelers, dates, interests) instead of keyword matching
• The repo root is an installable Agent Skill: SKILL.md defines when to use the toolkit and when live facts must be rechecked

When to use it

Building travel-planning features for China-bound users where every claim needs a citation — or pointing your own agent at honest, checkable data instead of scraped listicles.

Getting started

git clone https://github.com/tczyliu/china-travel-kit.git
cd china-travel-kit
python3 -m china_travel_kit search museum --city Beijing
python3 -m china_travel_kit recommend 'First visit: pandas, food, relaxed pace' --travelers 2 --start-date 2026-07-10 --end-date 2026-07-12
python3 -m china_travel_kit freshness   # data-freshness report

# as an Agent Skill: point an Agent-Skills-compatible client at the repo, or clone it into its skills directory

Things to know

v0.5.0 alpha, developer preview: 56 places in 8 cities, with the first expansion targeting officially sourced 5A/4A attractions — none of it is a complete city guide. Not a booking service or live navigation; the Skill itself tells the agent to re-check live facts.