pp-atlas-obscura

Atlas Obscura — Printing Press CLI

前提条件：CLI をインストールする

このスキルは atlas-obscura-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使ってインストールします。バイナリのインストール先は、macOS/Linux ではデフォルトで $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install atlas-obscura --cli-only
   

2. 確認します：atlas-obscura-pp-cli --version
3. このスキルを実行するエージェント／ランタイムの $PATH に、表示されたインストール先ディレクトリが含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go から直接インストールしてください（Go 1.26.6 以降が必要です）。この方法では $GOPATH/bin（デフォルトは $HOME/go/bin）にインストールされるため、代わりにそのディレクトリを $PATH に追加してください。

go install github.com/mvanhorn/printing-press-library/library/travel/atlas-obscura/cmd/atlas-obscura-pp-cli@latest

インストール後に --version が「command not found」と表示された場合、ランタイムから $PATH 上のバイナリディレクトリが見えていません。確認に成功するまでは、スキルのコマンドを実行しないでください。

キーワードまたは座標で世界中の隠れた驚異を探し、「行く前に知っておきたいこと」のメモを含む場所の詳細を取得して、オフラインでエージェントがそのまま使えるよう、すべてをローカルの SQLite ストアにミラーリングします。スクレイパーの機能をさらに超えて、ドライブルート沿いの驚異を探したり、旅行を保存・エクスポートしたり、訪問済みの場所を記録したりできます。atlasobscura.com のコミュニティ投稿に基づいており、公式 API ではありません。

この CLI を使う場面

ユーザーが、旅行の計画やロードトリップ、旅程への興味深い立ち寄り先の追加のために、風変わりな場所、珍しい場所、隠れた名所を探している場合は Atlas Obscura を使います。2 つの都市間のルート沿いの検索、保存した旅行の蓄積、ローカルミラーへのオフラインでの再クエリに優れています。一般的な旅行予約ではなく、奇妙で素晴らしい場所の発見が目的の場合に利用してください。

利用に適さない場面

次の場合は、この CLI を使わないでください。

• ホテル、航空券、レストランの予約には使わないでください。場所の検索のみが可能です。
• 一般的な観光名所やレビューには使わないでください。厳選された珍しい場所を扱うもので、汎用的な POI ディレクトリではありません。
• リアルタイムの営業時間やチケット購入には使わないでください。Atlas Obscura には営業時間の構造化データがありません。各場所の公式サイトを確認してください。

独自の機能

これらの機能は、この API のほかのツールでは利用できません。

旅行の計画

• route — 1 か所だけでなく、2 つの都市間のドライブルート沿いにある Atlas Obscura の驚異を探します。

  2 つの場所の間を車で移動するユーザーが、道中で立ち寄る価値のある場所を探している場合に利用します。

  atlas-obscura-pp-cli route "San Francisco" "Los Angeles" --min-score 6 --limit 15 --json
  

• cluster — 近くにある驚異を、徒歩で回れる半日コースになるよう、範囲の狭い空間的なクラスターにまとめます。

  近くの場所のリストを、徒歩で効率よく回れる 1 日の計画にまとめるために使います。

  atlas-obscura-pp-cli cluster "Edinburgh" --radius 3 --min 3 --json
  

• export — 保存した旅行を、完全オフラインで GPX、GeoJSON、または Markdown の旅程にシリアライズします。

  ロードトリップの情報を GPS、地図ツール、または人が読める記録に渡すために使います。

  atlas-obscura-pp-cli export california-oddities --format md
  

蓄積されるローカルデータ

• trip — 場所を名前付きの旅程に追加し、セッションをまたいで保持します。

  毎回検索し直すのではなく、複数のセッションにわたって旅行の計画を作り上げるために使います。

  atlas-obscura-pp-cli trip add winchester-mystery-house --trip california-oddities
  

• visited — 日付やメモを任意で添えて、訪れた驚異を記録します。

  すでに見た場所を覚えておき、未訪問の場所の検索や驚きの候補から除外するために使います。

  atlas-obscura-pp-cli visited mark salvation-mountain --note "worth the desert drive"
  

• gaps — ある地点の近くにある未訪問のおすすめスポットを、興味深さ順に表示します。

  再訪する場所の近くで、まだ見ていないものを計画するために使います。

  atlas-obscura-pp-cli gaps "Portland, Oregon" --radius 40 --min-score 6 --json
  

• surprise — まだ訪れていない、関心度の高い驚異を 1 つ選びます。日付をシードにするため、同じ日であれば結果は変わりません。

  毎日のエージェントのハートビートで使い、重複なく新しい驚異を紹介します。

  atlas-obscura-pp-cli surprise --near "Tokyo" --exclude-visited --json
  

コマンドリファレンス

categories — Atlas Obscura のカテゴリ別にスポットを閲覧します

• atlas-obscura-pp-cli categories <slug> — カテゴリ内のスポットリンクを一覧表示します（例：cemeteries、caves、ruins）

destinations — 目的地（都市／地域）別にスポットを閲覧します

• atlas-obscura-pp-cli destinations <slug> — 目的地のスポットリンクを一覧表示します（例：paris-france、new-york）

places — Atlas Obscura のスポット（驚異の場所）

• atlas-obscura-pp-cli places <slug> — スラッグまたは数値 ID でスポットの詳細ページを取得します

適切なコマンドを見つける

実行したいことはわかっていても、どのコマンドを使えばよいかわからない場合は、CLI に直接尋ねてください。

atlas-obscura-pp-cli which "<capability in your own words>"

which は、自然言語の機能クエリを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 件一致したことを示し、終了コード 2 は確信を持てる一致がなかったことを示します。その場合は --help を使うか、より絞り込んだクエリを指定してください。

レシピ

ロードトリップの立ち寄り先を計画する

atlas-obscura-pp-cli route "Denver" "Moab" --min-score 6 --limit 12 --json

2 つの都市間の走行ルート沿いにある、評価の高い驚異の場所を提示します。

エージェント向けの簡潔な近隣検索

atlas-obscura-pp-cli near "35.0116,135.7681" --radius 3 --json --select results.title,results.distance_from_query,results.url

深くネストされたレスポンスをタイトル、距離、URL のみに絞り、エージェントが画像や座標のノイズを解析しなくて済むようにします。

旅行を作成してエクスポートする

atlas-obscura-pp-cli trip add winchester-mystery-house --trip ca && atlas-obscura-pp-cli export ca --format md

スポットを名前付きの旅行に追加し、説明と「Know Before You Go」を含む Markdown の旅程を作成します。

自宅の近くでまだ訪れていない場所は？

atlas-obscura-pp-cli gaps "Austin, Texas" --radius 30 --min-score 6 --json

キャッシュ済みの驚異の場所と訪問記録を照合し、まだ訪れていない価値のある場所のみを返します。

認証の設定

認証は不要です。

atlas-obscura-pp-cli doctor を実行して、設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。出力の多い API でコンテキストを小さく保つうえで重要です。

  atlas-obscura-pp-cli places mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run はリクエストを送信せずに表示します

• オフライン対応 — 同期／検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープで包みます。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を解析してください。人間が読みやすい N results (live) の概要が stderr に出力されるのは、stdout が端末であり、かつ機械処理用の形式フラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合のみです。パイプやエージェントの利用時、および明示的に形式を指定した実行では、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

あなた（またはエージェント）がこの CLI に違和感を覚えたら、記録してください。

atlas-obscura-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
atlas-obscura-pp-cli feedback --stdin < notes.txt
atlas-obscura-pp-cli feedback list --json --limit 10

記録はローカルの ~/.local/share/atlas-obscura-pp-cli/feedback.jsonl に保存されます。ATLAS_OBSCURA_FEEDBACK_ENDPOINT が設定され、かつ --send が渡された場合、または ATLAS_OBSCURA_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトの動作はローカルのみです。

バグ報告ではなく、意外に感じたことを書いてください。簡潔で具体的な一行にしてください。そこから改善が積み重なります。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定した送信先へ送られるため、エージェントはパイプで手動転送せずにコマンド結果を振り分けられます。送信先は 3 種類です。

送信先	動作
stdout	デフォルト。stdout のみに出力します
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポートされているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

プロファイルとは、保存して呼び出しのたびに再利用できるフラグ値のセットです。スケジュールされたエージェントが毎回同じ設定で同じコマンドを実行する場合に使用します。これは HeyGen の「Beacon」パターンです。

atlas-obscura-pp-cli profile save briefing --json
atlas-obscura-pp-cli --profile briefing places mock-value
atlas-obscura-pp-cli profile list --json
atlas-obscura-pp-cli profile show briefing
atlas-obscura-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルト値より優先されます。agent-context は利用可能なすべてのプロファイルを available_profiles の下に一覧表示するため、情報を調べるエージェントは実行時にそれらを検出できます。

終了コード

コード	意味
0	成功
2	使用エラー（引数が不正です）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限中（待機して再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → atlas-obscura-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合 → MCP のインストール。それ以外の場合 → 上記の前提条件を参照してください
3. その他すべて → 直接使用（--agent を付けて CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/travel/atlas-obscura/cmd/atlas-obscura-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add atlas-obscura-pp-mcp -- atlas-obscura-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストールされているか確認します：which atlas-obscura-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを付けて実行します。

   atlas-obscura-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：atlas-obscura-pp-cli <command> --help