mcpField
C
coingecko-cli

coingecko-cli

github.com/paulrbergデータ・データベース102114 回インストール今日更新
リポジトリ

coingecko-cli について

coingecko-cli は、`cg` コマンドラインツールで CoinGecko の市場データを取得するスキルです。コマンドカタログを参照して、対応操作や認証、プランの制限を確認し、クエリの実行と結果の提示を案内します。

主な機能

  1. 01CLI の状態とコマンドカタログの確認
  2. 02検索によるコイン ID の特定
  3. 03dry-run によるクエリの事前確認
  4. 04JSON 出力または指定時の CSV エクスポート
  5. 05プランとレート制限の確認
  6. 06キーと個人アカウントデータの保護

活用シーン

  1. 01指定したコインの市場データ取得
  2. 02コマンドの対応状況とプラン要件の確認
  3. 03必要な結果の CSV エクスポート
  4. 04シンボルの曖昧さやレート制限への対応

インストール

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

$npx skills add https://github.com/paulrberg/agent-skills --skill coingecko-cli

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

同梱ファイルagents/openai.yaml

詳細

CoinGecko CLI

サポートされている市場データ操作については、インストール済み CLI の機械可読なコマンドカタログを正として扱ってください。

ワークフロー

  1. cg が存在することを確認し、対話形式でない認証／ティアの状態を調べます。

    command -v cg
cg status -o json
cg commands -o json

    ユーザーの承認なしに、対話形式の cg auth を実行したり、設定を書き込んだりしないでください。

  2. コマンド、フラグ、列挙値、出力形式、エンドポイント、認証要件、paid_only の状態は、cg commands -o json から選択します。必要な詳細がカタログにない場合に限り、cg <command> --help を使用してください。

  3. ユーザーが名前または曖昧なシンボルを指定した場合は、cg search <term> -o json で CoinGecko ID を解決します。シンボルが一意であると暗黙に扱わないでください。

  4. 不慣れなリクエストやクォータに影響するリクエストは --dry-run でプレビューします。解析可能なクエリは -o json で実行し、ユーザーが CSV ファイルを求めた場合に限り --export を使用します。

  5. 要求された形式で結果を提示します。一般的な人間向けの出力では、簡潔な表を使用し、資産の規模に応じた十分な精度を保ちます。

境界とデフォルト

  • コマンドが対応している場合は、1 回のリクエストに ID をまとめてください。429 が返された場合は、積極的に再試行せず、報告されたリセット時間／バックオフに従ってください。
  • 実行前に有料限定コマンドかどうかを確認してください。現在のティアでリクエストに対応できない場合は、その旨を伝え、対応可能な方法を提示してください。
  • cg は CoinGecko のすべてのエンドポイントに対応しているわけではありません。未対応のコントラクトアドレスの価格、全体統計、NFT の詳細、GeckoTerminal、ロゴメタデータについては、 https://docs.coingecko.com/llms.txt から最新の API ドキュメントを取得し、CLI では対応できないことを伝えてください。
  • API キーを公開したり、プライベートなウォレット／アカウント情報を市場データのエンドポイントに送信したりしないでください。

完了には、解決したコイン／コマンド、成功した JSON または要求されたエクスポートの証拠、およびティア、曖昧さ、レート制限への明示的な対応が必要です。

ユーザー向け出力

一般的な人間向けの出力では、### 🪙 <coin> (<id>) から始め、要求された指標のみを簡潔な表に示します。重要な場合は、エンドポイントとタイムスタンプ、ティア、または期間を含む出典行を 1 行追加します。エクスポートでは、### ✅ Exported <row count> rows を使い、ファイルへのリンクを示して、CSV を再掲せずにクエリ／期間を記載します。処理をユーザーに戻す場合は ### ⚠️ Rate limited — retry after <time>、実際に待機中の場合に限り ### ⏳ Rate limited — retrying after <time> を使います。有料エンドポイントの場合は ### ⚠️ Paid endpoint — current tier: <tier> と、対応可能な方法を 1 つ提示します。要求された JSON／CSV、正確な ID、URL、値、コマンド、診断情報には装飾を加えないでください。

コメント

Markdown 対応