mcpField
C
china-travel-data

china-travel-data

github.com/greenzorroOther09 installsUpdated 1d ago
Repository

About china-travel-data

china-travel-data is a skill that documents how an Agent can query four domestic travel data sources, including endpoints, authentication, limits, and response fields. It also outlines planning order and two travel modes while leaving itinerary decisions to the user.

Key features

  1. 01Guidance for four travel data sources
  2. 02Endpoints, parameters, and authentication
  3. 03Quota and response-field notes
  4. 04Query-based source selection
  5. 05Travel planning order and mode formulas

Use cases

  1. 01Looking up routes, coordinates, and POIs
  2. 02Checking flights, transfers, and fares
  3. 03Getting train schedules and ticket details
  4. 04Checking forecasts and mapping coordinates

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/greenzorro/victor42-skills --skill china-travel-data

After installing, type/china-travel-datain Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
amap.md
ctrip-train.md
open-meteo.md
planning-basis.md
variflight-key-provisioning.md
variflight.md

Details

From the project README

国内旅行数据源

这个 skill 做什么

给 Agent 一套能直接调用的国内旅行数据接入说明：四个源、各自的端点与参数、认证方式、配额、已知的坑、返回字段。

提供两样东西：数据源怎么接，以及行程该按什么顺序定、两种模式怎么选。

这个 skill 不做什么

不给完整的攻略产出流程：候选池净化规则、游玩时长估算、空间分组、攻略文档结构都不在范围内。

硬边界：数据层只回答「用哪个源、怎么调、结果长什么样、会踩什么坑」；规划层只到「先定什么、后定什么、选哪种模式」，再往下的具体判断交给使用者。

这条线落在哪：给规划顺序、模式公式、以及已查到的事实数据；不给点名景点、不给到小时的日程、不替人挑餐厅。用户说「你自己定就行」也不放宽。

四个源

源能回答什么认证参考
高德 Web 服务地址↔坐标、POI 检索、驾车/步行/公交路线与距离、实时天气、地图瓦片key 参数references/amap.md
飞常准计划航班、航班号查询、中转方案、机票价格X-VARIFLIGHT-KEY 头references/variflight.md
携程 SSR车次、时刻、历时、余票、票价无references/ctrip-train.md
Open-Meteo天气预报、城市地理编码、历史天气、空气质量无references/open-meteo.md

另有两条：references/planning-basis.md（两种旅行模式、规划顺序、三条判断）、references/variflight-key-provisioning.md（额度耗尽后自助开通 Key）。

组合姿势

按查询组合，不按行程组合：

  • 只知道地名，要坐标 → 高德 geocode（或 Open-Meteo 地理编码）
  • 要景点这类 POI 的精确坐标 → 高德 place/text，不要用 geocode
  • 要两点之间的车程 → 高德 direction/driving
  • 只要航班时刻 → 飞常准 flights
  • 要中转方案 → 飞常准 transfer，再用 flights 核实每段计划时间
  • 要机票价格 → 飞常准 getFlightPriceByCities
  • 要高铁票 → 携程车次列表（飞常准 trainStanTicket 可作备选）
  • 要某地某几天的天气 → Open-Meteo：先 geocoding-api 拿坐标，再 forecast
  • 要把坐标画成可交互地图 → 高德瓦片（不吃配额），配你自己的前端

运行前提

只要有 curl 或 python3 即可，不需要安装任何包。本文示例用 curl；Windows 下把 curl 换成 curl.exe 或用 Invoke-RestMethod。

Key 与配额

  • 高德：在 https://console.amap.com 申请「Web 服务」类型 Key。POI 检索是唯一紧张的一项（快照约 100 次/天，详见 references/amap.md），其余能力宽松得多。
  • 飞常准：在 https://ai.variflight.com 注册，Key 在 /keys 页。新账号有体验额度，用完即止。
  • 携程 / Open-Meteo：无需 Key。

具体配额、体验额度、预报窗口都是平台政策，会变。本文提到的数字是 2026-10 的快照，以官方控制台与文档为准。

Key 从环境变量读，不要写进代码、对话或共享文档。额度耗尽时如实告知使用者，不要用共享/借用账号绕过。

五条通用纪律

  1. 先查坐标，再查别的。不要使用模型记忆里的经纬度，也不要猜城市中心点。
  2. 三个源三种地名习惯：携程用中文城市名（上海）、飞常准用三字码（SHA/BJS）、Open-Meteo 用英文或拼音（Nanjing）。传错不一定报错，可能只是查不到。
  3. 坐标系不要混：高德返回 GCJ-02；Open-Meteo 与 OSM 是 WGS-84。两者差 100–700 米，叠在同一张地图上会偏。
  4. 失败先读错误码。四个源都有「HTTP 200 + 业务错误」的情况，见各参考文件的错误分层。
  5. 别信返回顺序。航班列表不按时刻排、POI 按热度排、车次按发车排。凡是要「最早 / 最便宜 / 最近」，自己排序再回答。

不做的事

  • 不抓大众点评 / 小红书 / 微信：没有面向个人开发者的公开 API，风控严格，也没有稳定的批量路径。
  • 不共享 Key、不绕过验证码、不转卖账号。额度轮换见 references/variflight-key-provisioning.md，仅限自建测试账号。
  • 不替代使用者做行程判断：数据可以给全、顺序可以给对，结论由人下。

参考文件

  • references/amap.md — 高德：端点、参数、配额、POI 排序陷阱、瓦片
  • references/variflight.md — 飞常准：端点、三字码规则、错误分层
  • references/ctrip-train.md — 携程：车次列表 URL、__NEXT_DATA__ 解析、字段表
  • references/open-meteo.md — Open-Meteo：地理编码、预报变量、预报窗口
  • references/planning-basis.md — 规划地基：两模式公式、规划顺序、三条判断
  • references/variflight-key-provisioning.md — 飞常准 Key 自助开通：接口直连、激活、风控与降级

Comments

Markdown supported