Overture Places

@pipeworx/overture-places

Overture Maps Foundation の places テーマに基づく、米国および英国のビジネスと施設の所在地です。各場所には、名称、カテゴリ、存在確度スコア、住所、ウェブサイト、電話番号、メールアドレス、ソーシャルリンク、ブランド、データを提供したソースレコードの ID が含まれます。地点の近くや都市内にある場所の検索、ウェブサイトのドメインから企業の全拠点を特定、エリア内にある場所の件数の集計に利用できます。

Pipeworx の一部です。AI エージェントを 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 が含まれます。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" が返され、対象国の一覧が示されます。
• 1 回の呼び出しでスキャンするデータブロックは最大 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 テーマ。 Meta のデータ。CDLA Permissive 2.0 のもとで利用できます。 Microsoft のデータ。CDLA Permissive 2.0 のもとで利用できます。 PinMeTo のデータ。CDLA Permissive 2.0 のもとで利用できます。 Krick のデータ。CDLA Permissive 2.0 のもとで利用できます。 RenderSEO のデータ。CDLA Permissive 2.0 のもとで利用できます。 DAC のデータ。CDLA Permissive 2.0 のもとで利用できます。 BrightQuery のデータ。CDLA Permissive 2.0 のもとで利用できます。 Foursquare のデータ。Copyright 2024 Foursquare Labs, Inc. All rights reserved. Apache 2.0 のもとで利用できます。Foursquare のデータは Overture スキーマに変換されています。 AllThePlaces のデータ。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 サーバーをもう 1 つ追加する必要がありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマがもたらすコンテキストコストに対してルーティングの利点が見合わない場合は、複数のパックのエンドポイントに接続するのではなく、フルゲートウェイに一度だけ接続してください。

または、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 での使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。 これは、上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT