carto-find-spatial-data

carto-find-spatial-data

**CARTO Data Observatory（DO）**は、厳選された外部空間データセットのカタログです。人口統計、POI、環境データ、モビリティ、金融などのデータを購読し、独自のデータウェアハウスにマテリアライズできます。ユーザーが米国国勢調査のシェープファイルを探し回る代わりに、このスキルでは「ここで役立つ、DOですでに厳選されているデータは何か」という問いに答えます。

このスキルでは、検索と購読を扱います。購読後、データはユーザーのデータウェアハウスに保存され、他のテーブルと同様にクエリできます。詳しくはcarto-query-datawarehouseを参照してください。

アクセス経路の振り分け。 CARTO MCP サーバーが接続されている場合は、search_data_observatory（method: list_datasets|list_filters|search_variables|get_dataset|sample）を使ってデータを検索します。この機能はトークン認証済みセッションでも利用できます。購読の管理には、OAuthセッションが必要なmanage_data_observatory_subscriptions（method: list|subscribe|unsubscribe）を使います。サーバーが接続されていない場合、スクリプトでの利用、またはトークンセッションからの購読には、carto do CLIを使用してください。以下の評価指針（対象範囲、ライセンス、更新頻度）は、どの経路でも適用されます。検出シグナルについては、carto-basics/references/access-paths.mdを参照してください。

このスキルを使う場面

• ユーザーが「人口統計」「POI」「境界」「モビリティデータ」「天気」など、外部空間データのカテゴリについて尋ねた場合。
• ユーザーが内部データを持っていて、それを外部コンテキストで拡充したい場合（例：店舗と国勢調査区を空間結合する）。
• 有料購読を申し込む前に、利用可能なデータを確認している場合。

ユーザーのデータウェアハウスにすでにデータセットがある場合は、代わりにcarto-explore-datawarehouseに進んでください。DOは新しい外部データを取得するためのものです。

クイックリファレンス

MCP（検索はどのセッションでも利用可能。購読にはOAuthが必要です）：

search_data_observatory { method: "list_datasets", keyword: "census", country: "usa" }
search_data_observatory { method: "get_dataset", dataset_id }        # inspect before subscribing
manage_data_observatory_subscriptions { method: "list" }
manage_data_observatory_subscriptions { method: "subscribe", dataset_id, connection, destination }

CLIへのフォールバック（サーバーなし／スクリプトでの利用／トークンセッションでの購読）：

carto do search --keyword "census" --country usa --json
carto do get <dataset-id> --json
carto do subscriptions list --json
carto do subscribe <dataset-id> --connection carto_dw --destination my_project.do.census_tracts

このスキルの内容

トピック	リファレンス
データの検索：検索、フィルタリング、データセットの評価	references/data-observatory.md
購読：有料と無料、マテリアライズ、更新、コスト	references/subscribe.md

常に適用される指針

• 無料と有料：DOのデータセットの多くは無料です（米国国勢調査、OpenStreetMap由来のデータ、NaturalEarthなど）。プレミアムデータセット（Spatial.ai、Mastercard、AirSageなど）にはCARTOの購読契約が必要です。ライセンスと価格帯は、get_dataset／carto do getで確認できます。
• 購読すると、データはユーザーのデータウェアハウスに取り込まれます。 リモートビューではありません。実際の行が宛先テーブルに書き込まれ、ユーザーはそのウェアハウスのストレージ料金を支払います。それに応じて宛先の命名を計画してください。
• 空間拡張機能が必要です。 DOのデータセットには、宛先のデータウェアハウスにCARTOの空間拡張機能がインストールされていないと使えないH3セルやジオメトリ型が含まれていることがよくあります。「function not found」エラーで購読に失敗した場合は、拡張機能がインストールされているか確認してください。詳しくはcarto-manage-platformを参照してください。
• 事前に確認せずにDOのデータセットを推奨しないでください（get_dataset／carto do get）。メタデータから、対象範囲（米国のみ、EUのみ、全世界）、更新頻度（月次、年次、リアルタイム）、ライセンスが分かります。いずれも、ユーザーの質問に適しているか判断するうえで重要です。
• DOは外部、名前付きソースは内部です。 名前付きソース（carto-explore-datawarehouse/references/named-sources.mdで説明）はユーザーが保存したクエリです。DOはサードパーティデータを集めた厳選カタログです。この2つを混同しないでください。