goldrush-cli

GoldRush CLI

AI エージェント向けに MCP をサポートする、ターミナルファーストのブロックチェーンデータツールです。ウォレットを照会し、DEX ペアをストリーミングし、オンチェーンのライブデータをコマンドラインから Claude に直接渡せます。

クイックスタート

# Install and authenticate
npx @covalenthq/goldrush-cli auth

# Query wallet balances
goldrush balances eth-mainnet vitalik.eth

# Stream new DEX pairs
goldrush new_pairs solana-mainnet raydium

# Set up MCP for Claude
goldrush install

コマンド

コマンドは、ポートフォリオ管理、市場の探索、取引インテリジェンス、各種ユーティリティにわたります。すべてのパラメーターと使用例を含む完全なリファレンスについては、overview.md をご覧ください。

ポートフォリオとウォレット

• goldrush balances <chain> <address> — USD の評価額と24時間の変動を含む、トークンポートフォリオ全体
• goldrush transfers <address> <chain> — 任意のウォレットの送金履歴
• goldrush watch <address> <chain> — ウォレットのアクティビティをリアルタイムでストリーミング

市場の探索

• goldrush new_pairs <chain> [protocols...] — 新しい DEX 流動性ペアのライブストリーム
• goldrush ohlcv_pairs <pair> <chain> [-i interval] — ASCII のライブ OHLCV ローソク足チャート

取引インテリジェンス

• goldrush traders <token> <chain> — 未実現損益で順位付けしたトップトレーダー
• goldrush gas [chain] — リアルタイムのガス価格の推定値
• goldrush search <query> — 名前、シンボル、またはアドレスでトークンを検索

ユーティリティ

• goldrush chains — サポートされているチェーンを一覧表示
• goldrush auth — API キーを設定（OS のキーチェーンに保存）
• goldrush install — MCP 統合用に Claude を設定
• goldrush config — 設定を表示／更新
• goldrush status — API キーと接続状態を確認
• goldrush logout — セッションデータを消去

重要なルール

1. チェーン名には kebab-case を使用します — eth-mainnet、solana-mainnet（Foundational API と同じ）
2. 認証 — goldrush auth を使って API キーを OS のキーチェーンに保存します。環境変数には保存しません
3. MCP にはセットアップが必要です — Claude が GoldRush ツールを使う前に goldrush install を実行してください
4. ストリーミングコマンド — new_pairs、ohlcv_pairs、watch は内部で Streaming API を使用します
5. 出力は整形済みのテーブルです — 人が読みやすいターミナル出力を想定しています。AI による処理には Claude にパイプで渡してください

MCP 統合

この CLI は MCP サーバーです。goldrush install を実行すると、GoldRush が Claude のツールプロバイダーとして登録されます。エージェントはその後、ラッパーや手動設定なしで GoldRush コマンドをネイティブに呼び出せます。

リファレンスファイル

ファイル	確認するタイミング
overview.md	パラメーターや使用例、MCP のセットアップに関する詳細を含む、コマンドの完全なリファレンスが必要な場合