coinintel

coinintel

coinintel は、読み取り専用の暗号資産市場インテリジェンス API をラップします。 コインの検索と解決、現在価格と履歴、コインごとのセンチメント、リスクとシグナル、市場全体の健全性、センチメントとレジームの読み取り、トレンドとコインのスキャン、ナラティブ、カテゴリー、資金調達モメンタムとアラートを提供します。1 つのバイナリでコマンドラインインターフェースと stdio MCP サーバーの両方を利用できます。

API キーが必要です。使用前に SHUMI_TOKEN を設定してください。未設定または空白の場合、リクエストを送信する前に、すべてのツールが SHUMI_TOKEN を示すエラーで失敗します。キーは x-api-key ヘッダーで送信されます。API のベース URL は SHUMI_API_URL で上書きできます。設定されていない場合、呼び出し先は https://api.shumi.ai です（これは再構成された URL です。上流の README ではベース URL が公開されていません）。

リストを返すツールには共通の規則があります。top（整数）を指定すると先頭から N 件のみが保持され、fields（カンマ区切りの名前リスト）を指定すると各エントリーで該当するフィールドのみが保持されます。どちらも API に送信され、配列レスポンスにも同じ絞り込みがローカルで適用されます。

このビルドは、ラベル付きのコアサブセットで、読み取り専用ツールが 20 個含まれています。上流のツールセットには、シグナル品質、ペアの提案、実物資産、ロック解除、保有者、ウォレット、先物、バスケット、文字起こし、質問応答、ウェブ検索のツールも記載されていますが、これらはこのサブセットには含まれません。

インストール

npx @reneturcios/coinintel get_regime

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/coinintel

コンテナはデフォルトで MCP サーバーを起動します（下記参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

サブコマンドは MCP ツール名と対応しています。

export SHUMI_TOKEN=...

coinintel lookup_coin --query bitcoin
coinintel resolve_coin --query ether
coinintel get_prices --symbols BTC,ETH --top 2 --fields symbol,price
coinintel get_coin_historical --coin BTC --range 30d
coinintel get_coin_sentiment --coin BTC
coinintel get_coin_risk --coin BTC
coinintel get_global_market
coinintel get_market_health --top 5
coinintel scan_trends
coinintel scan_coins --fields symbol,score
coinintel list_narratives
coinintel get_narrative --narrative "ai tokens"
coinintel list_categories
coinintel get_category --category defi
coinintel get_funding_momentum
coinintel get_funding_alerts
coinintel get_regime
coinintel get_signal --coin BTC

coinintel --version

結果は上流の JSON ペイロードとして出力されます。終了コード：成功時は 0、呼び出し失敗時（トークン未設定または上流 API エラーを含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方のインターフェースを利用できます。mcp サブコマンドは stdio MCP サーバーを起動します。

npx -y @reneturcios/coinintel mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "coinintel": {
      "command": "npx",
      "args": ["-y", "@reneturcios/coinintel", "mcp"],
      "env": { "SHUMI_TOKEN": "..." }
    }
  }
}

ツール

ツール	入力	説明
lookup_coin	query（必須）	フリーテキストのクエリに一致するコインを検索します。
resolve_coin	query（必須）	クエリを単一の正規コインに解決します。
get_prices	symbols（必須の配列）、top、fields	シンボルの現在価格を取得します。
get_coin_historical	coin（必須）、range、top、fields	コインの履歴データを取得します。
get_coin_sentiment	coin（必須）、top、fields	コインのセンチメントデータを取得します。
get_coin_risk	coin（必須）	コインのリスク評価を取得します。
get_global_market	top、fields	世界市場の概要データを取得します。
get_market_health	top、fields	市場の健全性指標を取得します。
get_market_sentiment	top、fields	市場全体のセンチメントを取得します。
get_market_crossing	top、fields	市場のクロッシングシグナルを取得します。
scan_trends	top、fields	現在の市場トレンドをスキャンします。
scan_coins	top、fields	市場の基準に照らしてコインをスキャンします。
list_narratives	top、fields	市場のナラティブを一覧表示します。
get_narrative	narrative（必須）	単一の市場ナラティブを取得します。
list_categories	top、fields	コインのカテゴリーを一覧表示します。
get_category	category（必須）	単一のコインカテゴリーを取得します。
get_funding_momentum	top、fields	資金調達率のモメンタムデータを取得します。
get_funding_alerts	top、fields	資金調達率のアラートを取得します。
get_regime	（なし）	現在の市場レジームを取得します。
get_signal	coin（必須）	コインの取引シグナルを取得します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。