Overture Places

@pipeworx/overture-places

来自 Overture Maps Foundation places 主题的美国和英国商业及兴趣点位置。每个地点都包含名称、类别、存在置信度分数、街道地址、网站、电话、电子邮件、社交链接、品牌以及贡献来源记录 ID。可用于查找某个点附近或某个城市中的地点、按公司网站域名绘制其所有位置的地图，以及统计某个区域内的地点数量。

属于 Pipeworx — 一个将 AI Agent 连接到 1764+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未经其认可，也非由其发布。

工具

• places_search(name?, category?, near{lat,lon} + radius_m | bbox | city + country [+ region], min_confidence?, include_closed?, limit?)： 查找名称和／或类别匹配的商业地点。结果先按匹配质量排序，再按距离（适用于 near）或置信度排序。例如：奥斯汀市中心 3 km 范围内的 Starbucks 分店。
• places_by_domain(domain, country?, region?, min_confidence?, include_closed?, limit?)： 查找网站使用公司域名的所有位置，从而了解该公司的实体覆盖范围。子域名和路径会归并到可注册域名（https://www.starbucks.com/store-locator → starbucks.com）。返回总数，以及按国家和州／地区划分的数量。
• places_in_area(near + radius_m | bbox | city + country, category?, min_confidence?, include_closed?, limit?)： 返回某个区域内的地点数量、按类别划分的明细，以及置信度最高的地点。

每个响应都以 attribution 开头，并包含 source 区块（许可证、发布版本、条款 URL）和 data_as_of，表明答案所依据的 Overture 发布版本（例如 2026-09-23.1）。

置信度

Overture 为每个地点提供 0 到 1 的存在置信度，并称其为“筛除潜在垃圾数据的主要工具”。**默认情况下，此工具包会隐藏置信度低于 0.7 的地点，以及标记为 permanently_closed 的地点。**在测量样本中，分布在 0.7 处出现明显断层，低于该值的记录大多是垃圾数据。默认设置会保留约 68% 的地点。每个地点都会显示其 confidence，每个响应都会说明所应用的阈值以及隐藏的地点数量（hidden_by_filters）。若要查看所有地点，请传入 min_confidence: 0 和 include_closed: true。

覆盖范围和限制

• 国家：US 和 GB。 对这些国家以外的区域或城市进行查询，会返回 found:false, reason:"outside_coverage" 并列出覆盖的国家。
• 每次调用最多扫描 64 个数据块，优先扫描距离区域中心最近的数据块。约涵盖 250,000 个地点。对于更大的区域（例如按名称搜索整个都会区），响应会设置 complete:false，并在 coverage_warning 中说明未搜索的内容。places_in_area 仍会根据索引给出精确或有界的总数。若要获得完整结果，请用 near + radius_m 缩小区域。
• 城市查询会根据数据中的地址解析地区名称。在美国，region 字段的格式一致（州代码；也接受完整州名），但在英国并不一致，因此查询英国城市时请省略 region。若名称匹配到多个地点（例如多个 Springfield），则会使用最大的地点，并在 other_places_with_this_name 中列出其他地点。
• **平台域名不会建立索引。**社交资料页、链接页、网站构建工具和商家信息网站（instagram.com、linktr.ee、wixsite.com、yelp.com 等）无法唯一标识某家公司。places_by_domain 会以 reason:"platform_domain" 拒绝此类域名。
• **超大型域名：**每个域名最多为置信度最高的 5,000 个位置建立索引。响应始终会在 locations_listing_domain 中提供实际总数，并说明是否触及上限。
• Overture 警告称，该主题“已知包含重复记录、垃圾数据比例较高，且属性完整度较低”。置信度筛选有助于减少垃圾数据，但不会去除重复记录。

身份验证

无需密钥。此工具包仅通过 Pipeworx 网关提供响应 （https://gateway.pipeworx.io/mcp）。独立安装无法读取 Overture 版本，因此每次调用都会失败，并返回相应错误。

数据来源

• Overture Maps Foundation places 主题，按月发布 GeoParquet： https://docs.overturemaps.org/guides/places/，路径为 s3://overturemaps-us-west-2/release/<release>/theme=places/type=place/。 overture-places-ingest 工作流每周检查是否有新版本 （设计文档：docs/overture-places-design.md）。

许可和署名

places 主题根据来源的不同，采用 CDLA-Permissive-2.0 和 Apache-2.0 许可发布。允许再分发，包括商业用途，但需注明出处。 Overture 表示该主题不包含 OpenStreetMap 数据，因此不适用 ODbL。署名方式如下，照录 Overture 发布的内容 （https://docs.overturemaps.org/attribution/）：

© Overture Maps Foundation (https://overturemaps.org), places theme. Data from Meta. Available under CDLA Permissive 2.0. Data from Microsoft. Available under CDLA Permissive 2.0. Data from PinMeTo. Available under CDLA Permissive 2.0. Data from Krick. Available under CDLA Permissive 2.0. Data from RenderSEO. Available under CDLA Permissive 2.0. Data from DAC. Available under CDLA Permissive 2.0. Data from BrightQuery. Available under CDLA Permissive 2.0. Data from Foursquare. Copyright 2024 Foursquare Labs, Inc. All rights reserved. Available under Apache 2.0. Foursquare data was transformed to the Overture schema. Data from AllThePlaces. Available under CC0 1.0.

每个响应中的 attribution 会列出 Overture 版本，以及该响应所含来源对应的署名行。每个地点都会在 sources 中列出对其有贡献的数据集，并在 source_licenses 中列出这些数据集的许可。

快速开始

添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "overture-places": {
      "url": "https://gateway.pipeworx.io/overture-places/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/overture-places/mcp 上的 tools/list 会返回上表中的工具， 以及 Pipeworx 的共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及 网关范围内的其他工具。因此，你看到的工具数量会多于此表所列：目前，单工具包端点会在工具包自有工具之外，列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威依据。

这是有意为之，并非意外进行了多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需你再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由功能带来的价值，请只连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和同一批 1764+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/places_search \
  -H 'Content-Type: application/json' \
  -d '{"name":"Starbucks","near":{"lat":30.2672,"lon":-97.7431},"radius_m":3000,"limit":5}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/places_search。查找工具包：使用 {"query":"..."} 发送 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关往返：

{
  "mcpServers": {
    "overture-places": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-overture-places"]
    }
  }
}

也可以直接运行，以确认它能启动：

npx -y @pipeworx/mcp-overture-places

它通过 stdin/stdout 使用 MCP 通信，并仅针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所附带的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Overture Places data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT