mcpField
C
china-travel-data

china-travel-data

github.com/greenzorro其他09 次安装1 天前更新
代码仓库

关于 china-travel-data

china-travel-data 为 Agent 提供查询四个国内旅行数据源的说明，包括端点、认证、配额和返回字段。它也概述规划顺序与两种旅行模式，但不替使用者决定具体行程。

主要功能

  1. 01四个旅行数据源的接入说明
  2. 02端点、参数与认证信息
  3. 03配额和返回字段提示
  4. 04按查询选择数据源
  5. 05旅行规划顺序与模式公式

适用场景

  1. 01查询路线、坐标和 POI
  2. 02查询航班、中转与票价
  3. 03获取车次时刻和票务信息
  4. 04查询天气预报并绘制坐标地图

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/china-travel-data确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

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

详细介绍

来自项目 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 自助开通：接口直连、激活、风控与降级

评论

支持 Markdown