Gachi Data API — Japan Station & Accessibility Data

Gachi Data API — 日本车站与无障碍数据（API · MCP · 开放数据集）

这是托管服务。你无需自行托管。 在 https://api.gachi-tokusuru.com 免费获取 API 密钥，并连接到下方的远程端点。 本仓库中的源代码为提高透明度而公开；数据存储在托管后端中，因此本地克隆不会返回数据。

你在其他地方找不到的深入、冷门日本数据——车站、无障碍设施、空置情况、灾害风险。经人工核验，以英文为主，为 AI Agent 构建。提供 MCP 服务、REST API 和免费的 开放数据集。API 和 MCP 共用一个密钥。

• 东京 526 个车站——无障碍／多用途卫生间，包含楼层、性别、设备标记（轮椅、造口人士、尿布台）以及最近的车站出口（通过空间连接计算得出的原创一手数据，在任何原始数据集中都没有）。
• 日本全国 612 个市町村——公共卫生间，包含轮椅／婴儿座椅／造口人士标记、地址和坐标。
• 免费开放数据集——日本车站主数据（经过实体消歧，全国 9,145 个车站）和 2000–2025 年乘客量数据，共用一个 station_id：https://github.com/eng213035/gachi-open-datasets（Zenodo DOI 10.5281/zenodo.21199500）。

主要车站名称支持日文（新宿）或罗马字（Shinjuku、Kita-Senju）。

连接

• 端点： https://api.gachi-tokusuru.com/mcp
• 传输方式： Streamable HTTP（远程）
• 身份验证： Authorization: Bearer <API_KEY> — 在 https://api.gachi-tokusuru.com 免费获取密钥

{
  "mcpServers": {
    "gachi-data": {
      "url": "https://api.gachi-tokusuru.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

工具

工具	参数	返回内容
get_toilet_by_station	station（日文或罗马字）	东京车站内的无障碍卫生间，包含 nearest_exit
get_public_toilet_by_city	city（日文）	市町村内的公共卫生间（大型城市最多返回 50 个）
get_station_hazard	station_name（日文或罗马字）	车站的 MLIT 官方灾害类别（洪水／液化／风暴潮），实时转发，缓存 14 天——不提供衍生评分。滑坡和海啸数据受许可限制（available:false + 官方地图链接）。不能替代官方灾害地图。

REST 端点

• GET /v1/station-toilets/search?station=Shinjuku — 东京车站内的无障碍卫生间
• GET /v1/toilets/nearby?lat=&lng=&radius=&wheelchair=&ostomate=&diaper= — 某地点附近的公共卫生间
• GET /v1/stations/{station_id}/hazard — 车站的 MLIT 官方灾害类别，实时转发（洪水淹没深度等级、液化／地形、风暴潮是否发生）。数据原样取自国土交通省 不動産情報ライブラリ，附有来源标注，缓存 14 天——不提供衍生评分，且不能替代官方灾害地图。滑坡和海啸数据源图层属于一部非商用（许可受限），因此会返回 available:false，并附上官方灾害地图链接。也可通过 MCP 工具 get_station_hazard(station_name) 使用。station_id 来自 Japan Station Master（例如 st_00001）；425 个车站中有 423 个包含坐标（仍有 2 个位置未知 → hazard: null）。

所有端点使用相同的 Authorization: Bearer <key>，并共用每月配额。完整规范：/openapi.yaml，文档：/docs。

示例

curl -X POST https://api.gachi-tokusuru.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_toilet_by_station","arguments":{"station":"Shinjuku"}}}'

定价

免费版 1k · 专业版 $19/100k · 全访问版 $49/200k · 商业版 $149/500k。完整详情：https://api.gachi-tokusuru.com

付费方案可自助开通：Stripe 结账后，客户会被重定向到 /activate?session_id=…，该页面会验证付款、根据已付款金额确定方案，并签发 API 密钥（每个会话均具备幂等性——重新加载会显示相同密钥）。无需人工处理密钥。

运营说明（内部）

• 订阅取消目前尚未接入密钥撤销功能（此版本没有 Stripe webhook）。订阅已取消的用户，其密钥仍可使用，直到手动停用。每月核对一次：对比 Stripe 的有效订阅与已发放的 key:* 记录，并停用已过期订阅用户的密钥。下一阶段将接入 customer.subscription.deleted webhook，实现自动撤销。
• /activate 中通过付款金额检测套餐（AMOUNT_TO_PLAN：$19/$49/$149）。如果新套餐复用了现有金额，请添加明确的映射。

许可（分为两层——请仔细阅读）

• 本仓库中的代码：MIT（参见 LICENSE）。仅适用于服务器代码。
• API 返回的数据并非 MIT 许可。每项数据的来源均标注在响应的 attribution 中。数据来源如下：
  • 无障碍设施与公厕 — 东京都政府、社会福祉局与 BODIK 市政开放数据（CC BY 4.0）：https://portal.data.metro.tokyo.lg.jp/ · https://www.bodik.jp/
  • 车站名称与列车运行状态 — ODPT，公共交通开放数据中心（CC BY 4.0）：https://developer.odpt.org/
  • 灾害类别、未来人口、地价 — MLIT 不动产信息库（Real Estate Information Library）；按请求原样转述官方数值（并非政府制作的数据集）：https://www.reinfolib.mlit.go.jp/
  • 河流洪水预报与滑坡预警 — JMA（日本气象厅，気象庁）；按发布内容转述，并非本服务发布的预警：https://www.jma.go.jp/bosai/
  • 住房空置情况与市町村代码 — 日本总务省统计局（住宅・土地統計調査），通过 e-Stat 与 MIC（総務省）：https://www.stat.go.jp/data/jyutaku/
  • 全国车站与公交站 — MLIT 国土数值信息 N02/P11；部分英文车站名称来自 Wikidata（CC0）：https://nlftp.mlit.go.jp/ksj/ · https://www.wikidata.org/
• nearest_exit、nearest_station_km 和公交站数量由 gachi-tokusuru.com 通过空间连接计算得出，与上述官方数值不同。
• 每个 API 响应都会返回来源标注。数据的时效性、准确性和完整性均不作保证。