pp-bandsintown

Bandsintown — Printing Press CLI

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

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

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

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

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

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go から直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/bandsintown/cmd/bandsintown-pp-cli@latest

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリのディレクトリが $PATH 経由で参照できません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

アーティスト間、または時間経過に伴う Bandsintown データの集計が予約に関する質問の答えに必要な場合は、この CLI を使用します。たとえば、ツアールートの実現可能性、カレンダーの空き期間の検出、共演パターン、tracker_count の変化などです。「Phoenix の公演は何がありますか」といった単発の質問には、bandsintown.com の Web UI で十分です。繰り返し実行でき、エージェントが複数アーティストを対象に分析する場合は、このツールが適しています。

この CLI を使用しない場面

作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、メッセージ送信、予約、購入、またはリモートの状態変更が必要なリクエストには、この CLI を使用しないでください。この CLI が公開するのは、調査、エクスポート、同期、分析のための読み取り専用コマンドです。

独自の機能

この API に対応した他のツールには、以下の機能はありません。

ルーティング分析

• route — 指定した都市の近くで、指定期間内に公演がある追跡対象アーティストを検索します。予約に向けて、実現可能性の高い順にルーティング候補を提示します。

  特定の都市でイベントを予約する場合、その地域をすでにツアーで回っているアーティストを見つけるのが最も低コストです。新規の営業連絡をする前に、この機能を使ってください。

  bandsintown-pp-cli route --to "Jakarta,ID" --on 2026-08-15 --window 7d --tracked --json
  

• gaps — イベントの枠の長さに合う、アーティストのツアーカレンダー上の空き期間を検索します。地域を指定して絞り込むこともできます。

  イベントの日程に合うツアーの空き期間があるアーティストを特定するために使います。予約につながりやすい、最も有望なリードです。

  bandsintown-pp-cli gaps "Beach House" --min 5d --max 21d --in SEA --json
  

• sea-radar — 東南アジアの概要を一度に確認します。追跡対象アーティストの指定期間内の全公演を、都市別にまとめ、トラッカーティアを付けて表示します。

  1 回の実行で月曜朝のブリーフィングを作成できます。イベント開催期間中に SEA をツアー中のアーティストを、需要順に確認できます。

  bandsintown-pp-cli sea-radar --date 2026-08-01,2026-08-31 --tier mid --json
  

ラインアップ分析

• lineup co-bill — 多数のイベントのラインアップ配列を集計し、指定したアーティストと頻繁に共演するアーティストを抽出します。

  フェスのラインアップを組む際、実際の共演履歴に基づいて、相性の良い組み合わせを見つけられます。

  bandsintown-pp-cli lineup co-bill "Phoenix" --since 2024-01-01 --min-shared 2 --json
  

需要分析

• trend — アーティストごとに tracker_count と upcoming_event_count の推移を追跡し、需要の上昇・下降の兆候を明らかにします。

  tracker_count の上昇は、観客需要の先行指標です。同業者が気づく前に予約するアーティストを決めるために使ってください。

  bandsintown-pp-cli trend --top 20 --period 30d --json
  

エージェント向けの連携機能

• pull — 鮮度のしきい値を使って、追跡対象アーティスト全員の公演情報を再取得し、後続のエージェント向けに、追加・削除・変更された公演の構造化された差分を出力します。

  毎日の cron で実行し、差分を Slack またはプロジェクトトラッカーに渡して、追跡対象アーティストが新しい公演を追加した際に通知するようにします。

  bandsintown-pp-cli pull --tracked --since-stale 12 --json
  

積み重ねて活用できるローカル状態

• track — 関心のあるアーティストを登録するローカルのウォッチリストです。同期、スナップショット、route、sea-radar を動作させるために使います。

  一度、厳選したウォッチリストを作成すれば、他のすべての分析コマンドから利用できます。

  bandsintown-pp-cli track add "Phoenix" "Tame Impala" "Beach House"
  

コマンドリファレンス

artists — アーティストを管理します

• bandsintown-pp-cli artists <artistname> — アーティスト情報を取得します

events — 公演を管理します

• bandsintown-pp-cli events <artistname> — アーティストの今後の公演、過去の公演、またはすべての公演を取得するか、日付範囲内の公演を取得します

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

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

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

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

レシピ

月曜朝の SEA ルーティング概要

bandsintown-pp-cli sea-radar --date 2026-08-01,2026-08-31 --tier mid --json --select 'shows.city,shows.artist,shows.datetime,shows.tracker_count'

必要なフィールドだけを使って、8 月のイベント期間に限定した SEA の概要を出力します。まず bandsintown-pp-cli pull --tracked を実行して、ローカルストアにデータを取り込んでください。

今月、需要が高まっているアーティスト

bandsintown-pp-cli trend --top 20 --period 30d --json

今日の tracker_count スナップショットを、過去 30 日間のスナップショットと比較します。上昇幅の大きいアーティストを上位 20 件出力します。時系列データを増やすには、bandsintown-pp-cli snapshot を時間をおいて複数回実行してください。

ヘッドライナー候補のフェス共演アーティスト

bandsintown-pp-cli lineup co-bill "Phoenix" --since 2024-01-01 --min-shared 2 --json

2024 年以降に 2 回以上、Phoenix と同じステージに立ったアーティストをすべて表示します。ラインナップ計画ツールにそのままパイプで渡せます。

イベントに合うアーティストの空き日程を見つける

bandsintown-pp-cli gaps "Beach House" --min 5d --max 21d --in SEA --json

Beach House の SEA ツアー日程で、5〜21 日間の空き期間を表示します。予約につなげられる候補情報です。

認証の設定

認証は不要です。

セットアップを確認するには、bandsintown-pp-cli doctor を実行してください。

エージェントモード

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

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

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

  bandsintown-pp-cli artists mock-value --app-id 550e8400-e29b-41d4-a716-446655440000 --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) の概要は、stdout が端末の場合に限り stderr に出力されます。パイプ／エージェントの利用側には、stdout に純粋な JSON が渡されます。

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

あなた（またはエージェント）がこの CLI に気になる点を見つけたら、記録してください。

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

記録は ~/.bandsintown-pp-cli/feedback.jsonl にローカル保存されます。BANDSINTOWN_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されているか BANDSINTOWN_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルのみに保存されます。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で記録します。そこから知見が積み重なっていきます。

出力の配信

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

シンク	効果
stdout	デフォルト。stdout のみに出力します
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルへの書き込み後にリネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

未対応のスキームは、対応するスキームを示す構造化エラーとともに拒否されます。Webhook が失敗すると、ゼロ以外の終了コードを返し、stderr に URL と HTTP ステータスを記録します。

名前付きプロファイル

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

bandsintown-pp-cli profile save briefing --json
bandsintown-pp-cli --profile briefing artists mock-value --app-id 550e8400-e29b-41d4-a716-446655440000
bandsintown-pp-cli profile list --json
bandsintown-pp-cli profile show briefing
bandsintown-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

この CLI の公開ライブラリーエントリーまたはビルド済みリリースから MCP バイナリをインストールし、登録します。

claude mcp add bandsintown-pp-mcp -- bandsintown-pp-mcp

確認：claude mcp list

直接使用

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

   bandsintown-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：bandsintown-pp-cli <command> --help。