pp-coingecko

Coingecko — Printing Press CLI

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

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

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

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

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

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

go install github.com/mvanhorn/printing-press-library/library/payments/coingecko/cmd/coingecko-pp-cli@latest

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

この CLI を使用しない場合

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

HTTP トランスポート

この CLI は、ブラウザー向けエンドポイントに Chrome 互換の HTTP トランスポートを使用します。通常の API 呼び出しに、常駐ブラウザープロセスは必要ありません。

コマンドリファレンス

coins — コインを管理します

• coingecko-pp-cli coins detail — コインの現在のデータを取得します
• coingecko-pp-cli coins list — ID、シンボル、名前とともにすべてのコインを一覧表示します
• coingecko-pp-cli coins markets — 市場データとともにコインを一覧表示します

global — グローバル情報を管理します

• coingecko-pp-cli global global — 暗号資産市場のグローバルデータを取得します

ping — ping を管理します

• coingecko-pp-cli ping ping — API サーバーのステータスを確認します

search — 検索を管理します

• coingecko-pp-cli search search — コイン、カテゴリー、取引所を検索します
• coingecko-pp-cli coingecko-search-2 — トレンドのコインを取得します

simple — シンプルな機能を管理します

• coingecko-pp-cli simple price — コインの価格を取得します
• coingecko-pp-cli simple supported-vs-currencies — 対応する法定通貨を一覧表示します

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

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

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

which は、自然言語で記述された機能に関する問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 件の一致を意味し、終了コード 2 は信頼できる一致がないことを意味します。その場合は --help を使うか、より具体的な問い合わせに切り替えてください。

認証の設定

認証は不要です。

coingecko-pp-cli doctor を実行して、セットアップを確認してください。

エージェントモード

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

• パイプ対応 — stdout には JSON、stderr にはエラーが出力されます

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列は要素ごとに処理されます。出力が冗長な API でコンテキストを小さく保つために重要です。

  coingecko-pp-cli coins list --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 について気になる点に気づいたら、記録してください。

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

エントリはローカルの ~/.coingecko-pp-cli/feedback.jsonl に保存されます。COINGECKO_FEEDBACK_ENDPOINT が設定されており、さらに --send が指定されるか、COINGECKO_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカルのみです。

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

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は指定した sink に送られ、stdout にも出力されます（または stdout の代わりに送られます）。これにより、エージェントはコマンド結果をパイプで手動転送することなく振り分けられます。次の 3 つの sink に対応しています。

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

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

名前付きプロファイル

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

coingecko-pp-cli profile save briefing --json
coingecko-pp-cli --profile briefing coins list
coingecko-pp-cli profile list --json
coingecko-pp-cli profile show briefing
coingecko-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

   go install github.com/mvanhorn/printing-press-library/library/payments/coingecko/cmd/coingecko-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add coingecko-pp-mcp -- coingecko-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

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

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