mcpField
N
nansen-wallet-batch

nansen-wallet-batch

github.com/nansen-aiデータ・データベース144376 回インストール1 日前に更新
リポジトリ

nansen-wallet-batch について

選択したチェーン上のウォレットアドレス、ラベル、トークン残高を一括で調べるNansen CLIのリサーチスキルです。スマートマネーまたはファンドのラベルでアドレスを抽出し、個別のエラーを記録しながら処理を続けます。

主な機能

  1. 01ウォレットアドレスの一括分析
  2. 02ラベルと任意の残高の取得
  3. 03アドレスごとのエラー報告
  4. 04スマートマネーまたはファンドのラベルによる抽出

活用シーン

  1. 01アドレス一覧からスマートマネーのウォレットを選別
  2. 02指定ウォレットのトークン残高の確認

MCP 対応

このスキルはNansen CLIを使用します。READMEによると、既存のOAuth/MCP `nansen:read` の仕様は変更されません。

インストール

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

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-wallet-batch

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

詳細

認証

ブラウザーログインでは、API キー相当のアカウント API 権限を得るために nansen:api を要求します。既存の OAuth/MCP の nansen:read の仕様と、個別のウォレット認証に変更はありません。

調査コマンドやループを実行する前に、明示的に選択された API キーまたは保存済みブラウザーセッションが必要です。まず nansen auth status を実行してください。キャッシュされた未検証のメタデータは、認証情報の有効性やストレージのロック解除を証明するものではありません。キャッシュされたアクセストークンの有効期限切れだけでは、セッションが使用不能とは限りません。CLI は通常、すでに認証済みの調査タスク中に、追加の同意要求や個別のアカウント確認なしで、選択されたセッションを自動更新します。匿名アクセスが選択されている場合、認証状態が無効な場合、更新やクリーンアップがブロックされているか不確かな場合、または更新権限の拒否や期限切れを含む実際の認証エラーが発生した場合は、処理を中止してください。CLI のエラーガイダンスに従い、トラブルシューティングで求められた場合は無料の nansen account 確認を使用してください。失敗したキーを解除したり、セッションを消去したり、再試行のために匿名アクセスへ切り替えたりしないでください。

新たにブラウザーで承認するには nansen login を使用するか、一般的な API キーを設定してください。NANSEN_API_KEY は保存済みセッションより優先されます。OpenClaw の任意の primaryEnv マッピングは、設定済みの API キー注入を維持するものであり、キー必須のゲートでも認証の証明でもありません。通常のクレジットと利用資格が適用されます。ログインによってクレジットが購入されることはありません。ブラウザーログインは CLI 2.0.0 で、macOS arm64 のプレビュー対象範囲内で利用できます。

API キーとブラウザーセッションでは、同じ x402 の自動決済動作が適用されます。サポート対象の HTTP 402 チャレンジが発生すると、既存のウォレット認証、支払いポリシー、利用上限に従い、設定済みのウォレットから資金が支払われる場合があります。ループ内の呼び出しを含め、各呼び出しで支払いが発生する可能性があります。認証、認可、セッション更新の失敗によって支払いが発生することはありません。また、ログイン確認と nansen account で自動的に支払いが行われることもありません。匿名の x402 は、ユーザーの明示的な意思と支払い設定を必要とする、別個の有料ワークフローとして引き続き利用できます。この調査ワークフローを匿名で実行したり、認証失敗後に匿名アクセスへ切り替えたりしないでください。

ADDRESSES="0xaddr1,0xaddr2,0xaddr3,..." CHAIN=ethereum
nansen research profiler batch --addresses "$ADDRESSES" --chain $CHAIN --include labels,balance
# → .data.{total, completed, results[]: {address, chain, labels[], balance, error}}
# labels[]: {label, category ("smart_money","fund","social","behavioral","others"), kind[]}
# balance: {data[]: {token_symbol, token_amount, price_usd, value_usd}}

各結果の .error を確認してください。無効なアドレスはクラッシュせず、エラーメッセージを返します。そのようなアドレスはスキップしてください。 label.category が "smart_money" または "fund" のアドレスを残してください。確認を速くするため、balance は省略してください。

コメント

Markdown 対応