Search

Overview

Tool	Function	Use Case
search	Blockchain search	Token/contract/account/tx/block by keyword or name

1. Contract address by name: User asks "USDT contract address" or "BTT contract on TRON" — use search with term (e.g. USDT, BTT) and optional type: token or type: contract to get matching tokens/contracts and their addresses (token_id / contract address).
Token by symbol or name: Same as above; filter by type: token for token-only results.
Contract by name: Use search with type: contract to find contracts by name or address.
Account search: Use search with type: address to search accounts.
Transaction or block: Use search with type: transaction or type: block when the user provides a tx hash or block number/keyword.

- API: search — Search the TRON blockchain for tokens, contracts, accounts, transactions, or blocks
Use when: User asks for "USDT contract address", "find token by name", "search for contract X", or any lookup by name/keyword.
Input: term (required, search keyword e.g. USDT, BTT, or contract name), optional type (token | address | contract | transaction | block), optional start, limit.
Response: Matches per type; for tokens, each item includes token_id (contract address), name, abbr, token_type, and other metadata.

- MCP connection failed: If you see "Connection refused", verify TronScan MCP is connected in Settings > Extensions.
API rate limit / 429: TronScan API has call count and frequency limits when no API key is used. If you encounter rate limiting or 429 errors, go to TronScan Developer API to apply for an API key, then add it to your MCP configuration and retry.

Try broader keywords or different type filter (token | address | contract | transaction | block).

- For "contract address by name" (e.g. USDT), call search with term: "USDT" and type: "token" (or omit type); the first or best match usually has token_id = TRC20 contract address (e.g. USDT = TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t).
Use this skill before tronscan-token-scanner or tronscan-contract-analysis when the user only provides a name/symbol and you need the address to call other tools.
Search result token items may include tokenCanShow. If a result has tokenCanShow: false, treat it as a risk signal and inform the user before proceeding. For full risk field semantics, see tronscan-token-scanner.

工具	功能	使用场景
搜索	区块链搜索	通过关键词或名称搜索代币/合约/账户/交易/区块

1. 按名称查找合约地址：用户询问USDT合约地址或波场上的BTT合约——使用search工具，传入term参数（例如USDT、BTT），可选type: token或type: contract参数，获取匹配的代币/合约及其地址（token_id/合约地址）。
按符号或名称查找代币：同上；通过type: token过滤仅返回代币结果。
按名称查找合约：使用search工具并传入type: contract参数，按名称或地址查找合约。
账户搜索：使用search工具并传入type: address参数搜索账户。
交易或区块搜索：当用户提供交易哈希或区块编号/关键词时，使用search工具并传入type: transaction或type: block参数。

- API：search — 在TRON区块链上搜索代币、合约、账户、交易或区块
使用时机：当用户询问USDT合约地址、按名称查找代币、搜索合约X或任何按名称/关键词的查询时。
输入参数：term（必填，搜索关键词，例如USDT、BTT或合约名称），可选type（token | address | contract | transaction | block），可选start、limit。
返回结果：按类型返回匹配项；对于代币，每个项目包含tokenid（合约地址）、name、abbr、tokentype及其他元数据。

- MCP连接失败：如果看到连接被拒绝，请验证TronScan MCP是否已在设置 > 扩展中连接。
API速率限制/429错误：未使用API密钥时，TronScan API有调用次数和频率限制。如果遇到速率限制或429错误，请前往TronScan开发者API申请API密钥，然后将其添加到MCP配置中并重试。

尝试更宽泛的关键词或不同的类型过滤器（token | address | contract | transaction | block）。

- 对于按名称查找合约地址（例如USDT），调用search工具时传入term: USDT和type: token（或省略type参数）；第一个或最佳匹配通常包含token_id = TRC20合约地址（例如USDT = TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t）。
当用户仅提供名称/符号，且你需要地址来调用其他工具时，请在使用tronscan-token-scanner或tronscan-contract-analysis之前使用此技能。
搜索结果中的代币项目可能包含tokenCanShow字段。如果某个结果的tokenCanShow: false，请将其视为风险信号，并在继续操作前告知用户。有关完整的风险字段语义，请参阅tronscan-token-scanner。