GeoWire 是一个开源的地理智能网关，旨在为 AI 智能体提供真实世界的位置智能。它位于 AI 智能体与地图/地点数据提供商（如 OpenStreetMap、Google、Yelp、Foursquare、US Census 以及用户自有数据）之间，通过单一的 MCP 服务器、REST API、CLI 和 SDK 暴露这些数据。其核心功能包括地点搜索、地理编码、路线与距离矩阵、商业区域分析（密度、评分、人口统计），并支持提供商回退、多提供商合并与去重、成本预算以及执行各提供商缓存/归属条款的策略引擎。
主要能力：
- 地点搜索与地理编码：支持按名称、地址、地标搜索，以及类别词搜索（如“咖啡”、“药店”）。
- 路线与距离矩阵：通过 OSRM 提供无密钥的路线规划和距离计算。
- 等时圈：计算旅行时间等时圈，帮助智能体按驾车时间对候选地点排序，回答“距离某地址 15 分钟车程内有什么”等问题。
- 商业区域分析：一次 analyze_area 调用可将一个点+半径转化为商业区解读，包括类别密度、竞争情况、评分景观以及（美国）人口统计数据。
- 多提供商合并与去重：将自有店铺数据、Google、OSM 等合并为一条去重记录，并标注每个字段的来源（如名称来自自有数据、评分来自 Google、坐标来自 OSM）。
- 策略引擎：强制执行每个提供商的缓存和归属条款，例如 Google 原始数据不被缓存。
使用方式：
- MCP：在 Claude Desktop 或 Cursor 的 MCP 客户端配置中添加 GeoWire，即可在 30 秒内使用。无需 API 密钥，默认使用 OpenStreetMap 和 OSRM 路由。可添加 GOOGLE_MAPS_API_KEY、YELP_API_KEY 或 CENSUS_API_KEY 以获取评分、评论、营业时间和人口统计数据。
- CLI：支持一次性搜索和服务器模式，任何命令加 --json 可获取完整响应（结果+来源元数据）。
- Docker：可自托管服务器，或使用 docker compose up，API 文档位于 /docs。
- SDK：支持嵌入式使用，提供 TypeScript SDK 指南。
- REST API：所有功能均可通过 REST 调用，可选 Bearer 认证（设置 GEOWIRE_API_KEYS）。
适用场景：
- AI 智能体需要真实世界位置智能，如查找地点、规划路线、分析商业区域。
- 需要合并多个地图提供商数据并追踪字段来源的应用。
- 需要成本控制和策略合规的地理数据集成。
- 支持韩国（Kakao/Naver）和中国（百度）等区域提供商，百度返回 BD-09 坐标，GeoWire 自动转换为 WGS84。
限制与说明：
- OpenStreetMap 作为零密钥默认提供商，在地点名称、地址和地标方面表现良好，但在类别词、评分和营业时间方面较弱。
- 对于美国/西方商业数据，建议添加 Google、Yelp 或 Foursquare 密钥（BYOK）。
- 路线规划通过 OSRM 无密钥运行；美国人口统计数据来自 Census（免费密钥）。
- v0.1 版本为“可用”范围，部分功能可能尚未包含。
- 代码采用 Apache-2.0 许可证，但第三方地图/地点数据提供商的使用受各自条款约束。OSM 数据采用 ODbL 许可。
- 评论/照片为提供商原始内容，策略引擎执行各提供商的存储条款。
GeoWire 已发布在 npm 上，MCP、REST、CLI、SDK 均可用，支持 10 个提供商和 8 种操作。
