车来了 API（chelaile-api-server）

把车来了实时公交能力封装为只读 HTTP JSON API： 线路时刻、车辆实时位置、附近站点、关键词搜索、线路轨迹、公交+地铁换乘规划。 无需登录、无需账号、开箱即用；同时保留原 MCP 服务，可继续在 Claude Code / Cursor 中使用。

• 在线服务（已验证）： Cloudflare Workers https://ts-api.tundrey.com ｜ Vercel https://chelaile-api-server.vercel.app

• 使用手册（Wiki）： https://github.com/Justintunsday/chelaile-api-server/wiki

• 完整使用文档：docs/API.md ｜ 文档站：https://chelaile-api-docs.tundrey.com/

• 默认监听：http://127.0.0.1:8787

• 全部端点：GET /（返回端点索引）

特性

• 零配置：不依赖上游账号或密钥

• REST 化：全部 GET，JSON 响应，字段已做扁平化整理（线路上下行折叠、坐标归一、噪声字段剔除）

• 双形态：HTTP API + MCP stdio 服务共用同一套核心逻辑

• 静态数据上 GitHub：城市列表等低频数据由 GitHub Actions 定时同步并从仓库/CDN 读取，减少回源

• 可运维：可选 API Key、CORS 白名单、按 IP 限流、请求日志、健康检查

Related MCP server: transport12 MCP Server

快速开始

git clone https://github.com/Justintunsday/chelaile-api-server.git
cd chelaile-api-server
npm install
npm run build
npm start

curl "http://127.0.0.1:8787/v1/health"
curl "http://127.0.0.1:8787/v1/search?city_id=034&keyword=71"

API 端点一览

参数、响应示例、坐标系约定、错误码等详见 docs/API.md。

调用示例

# 查询 71 路实时到站（line_id / target_order / station_id 来自 /v1/search 或 /v1/stops/nearby）
curl "http://127.0.0.1:8787/v1/lines/realtime?city_id=034&line_id=21283603183&target_order=2&station_id=021-15232&lat=31.2304&lng=121.4737"

# 人民广场 → 虹桥火车站 换乘规划（GCJ-02 坐标，可取自 /v1/search 的 pois）
curl "http://127.0.0.1:8787/v1/transit/plan?city_id=034&origin_name=人民广场&origin_lat=31.233021&origin_lng=121.49073&dest_name=虹桥火车站&dest_lat=31.197&dest_lng=121.327&strategy=0"

数据托管在 GitHub

data/cities.json 由脚本从上游拉取并提交到仓库；.github/workflows/sync-data.yml 每天 03:17 UTC 自动更新（内置 3 次重试、城市数异常骤减保护、无变化不产生提交）， 修改同步脚本时也会自动运行，也可在 Actions 页面手动触发。API 读取优先级：

内存缓存 → DATA_BASE_URL（GitHub raw / jsDelivr）→ 本地 data/cities.json → 回源上游

npm run sync-data   # 手动同步城市列表

部署时指向你的仓库（jsDelivr 有 CDN 缓存，推荐）：

DATA_BASE_URL="https://cdn.jsdelivr.net/gh/Justintunsday/chelaile-api-server@main/data" npm start

首次使用工作流需在仓库 Settings → Actions → General → Workflow permissions 开启 Read and write permissions。

部署（把仓库变成在线 API）

GitHub Pages / Actions 本身不能当这个 API 的服务器。 Pages 只提供静态文件，无法向 上游发请求、做 MD5 签名和 AES 解密；Actions 也无法暴露常驻公网端口。仓库里的 pages.yml 只用来托管 使用文档：https://justintunsday.github.io/chelaile-api-server/

正确姿势是让仓库作为「部署源」，由平台自动构建并运行：

Cloudflare Workers（worker/ 目录复用同一套业务逻辑，本地可 npm run dev:worker）：

npx wrangler login
npx wrangler deploy -c worker/wrangler.toml
# 部署后到 Dashboard → Workers & Pages → chelaile-api → Settings → Domains & Routes
# 绑定自定义域名（*.workers.dev 在大陆被屏蔽，必须用自定义域名）

可选密钥：npx wrangler secret put API_KEY -c worker/wrangler.toml； DATA_BASE_URL 与 CORS_ORIGIN 在 worker/wrangler.toml 的 [vars] 中配置。

Vercel 部署说明：仓库 vercel.json 使用新的 Services 配置（runtime: "container" + 全路径 rewrite）， 直接 Import 仓库即可构建 Dockerfile；不需要手动改 Framework Preset。生产环境变量建议加 DATA_BASE_URL=https://cdn.jsdelivr.net/gh/Justintunsday/chelaile-api-server@main/data。

Render 一键部署：https://render.com/deploy?repo=https://github.com/Justintunsday/chelaile-api-server

Docker 用户可用：

docker build -t chelaile-api .
docker run -d --name chelaile-api -p 8787:8787 chelaile-api

环境变量

MCP 服务（可选）

原 MCP 能力完整保留，启动方式：

npm run start:mcp   # node dist/index.js

在 Claude Code / Claude Desktop 中使用（15 个工具，bus_* 前缀），与 HTTP 端点的对应关系见 docs/API.md。

开发

npm run dev          # tsx 热重载 API
npm run build        # tsc 构建
npm test             # 单元测试（bun test tests/unit）
npm run test:e2e     # 端到端测试（需外网，CHELAILE_E2E=1）
npm run sync-data    # 同步城市数据

License

MIT

数据来源于车来了公开接口，本项目仅做协议适配，仅供学习研究使用；请遵守上游服务条款， 避免高频抓取与商业使用。