mcpField
A
atlas-obscura

atlas-obscura

github.com/borskiその他78074 回インストール2 日前に更新
リポジトリ

atlas-obscura について

Atlas Obscuraは、座標を使ってAtlas Obscuraのサイトから周辺の個性的な場所を探す旅行向けスキルです。結果のスコア付けと絞り込みに加え、簡易検索や詳細情報の取得もできます。

主な機能

  1. 01座標による周辺スポット検索
  2. 02興味深さに基づく順位付け
  3. 03一般的な歴史標識の除外
  4. 04説明、道順、タグの取得
  5. 05必要に応じた画像URLの追加

活用シーン

  1. 01目的地周辺の珍しい場所探し
  2. 02旅程への隠れた名所の追加
  3. 03特定スポットの詳細確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/borski/travel-hacking-toolkit --skill atlas-obscura

インストール後、Claude Code で/atlas-obscuraを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

ao.mjs
package-lock.json
package.json

詳細

Atlas Obscura

Atlas Obscura を使って、あらゆる目的地の近くにある本当に興味深い隠れた名所を見つけます。座標で検索し、場所の興味深さをスコア化して、ありふれた歴史標識を除外します。

API キーは不要です。atlas-obscura-api npm スクレイパーを使用します。

前提条件

依存関係をインストールします（初回のみ）。

cd skills/atlas-obscura && npm install

都市の座標一覧

旅行の計画によく使われる都市です。検索コマンドで使用してください。

都市緯度経度
ニューヨーク40.7128-74.0060
ロンドン51.5074-0.1278
パリ48.85662.3522
東京35.6762139.6503
バンコク13.7563100.5018
ローマ41.902812.4964
バルセロナ41.38742.1686
イスタンブール41.008228.9784
メキシコシティ19.4326-99.1332
リスボン38.7223-9.1393
ソウル37.5665126.9780
オスロ59.913910.7522
コペンハーゲン55.676112.5683
ストックホルム59.329318.0686

コマンド

すべてのコマンドはリポジトリのルートから実行します。出力は JSON です。出力を軽量に保つため、画像 URL はデフォルトで除外されます。画像が必要な場合（HTML ページの生成など）は、任意のコマンドに --images を追加してください。

近隣を検索（フィルタリングあり）

座標の近くにある場所を検索し、詳細情報を取得して興味深さをスコア化し、ありふれた場所を除外します。各場所の情報を取得するため時間はかかりますが、魅力的なスポットを見つけられます。

node skills/atlas-obscura/ao.mjs search <lat> <lng>

例：

node skills/atlas-obscura/ao.mjs search 35.6762 139.6503

興味スコア順に並べた最大 20 件の場所を返します。それぞれに詳細な説明、タグ、道順が含まれます。

タイムアウトに関する注意： HTTP リクエストを約 20 回（場所ごとに 1 回）実行します。30～60 秒ほどかかります。

クイック検索（フィルタリングなし）

近隣をすばやく検索します。タイトル、サブタイトル、座標、距離を返します。詳細情報の取得やスコア化は行いません。

node skills/atlas-obscura/ao.mjs quick <lat> <lng>
詳細情報付きのフィルタリングなし検索

フィルタリングありの検索と同じですが、つまらない記念碑なども含め、すべてを保持します。

node skills/atlas-obscura/ao.mjs search <lat> <lng> --all
場所の詳細情報

ID を指定して、特定の場所の完全な情報を取得します。

node skills/atlas-obscura/ao.mjs place <id>

返される情報：タイトル、サブタイトル、詳細な説明（複数段落）、道順、タグ、近隣の場所、興味スコア。

場所の簡易概要

全件スクレイピングせず、場所をすばやく検索します。リクエストは 1 回です。

node skills/atlas-obscura/ao.mjs short <id>
画像を含める

任意のコマンドに --images を追加すると、サムネイルと画像の URL が出力に含まれます。HTML ページやビジュアルレポートを生成する場合に便利です。

node skills/atlas-obscura/ao.mjs search <lat> <lng> --images
node skills/atlas-obscura/ao.mjs place <id> --images

興味スコア

場所は次の基準でスコア化されます。

加点対象： 廃墟、遺跡、ゴーストタウン、地下施設、洞窟、自然の驚異、珍しいコレクション、ストリートアート、博物館、市場、温泉、滝、醸造所、庭園、島、芸術、彫刻、壁画。また、詳細な説明や複数の画像も加点対象です。

減点対象： 記念碑、歴史標識、モニュメント、戦争記念碑、政府庁舎。また、「消失」と表示されている場所や地図上で非表示の場所も減点対象です。

デフォルトの検索では、スコアが 0 未満の場所は除外されます。

便利な jq フィルター

# Just titles and subtitles
... | jq '.[] | {title, subtitle, tags}'

# Top 5 by interest score
... | jq '[sort_by(-.interest_score) | .[0:5] | .[] | {title, subtitle, interest_score, url}]'

# Places with specific tags
... | jq '[.[] | select(.tags | any(. == "Underground" or . == "Caves"))]'

# Just URLs for browsing
... | jq -r '.[].url'

使用する場面

次の場合にこのスキルを読み込みます。

  • 旅行を計画していて、目的地の近くにある隠れた名所を探したい
  • 個性的で、風変わりな、または素晴らしい訪問先を探している
  • 特定の座標に対する Atlas Obscura のおすすめが必要
  • 旅程に興味深い立ち寄り先を追加したい

次の用途には使用しないでください。

  • 予約（AO はスポットの発見のみを目的としています）
  • スクレイパーに過剰な負荷をかける（atlasobscura.com をスクレイピングするため、節度を守ってください）
  • リアルタイムの営業状況を期待する（閉鎖や営業時間の変更などがあり得ます）

コメント

Markdown 対応