etherscan

Etherscan オーケストレーター

Etherscan のタスクを適切なインターフェースに振り分け、続いて適切なページ、エンドポイント、コマンド、またはツールに誘導します。このスキルはワークフロー兼ルールブックとして使用し、最新のチェーンデータの情報源としては使用しないでください。選択したリファレンスと、そのリファレンスが指定する最新情報の権威ある情報源を、現在のパラメーターと動作の基準として扱ってください。

ワークフローに従う

1. インターフェースを調べる前に、現在の環境で利用できる、タスクに関連する専門スキルを検討してください。ユーザーのユースケースを各スキルの説明と照合し、該当する中で最も具体的なスキルを選択してください。明示的に指定されたスキルが該当する場合は、それを優先してください。
2. 専門スキルが該当する場合は、その内容をすべて読んで従ってください。確認事項、機能の調査、トランスポートの選択、実行、出力はそのスキルに委ねてください。Website、API、CLI、MCP を独自に選んだり、そのスキルの契約に反する出力を追加したりしないでください。選択したスキルが明示的に制御を戻さない限り、このワークフローを中止してください。
3. たとえば、ホップをまたいだ資金の追跡や追跡調査、詐欺・ハッキング・エクスプロイト・資金流出・フィッシング・ラグプル・ウォレット侵害の調査、トランザクションまたはアドレスのフロー可視化や事例生成、あるいは企業や事業体の収入・売上・手数料・支出・経費・財務のプロファイル作成には、the etherscan-flow skill を使用してください。JSON のみという出力形式と、操作ごとのトランスポート優先順位を維持してください。公式 Etherscan CLI → Etherscan MCP → 現在の呼び出しにおける apikey= → その他の文書化されたキーソース。
4. 通常のエクスプローラー操作は、このワークフローの対象として扱ってください。たとえば、「このトランザクションを Etherscan で表示して」という依頼は、ユーザーがそのフローの追跡や可視化を求めていない限り、Website に振り分けてください。
5. 該当する専門スキルがない場合は、依頼内容で未解決のチェーン、対象、意図、プラン、または出力の詳細のみを確認してください。
6. 現在の環境で利用可能な、Etherscan に関連するツールと接続を調べ、その結果を簡潔にユーザーに伝えてください。
7. インターフェースが明示的に指定されている場合は、それに従ってください。そうでなければ、インターフェースを選択する に従って選んでください。
8. 実行する前に、選択したインターフェースのリファレンスをすべて読んでください。別のリファレンスを読むのは、明示的な比較、必要なフォールバック、または実際に複数のインターフェースをまたぐワークフローの場合に限ります。
9. 選択したリファレンスが示す権威ある情報源を通じて、正確なチェーンとチェーン ID を確認してください。EVM 互換性から対応状況を推測してはいけません。
10. その情報源が文書化している正確なページ、エンドポイント、コマンド、またはツール呼び出しを構成してください。
11. スロットリング、ページネーション、切り詰め、プランの制限、エラーのコンテキストを保持したまま結果を返してください。

ローカル機能を調べる

ルートを選ぶ前に、変更を加えない確認を行い、現在の環境で利用可能なタスク関連の Etherscan インターフェースを特定してください。

• Etherscan CLI がインストールされているか確認してください。インストールされている場合は、コマンドやフラグを推測せず、報告されたバージョンと最新のヘルプを確認してください。
• 呼び出し可能な MCP 接続と、調査機能が利用できる場合は公開されているツールを確認してください。設定済み、接続済み、認証済みのアクセスと、文書に記載されているだけの MCP サーバーを区別してください。
• タスクの完了方法に大きく影響する場合は、関連するブラウザー、Web、または HTTP アクセスについて記録してください。
• インストール済みの Etherscan CLI とそのバージョンなど、見つかった関連機能を簡潔に伝え、それによって選択したルートが変わる場合はその理由を説明してください。
• 確認できなかった機能は「不明」として扱い、その機能が存在しないと断定しないでください。
• 機能の確認のみを目的として、ソフトウェアをインストールしたり、認証したり、アカウントを接続したり、認証情報を開示したり、秘密の値を読み取ったりしないでください。

実行前に確認する

必須であり、実際に不足している情報だけを尋ねてください。

• 対象のチェーンとチェーン ID を正確に確認してください。1 つの API キーは複数のチェーンで使えるため、チェーンを明示しないと、誤ったネットワークの有効な結果が返される場合があります。
• 対象となるアドレス、トランザクション、トークン、コントラクト、またはブロックを特定してください。稼働中の機能について、それぞれ異なる動作が文書化されている場合は、対象の種類を区別してください。
• 読み取り専用の調査と、検証、ブロードキャスト、設定の削除、その他の外部への書き込みを区別してください。
• 選択したエンドポイントまたはツールが利用プランによって制限されている場合は、そのプランへのアクセス権を確認してください。プランが不明な場合は、利用可能な無料枠の方法を優先するか、アクセスが制限される可能性があることを伝えてください。
• 要求された出力に応じて、対話形式での確認、構造化された JSON または CSV、エージェントツールの呼び出しから選択してください。

インターフェースを選択する

明示的に指定されたインターフェースがあれば、まずそれを使用してください。指定がない場合は、ユーザーが想定する実行環境と出力に応じて選択してください。

インターフェース	参照先	用途
ウェブサイト	ウェブサイト機能リファレンス。	エクスプローラーページ、ユーザー向けツール、エクスポート、トークン承認、コントラクトユーティリティ、トラッカー、サポートリソースを探します。
API	API リファレンス。	エンドポイントの選択、リクエストの構築、レスポンスの解釈、認証、プラン、レート制限、エラー、対応チェーンの確認を行います。
CLI	CLI リファレンス。	ターミナルコマンドの選択、クライアントの設定、クエリの自動化、構造化出力の生成、ページネーション、データのエクスポートを行います。
MCP	MCP リファレンス。	MCP クライアントの接続、ツールの検出、スキーマの確認、呼び出しの構築、MCP 層の障害と API レベルのエラーの区別を行います。

ユーザーがインターフェースを指定していない場合は、次のデフォルトを適用してください。

• 人が対話形式で作業する場合は、ウェブサイトを優先します。
• アプリケーション連携、または最も幅広いエンドポイントの利用が必要な場合は、API を優先します。
• ターミナルでの自動化、パイプライン、またはエクスポートには CLI を優先します。
• 認証済みの MCP 接続が利用できる場合は、エージェント主導の読み取り専用ツール呼び出しに MCP を優先します。

機能の境界を尊重する

• あるインターフェースで利用できる機能が、別のインターフェースでも利用できるとは推測しないでください。選択したインターフェースの最新の情報源を通じて、現在の機能を確認してください。
• 現在のツール検出結果と公式ドキュメントで状態変更機能が明示的に確認できない限り、MCP は読み取り専用として扱ってください。その他すべての書き込みと同じく、正確な操作に対する承認を求めてください。
• EVM 互換性から対応を推測せず、対象のチェーンとチェーン ID を正確に確認してください。
• 選択したリファレンスが指定する情報源を通じて、変動しうるパラメーター、スキーマ、利用可否、プランへのアクセス、制限、対応チェーンを確認してください。
• スロットリング、ページネーション、切り捨てに関する警告、制限、返されたエラーのコンテキストを維持してください。
• 選択したリファレンスで元のインターフェースではタスクを完了できないことが示されている場合、またはユーザーが別のインターフェースを求めた場合に限り、インターフェースを切り替えてください。

ガードレールを適用する

• 公開されている Etherscan API キーは YourApiKeyToken に置き換えてください。認証情報を表示、コミット、再掲したり、プロンプト、ソースファイル、ログ、出力に含めたりしないでください。
• 制御されていない再試行ループを避け、プラン全体およびエンドポイント固有のスロットリングを遵守してください。
• コントラクト検証の送信、署名済み生トランザクションのブロードキャスト、破壊的な設定変更、その他の状態変更操作を実行する場合は、その操作を正確に指定したうえで、ユーザーから明示的な承認を得てください。
• ユーザーが状態変更操作、そのペイロード、チェーンを正確に承認するまでは、読み取り専用の調査を優先してください。
• API、トランスポート、検証、アプリケーションの各レベルのエラーを、それぞれ異なる失敗コンテキストとして維持してください。

ワークフローの確認

このスキルを変更した後、以下の代表的なケースを使って、ルーティングとガードレールの動作を確認してください。これらは動作に関する指針であり、実際の API に対するアサーションではありません。

リクエストまたは条件	期待される動作
ブロックエクスプローラーでアドレスを表示する。	ウェブサイトのリファレンスと、操作可能なアドレスページを使用します。
ターミナルからウォレットの ERC-20 送金履歴を CSV にエクスポートする。	CLI のリファレンスと、そのページネーションおよび CSV サポートを使用します。
エージェントツールを呼び出して残高を取得する。	ライブディスカバリーで一致するツールが公開されている場合は MCP を使用し、呼び出す前に現在のスキーマを確認します。
トークン保有者数をバックエンドに統合する。	API を使用し、公式ドキュメントから現在のエンドポイントを見つけます。MCP ツールをでっち上げてはいけません。
Etherscan CLI がローカルにインストールされている。	インストール済みのバージョンを伝え、ライブヘルプを確認し、要求された環境と出力に合致する場合は使用します。
MCP サーバーがドキュメントに記載されているが、ライブディスカバリーを利用できない。	利用可能かどうかは不明と報告します。接続済みとして説明したり、ツールの一覧を推測したりしてはいけません。
ユーザーがインターフェースを明示的に要求している。	タスクを実行できない場合を除き、その要望に従います。代替手段が必要な場合は説明します。
残高のリクエストでチェーンが指定されていない。	照会する前にチェーンまたはチェーン ID を確認します。
機能によって対象の種類やプランの利用可否が制限される可能性がある。	呼び出す前に、現在の制限を確認して明示します。
検証または署名済みトランザクションのブロードキャストを要求するワークフロー。	送信前に、正確なペイロード、チェーン、インターフェース、認可を確認します。
MCP による検証またはブロードキャストを要求するワークフロー。	ライブディスカバリーでその操作が公開されているか確認します。公開されていない場合は、対応する認可済みインターフェースを提案します。
入力に API キーが含まれている、または保存済み CLI 認証情報を要求している。	キーを YourApiKeyToken に置き換え、保存された認証情報を平文で絶対に表示しません。

参考資料

• インターフェース固有のディスカバリーと永続的な動作については、同梱の ウェブサイト、API、CLI、MCP のリファレンスを使用してください。
• 選択したリファレンスの優先順位に従ってください。同梱コンテンツと矛盾する場合は、正確なライブページ、エンドポイント仕様、CLI ヘルプ、または MCP スキーマを正としてください。