12306 Train

python3 scripts/update_stations.py

2) Query direct tickets

Examples:

python3 scripts/query_tickets.py --date 2026-03-01 --from 上海 --to 杭州
python3 scripts/query_tickets.py --from 上海 --to 杭州  # date omitted → defaults to tomorrow
python3 scripts/query_tickets.py --date 2026-03-01 --from SHH --to HGH
python3 scripts/query_tickets.py --date 2026-03-01 --from 上海虹桥 --to 杭州东 --purpose ADULT --limit 15

3) Query route stations (stops)

Use this when the user asks “经停/途经哪些站”.

# If you know the train code
python3 scripts/query_route_stations.py --date 2026-03-01 --from 北京朝阳 --to 锦州南 --train-code K4409

# If you already have train_no
python3 scripts/query_route_stations.py --date 2026-03-01 --from 北京朝阳 --to 锦州南 --train-no 24000K44090U

4) Query transfer (interline) tickets (only when user allows/asks)

python3 scripts/query_transfer.py --date 2026-02-25 --from 密云 --to 锦州 --limit 10
python3 scripts/query_transfer.py --date 2026-02-25 --from 密云 --to 锦州 --middle 承德南 --limit 10

Output

• Prints a compact summary to stdout.
• Writes a machine-readable JSON to a cache file and prints the path.

Notes for the agent

• Prefer using Chinese station names in user-facing prompts; the script will map to station codes.
• If the user provides an ambiguous station name, run station search via scripts/stations.py --search and ask a clarification.
• If the user does not provide a date, you may query using today (default) and explicitly remind them that different dates may differ; then ask which date they want if they need accuracy.
• Keep results concise: list top trains (earliest few, shortest duration, or user-specified filters).

Troubleshooting

• If station mapping is missing/outdated: run python3 scripts/update_stations.py.
• If you get HTML (mormhweb error page):
  • reduce frequency; wait 5–15 minutes before retry
  • try a different station combo (e.g. 锦州/锦州南/锦州北)
  • change outbound network (often the most effective)