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；一个 API 密钥可用于许多条链，因此未明确指定链可能会在错误的网络上返回有效结果。
• 确定涉及的地址、交易、代币、合约或区块。如果实时能力说明对不同目标类型的行为有所不同，请加以区分。
• 区分只读检查与验证、广播、删除配置或其他外部写入操作。
• 如果所选端点或工具受访问权限限制，请确认 API 方案是否允许访问。方案未知时，优先选择可用的免费方案路径，或说明访问权限可能受限。
• 根据用户要求的输出，选择交互式审查、结构化 JSON 或 CSV，或 Agent 工具调用。

选择接口

优先遵循用户明确指定的接口。否则，根据用户的预期执行环境和输出选择接口。

接口	阅读	适用场景
网站	网站功能参考。	查找浏览器页面、面向用户的工具、导出功能、代币授权、合约实用工具、跟踪器和支持资源。
API	API 参考。	选择端点、构造请求、解读响应、检查身份验证、方案、速率限制、错误和支持的链。
CLI	CLI 参考。	选择终端命令、配置客户端、自动化查询、生成结构化输出、分页和导出数据。
MCP	MCP 参考。	连接 MCP 客户端、发现工具、检查架构、构造调用，并区分 MCP 层故障与 API 层错误。

用户未指定接口时，采用以下默认选择。

• 交互式人工工作流优先使用网站。
• 应用集成或需要最广泛端点覆盖时，优先使用 API。
• 终端自动化、管道或导出优先使用 CLI。
• 存在经过身份验证的 MCP 连接时，Agent 驱动的只读工具调用优先使用 MCP。

遵守能力边界

• 不要推断某个接口具备的能力也存在于其他接口。应通过所选接口的实时权威来源发现当前能力。
• 除非当前工具发现结果和官方文档明确说明 MCP 具备更改状态的能力，否则应将 MCP 视为只读。任何写入操作都必须获得同样明确的授权。
• 确认具体的链和链 ID，不要根据 EVM 兼容性推断是否支持。
• 通过所选参考文档指定的权威来源，核实易变参数、架构、可用性、方案访问权限、限制和支持的链。
• 保留限流、分页、截断警告、限制以及返回的错误上下文。
• 仅当所选参考文档表明原接口无法完成任务，或用户要求更换接口时，才切换接口。

应用安全措施

• 将任何暴露的 Etherscan API 密钥替换为 YourApiKeyToken。切勿在提示词、源文件、日志或输出中打印、提交、复现或放置凭据。
• 避免不受控制的重试循环，并遵守方案级和端点级限流。
• 对具体的合约验证提交、已签名原始交易广播、破坏性配置更改或其他状态更改操作，必须获得用户明确授权。
• 在用户授权具体的状态更改操作、负载和链之前，优先进行只读检查。
• 将 API、传输、验证和应用层错误保留为不同的故障上下文。

工作流检查

更改此技能后，请使用以下代表性用例验证路由和防护行为。请将其视为行为指导，而非实时 API 断言。

请求或条件	预期行为
在区块浏览器中显示一个地址。	使用网站参考，并打开交互式地址页面。
从终端将某个钱包的 ERC-20 转账记录导出为 CSV。	使用 CLI 参考及其分页和 CSV 支持。
调用 Agent 工具来查询余额。	如果实时发现结果中有匹配工具，则使用 MCP；调用前检查其当前架构。
将代币持有者数量集成到后端。	使用 API，并从官方文档中发现当前端点；不要虚构 MCP 工具。
本地已安装 Etherscan CLI。	说明已安装的版本，检查其实时帮助信息，并在它符合所请求的环境和输出要求时使用它。
文档中提到了 MCP 服务，但无法进行实时发现。	报告其可用性未知；不要称其已连接，也不要推断其工具清单。
用户明确要求使用某个接口。	除非该接口无法完成任务，否则应遵从；如需回退，则说明原因。
余额请求未指定链。	查询前询问链或链 ID。
某项功能可能限制目标类型或套餐访问权限。	调用前核实并说明当前限制。
工作流请求执行验证或广播已签名交易。	提交前确认确切载荷、链、接口和授权。
工作流请求通过 MCP 进行验证或广播。	核实实时发现结果是否公开了该操作；否则提供能够执行该操作且经过授权的接口。
输入包含 API 密钥，或请求使用已存储的 CLI 凭据。	将密钥替换为 YourApiKeyToken，绝不输出已存储的明文凭据。

更多参考资料

• 使用随附的网站、API、CLI和 MCP参考资料，以了解特定接口的发现方式和持久行为。
• 遵循所选参考资料的权威顺序。若实时页面、端点规范、CLI 帮助信息或 MCP 架构与随附内容冲突，则以其确切内容为准。