---
title: "Transforme o Claude Code em um agente de pesquisa onchain"
description: "Transforme o Claude Code em um agente de pesquisa onchain com o Alchemy CLI. Rastreie lançamentos de tokens, carteiras de deployers e admin keys fazendo as perguntas certas."
---

# Transforme o Claude Code em um agente de pesquisa onchain

<ImageBlock
  src="https://media.alchemy.com/blog/onchain-research-agent-claude-code-hero.png"
  alt="Transforme o Claude Code em um agente de pesquisa onchain"
  width={1920}
  height={900}
  priority
/>

Ler um block explorer costumava ser uma das habilidades de maior ROI em cripto. Seguir um rastro de financiamento, decodificar chamadas de contrato e identificar compras de insiders exigia prática de verdade, e quem sabia fazer isso tinha uma vantagem. Essa vantagem agora custa uma assinatura do Claude e acesso a [RPC](https://www.alchemy.com/rpc-api) de blockchain. A habilidade agora é saber quais perguntas fazer. De onde veio o dinheiro? Quem tem as chaves de admin? O que o dev pode realmente fazer? Um agente consegue responder às três, desde que você dê a chain e a pergunta.

## O que um agente de pesquisa precisa?

Duas coisas: um agente de codificação e uma forma de ler a chain. Se você seguiu nosso guia para [configurar o Claude Code com a Alchemy](https://www.alchemy.com/blog/setup-claude-code-with-alchemy), você já tem ambos. Caso contrário, instale a [Alchemy CLI](https://www.alchemy.com/agents) e faça login:

<CodeSnippet
  language="bash"
  code={`npm i -g @alchemy/cli@latest
alchemy auth login
alchemy install skills`}
/>

`alchemy install skills` ensina o Claude Code a usar a CLI, para que ele consulte saldos, [histórico de transações](https://www.alchemy.com/docs/reference/transfers-api) e estado de contratos sem adivinhar comandos. Se você prefere tools em vez de uma CLI, o [Alchemy MCP server](https://www.alchemy.com/docs/alchemy-mcp-server) expõe os mesmos dados como 168 tools em mais de 100 networks, e o [Alchemy plugin for Claude Code](https://www.alchemy.com/blog/alchemy-claude-plugin-now-live) reúne os dois em uma única instalação. A CLI ainda consegue pagar por leituras por chamada [via x402](https://www.alchemy.com/blog/how-x402-brings-real-time-crypto-payments-to-the-web), então um agente com uma wallet financiada nem precisa de uma API key.

Dois complementos opcionais deixam o agente um investigador mais afiado. Uma chave de [Etherscan API](https://etherscan.io/apis) permite que ele puxe o código-fonte verificado do contrato, para que possa ler o que uma função realmente faz em vez de inferir a partir do seletor. E a [plataforma de inteligência da Arkham](https://intel.arkm.com/) mapeia endereços para entidades do mundo real, o que transforma "financiado por 0x4f2a..." em "financiado por uma hot wallet da Binance". Nenhum dos dois é obrigatório. Só o RPC já responde à maioria das perguntas sobre um launch.

## Como é uma investigação de verdade?

Pegue um exemplo real do vídeo: um memecoin lançado através de um hook do Uniswap v4 com uma bonding curve. A equipe era anônima, e o lançamento foi anunciado como fair launch. Uma alegação de fair launch é verificável, então verificamos.

O prompt dado ao Claude Code, levemente limpo:

> This token launched via a Uniswap v4 hook with a bonding curve and claimed a fair launch. Find the hook, the token deployment, and the initial liquidity transactions. Check whether the deployer bought anything before the public could. Trace where the deployer wallet was funded from. Use the Alchemy CLI for RPC and data.

A partir daí, o agente trabalhou da mesma forma que um analista trabalharia, só que mais rápido. Ele puxou a transação de deployment, identificou o endereço do deployer, reconstruiu os primeiros minutos de negociação a partir do histórico de transfers e seguiu o rastro de financiamento do deployer para trás. Alguns minutos depois, ele voltou com um veredito, e cada afirmação nele trazia uma fonte: o hash da transação, o endereço do contrato ou o block que ele leu.

O veredito sobre esse lançamento teve dois lados. Mecanicamente, a alegação de fair launch em grande parte se sustentou. Sem presale, sem alocação para a equipe, sem mint oculto. Mas o deployer fez front-run do próprio lançamento, comprando antes que o público tivesse a chance. E a wallet do deployer foi financiada através de um protocolo de privacidade, então o rastro de identidade para ali. Um lançamento pode ser mecanicamente justo e ainda assim vir de alguém que comprou primeiro e escondeu quem é. Essa nuance raramente sobrevive a uma rolada rápida por um explorer.

Ninguém leu uma página de explorer manualmente para chegar até ali. A execução inteira foi um prompt e alguns minutos de espera.

## Quais perguntas você deveria fazer?

As mesmas perguntas funcionam em todo token que você algum dia vai analisar, e é isso que as torna válidas de aprender. Comece com estas:

- **De onde veio o dinheiro?** Rastreie o financiamento do deployer. Uma wallet nova financiada por uma exchange é normal. Financiada através de um mixer ou pool de privacidade é um sinal que vale a pena pesar.
- **Quem tem as chaves de admin, e o que elas podem fazer?** Peça ao agente para ler o contrato e listar toda função privilegiada: mint, pause, upgrade, mudanças de fee, blacklists. "O que o dev pode realmente fazer" é uma pergunta sobre código, e o código é público.
- **Insiders se moveram antes que o público pudesse?** Reconstrua o lançamento block por block. Compras do deployer, sniper wallets financiadas pela mesma fonte, liquidez retirada e reinserida.
- **Onde a liquidez realmente está?** Quem a forneceu, se está locked, e o que acontece com os holders se ela sair.

Aqui está um prompt que você pode colar no Claude Code para rodar a mesma investigação em qualquer token. Ele pergunta o seu alvo primeiro, então nunca inventa um:

<CodeSnippet
  language="text"
  code={`You are an onchain investigator. Start by asking me for the token contract address and the chain it lives on. Wait for my answers and confirm them back before doing anything.
Then, using the Alchemy CLI for RPC and data:
- Find the deployment transaction and the deployer address.
- Reconstruct the launch: initial liquidity, the first buys, and whether the deployer or related wallets bought before the public.
- Trace where the deployer wallet was funded from, as far back as the trail goes.
- Read the token and pool contracts and list every privileged permission: minting, pausing, upgrading, fee changes, blacklists.
- Give me a verdict on any claims the project makes about its launch.
Cite a transaction hash or contract address for every claim, and say plainly when a trail goes cold. This is read-only research. Do not sign or send any transactions.`}
/>

<ExternalVideo
  url="https://www.youtube.com/watch?v=DGoNsfaXLdg"
  provider="youtube"
  providerUid="DGoNsfaXLdg"
/>

Dá para ir além a partir daí. Peça ao agente para puxar os contratos verificados e explicar as funções de risco, ou para comparar o token com um ERC-20 padrão e explicar cada desvio. O post [12 things you can do faster with the Alchemy CLI](https://www.alchemy.com/blog/12-things-faster-with-alchemy-cli) tem mais padrões que valem a pena copiar.

## Comece a fazer perguntas melhores

Tudo isso roda no tier gratuito. Instale a [Alchemy CLI](https://www.alchemy.com/agents), faça login, e seu agente estará lendo a mainnet em menos de um minuto. Sem contratos, sem waitlist, sem API key se você rotear leituras via x402. E quando seu agente de pesquisa evoluir para algo que age com base no que encontra, nosso guia sobre [building onchain agents](https://www.alchemy.com/blog/how-to-build-onchain-agents) cobre as camadas de wallet, pagamento e dados que vêm em seguida.

Block explorers não vão a lugar nenhum, e saber se movimentar em um ainda ajuda. Mas a leitura agora é trabalho do agente. Decidir o que perguntar é seu.