IA by DNACXGUIA / 01

GUIA 01 / DO PEDIDO À LISTA

Prospecção com Clay
e Claude Code.
Do critério à lista.

Use Claude Code com o plugin do Clay para pesquisar empresas a partir de um critério. Peça site, evidência e fonte. Revise cada resultado antes de usar a lista.

Diogo Kammers
Diogo KammersIA by DNACX · revisão de 23/10/2026

Guia em validação. A simulação usa empresas fictícias. As instruções foram conferidas na documentação; não representam uma execução validada em conta real.

O CRITÉRIO VIAJA COM O PEDIDO
● ● ●01 / PEDIDO

› Busque empresas.
Traga fontes.
Separe as dúvidas.

SETOR + REGIÃO + CRITÉRIO
02O critério
continua aqui.
03 / LISTA REVISÁVEL

Quem faz sentido?

Empresa AConferir ↗
Empresa BRevisar ○
Empresa CConferir ↗
FONTE JUNTO. DÚVIDA EXPLÍCITA.
01 PEDIR→02 CONFERIR→03 DECIDIR

Diagrama ilustrativo, sem conexão com ferramentas.

O QUE VOCÊ VAI FAZER

Uma lista com critério, evidência e fonte.

Este guia mostra como pedir uma pesquisa de empresas ao Clay pelo Claude Code e revisar os resultados antes de usar a lista. Os prompts também podem ser usados no Codex, conforme as ferramentas disponíveis.

Você precisa
Agente instalado, acesso ao Clay e permissões compatíveis. Cadastro e login são feitos por você.
Você recebe
Pedidos copiáveis, checklist e método para organizar nome, site, critério, fonte e pendências em um CSV.
Antes de executar
Confira o plano, as ferramentas e o consumo da conta. Nenhuma pesquisa real é iniciada por esta página.
Abrir a experiência guiada ↗

Como você quer começar?

Escolha seu caminho. A gente abre uma etapa por vez.

Prefiro a versão de leitura contínua ↗

SEU GUIA, NO SEU RITMO

Escolha um caminho para começar.

Etapa 1

01

ANTES DA BUSCA

Uma lista útil explica
por que cada empresa entrou.

Prospecção é a pesquisa de empresas que podem ter relação com o que você oferece. O primeiro trabalho é definir esse encaixe. “Encontre clientes” deixa decisões demais em aberto.

A saída que você procura é uma lista pequena, com informações que possam ser conferidas. Encontrar uma empresa não significa que ela precisa comprar de você.

O QUE PEDIR

Nome e site

Identifique a empresa sem depender só de um nome parecido.

POR QUE ENTROU

Critério e evidência

Uma informação concreta que sustente o encaixe com o pedido.

COMO CONFERIR

Fonte e pendência

Onde abrir a informação e o que ainda falta confirmar.

Escolha um critério que deixe uma pista.

“Tem uma página de lojas no site” pode ser verificado. “Precisa muito do meu serviço” é uma suposição. Comece pelo primeiro tipo.

02

PREPARE O ACESSO

Deixe as ferramentas prontas.
Depois, faça o pedido.

Claude Code é o ambiente em que você descreve o trabalho e acompanha as ações. O plugin acrescenta as instruções e a ferramenta de linha de comando do Clay, chamada CLI. Ela permite consultar o Clay a partir desse ambiente. A documentação diferencia esse caminho de uma conexão MCP. [1]

1

Confira as duas contas. Você precisa de acesso ao agente e a um workspace do Clay. Workspace é o espaço da sua equipe. Confira as permissões exigidas no guia oficial antes de instalar.

2

Escolha onde vai trabalhar. No Windows, siga a orientação do Clay para WSL, o ambiente Linux dentro do Windows. Se você nunca configurou isso, faça a instalação com apoio técnico. A cópia dos prompts não exige instalação neste protótipo.

3

Instale e conecte pelo guia oficial. Abra o link de instalação abaixo. Faça a autorização na sua própria conta e confira o workspace escolhido. Não compartilhe senhas ou chaves no prompt.

SEU AMBIENTE

Abra o Claude Code dentro do Ubuntu/WSL, conforme o guia do Clay. Não cole os comandos de instalação Linux no PowerShell.

Abrir instalação oficial ↗

Os comandos e permissões devem ser conferidos na documentação no dia da instalação.

ANTES DE PESQUISAR
Confira se o plugin do Clay está disponível neste ambiente e mostre qual workspace está conectado. Não pesquise nem altere dados ainda. Se faltar acesso, explique o que preciso configurar e pare.
03

A BANCADA DO PEDIDO

Troque os campos.
O pedido fica mais claro.

Use termos que você conhece. Escolha uma região e um sinal observável. Comece com poucas empresas para descobrir se o critério funciona antes de ampliar a busca.

VOCÊ DEFINE01 / BRIEFING

Quantidade vira parte do pedido. A demonstração usa sempre quatro fichas fictícias.

O PEDIDO GANHA FORMA02 / PROMPT

Para Claude Code. Também funciona no Codex, conforme as ferramentas disponíveis.

Pesquise até 10 empresas do segmento redes de lojas de materiais de construção em Santa Catarina, usando o Clay disponível neste ambiente.

Critério obrigatório: uma página de lojas no site oficial.
Antes de iniciar, confirme os filtros disponíveis e se a busca cabe nas condições da conta. Se não for possível conferir o consumo, explique essa limitação e aguarde minha decisão.

Para cada empresa, traga nome, site, região, evidência do critério, URL da fonte e uma pendência, se houver. Separe em: conferir na fonte, precisa de revisão e fora do critério. Não invente informação ausente. Não procure dados pessoais, não envie mensagens e não crie automações.
Explorar a saída ↓

O texto muda neste navegador. Não enviamos os campos para uma IA ou serviço externo.

04

UM LABORATÓRIO PARA ENTENDER

Agora, veja o critério
separar a lista.

Experimente com as quatro empresas fictícias. Depois abra a evidência de uma ficha para entender o motivo do estado. Na pesquisa real, é você quem abre a fonte e confere a informação.

SIMULAÇÃO

Empresas e trechos inventados para ensinar a revisão. Nenhuma busca real é feita, e as fichas não são recomendações comerciais.

CRITÉRIO EM USO

Uma página de lojas no site oficial

As quatro fichas estão prontas para uma revisão ilustrativa.

A

Empresa A

EXEMPLO FICTÍCIO
Conferir ↗

O trecho ilustrativo menciona lojas na região escolhida.

Abrir evidência ilustrativa +
“Veja os endereços das nossas lojas em Santa Catarina.”

Na execução real, abra a URL do site oficial e verifique o conteúdo completo. Este trecho não tem fonte real.

B

Empresa B

EXEMPLO FICTÍCIO
Revisar ○

O trecho está incompleto e não confirma o critério.

Abrir evidência ilustrativa +
“Entre em contato para saber mais sobre a nossa operação.”

Falta uma informação verificável. Não complete a lacuna por conta própria.

C

Empresa C

EXEMPLO FICTÍCIO
Fora do critério ×

O exemplo informa atuação em outra região.

Abrir evidência ilustrativa +
“Nossa atuação está restrita a uma região diferente da solicitada.”

Ter um site não basta. O resultado também precisa atender ao recorte do pedido.

D

Empresa D

EXEMPLO FICTÍCIO
Conferir ↗

Há um sinal do critério, ainda sujeito à leitura da fonte.

Abrir evidência ilustrativa +
“Encontre uma unidade na região informada.”

Um sinal pede conferência. Não equivale a qualificação comercial ou intenção de compra.

0 de 4 fichas exploradas

Marcar uma ficha registra apenas sua exploração desta simulação.

05

NA SUA CONTA, COM DADOS REAIS

Abra a fonte.
A decisão continua sua.

1

Execute um primeiro lote.

Cole o pedido no ambiente conectado. Leia o que o agente pretende fazer e acompanhe o resultado. Se ele não encontrar uma informação, mantenha a pendência visível. Não peça para “completar” uma lista com suposições.

2

Confira cada resultado na origem.

Abra o site indicado. Compare região e evidência com seu pedido. Um diretório de terceiros pode ajudar a encontrar uma empresa, mas não substitui a confirmação no site quando esse foi o critério escolhido.

3

Separe o que não foi confirmado.

Use estados escritos. “Precisa de revisão” preserva uma dúvida; “fora do critério” registra uma exclusão. Não misture essas duas situações. Se muitas linhas ficarem sem prova, ajuste o pedido antes de pesquisar mais.

Prompt para Claude Code. Também pode ser usado no Codex, conforme as ferramentas disponíveis.

PROMPT DE REVISÃO
Revise a lista usando o critério do pedido original. Para cada linha, mostre qual informação sustenta o encaixe e onde eu posso conferi-la. Separe ausência de informação de evidência de que a empresa não atende ao critério. Não invente URLs, não preencha lacunas por suposição e não marque como revisado algo que eu ainda não conferi.
06

LEVE O TRABALHO COM VOCÊ

Sua lista, com fontes.
Pronta para continuar.

Quando a lista estiver conferida, peça um arquivo.

Um CSV é uma tabela em arquivo de texto que pode ser aberta em uma planilha. Antes de salvar, confira acentos, colunas e quantidade de linhas. O arquivo deve preservar as fontes e as dúvidas, não só os nomes.

Prompt para Claude Code. Também pode ser usado no Codex, conforme as ferramentas disponíveis.

PROMPT DE EXPORTAÇÃO
Prepare um CSV local a partir da lista revisada, com as colunas: empresa, site, região, critério, evidência, fonte, estado e pendência. Preserve a classificação que foi conferida, remova duplicatas pelo domínio e mostre onde salvou o arquivo. Se não puder criar o arquivo neste ambiente, entregue o conteúdo em texto e explique como salvar. Não importe a lista em outro sistema e não envie mensagens.
A próxima etapa tem outro objetivo.

Esta lista ajuda a escolher quem merece investigação. A abordagem exige contexto próprio e revisão do canal, da mensagem e das condições de uso dos dados. Ela não faz parte desta demonstração.

06

CUSTO E LIMITES À VISTA

Confira o custo
antes de ampliar o lote.

CLAY

Verifique plano, cotas, créditos e ações disponíveis na sua conta.

AGENTE

O acesso ao Claude Code tem condições próprias. Confira sua assinatura e seus limites.

OPERAÇÃO

Pesquisa e verificações podem consumir recursos. Uma lista maior não garante mais empresas aderentes.

O guia de instalação do Clay descreve disponibilidade e limites por plano. Não fixamos preços neste piloto. Consulte as condições atuais antes de executar a busca. [1]

Se acontecer isto, faça esta conferência.

O plugin não aparece +

Confira o ambiente em que ele foi instalado, reinicie a sessão e siga o diagnóstico oficial. Peça ao agente para verificar a instalação antes de tentar uma busca.

Vieram empresas que não servem +

Volte ao critério: ele está explícito e pode ser comprovado? Confira se a região é uma informação real da empresa. Reduza o lote e teste o recorte novamente.

A evidência não tem link ou está vaga +

Mantenha a empresa em revisão e peça a origem. Se a informação não puder ser localizada, não trate a linha como confirmada.

O agente não consegue conferir o consumo +

Pare e consulte os limites na conta. Não transforme uma estimativa do agente em preço garantido ou em autorização para gastar.

01

O CLAUDE CODE COMO GUIA

Um pedido para preparar.
Perguntar. Pesquisar. Entregar.

Este prompt foi preparado para Claude Code e também pode ser usado no Codex. Abra o agente escolhido e cole o prompt completo. Ele orienta o agente a conferir o ambiente, preparar o plugin oficial, perguntar seu recorte e trabalhar pela conversa. Cadastro, login e autorização de conta ficam com você.

VOCÊDefine e autentica.

Responde às escolhas, cria a conta e faz o login quando solicitado.

CLAUDE CODEPrepara e conduz.

Executa o que o ambiente permitir, confere o acesso e mostra o próximo passo.

UM PROMPT COMPLETO, EM ETAPAS

Do ambiente inicial
ao arquivo com fontes.

Inclui configuração, pausas para login, escolhas guiadas, limites de consumo, busca, revisão e CSV local.

Baixar o prompt em .md ↓
Quero ler antes de copiar +
# Prospecção guiada com Clay

Prompt para Claude Code. Também pode ser usado no Codex: adapte a configuração às ferramentas disponíveis, sem presumir que plugins e comandos de um cliente existem no outro.

Atue no ambiente em que este prompt foi colado, Claude Code ou Codex. Verifique suas ferramentas reais antes de escolher a integração. No Codex, use CLI ou integração oficial disponível; não presuma compatibilidade com plugins exclusivos do Claude Code. Se algo não tiver suporte, explique e pause.

Quero que você me guie e execute a preparação de uma pesquisa de empresas com Claude Code e o plugin oficial do Clay, do ambiente inicial até uma lista com fontes e um CSV local. Sou uma pessoa de negócio. Use português claro e avance por etapas.

Meu objetivo é fazer a operação pela conversa, sem operar o painel do Clay. Eu assumo criação de conta, login, confirmação de identidade e autorizações da minha conta quando forem necessários. Você executa o que as ferramentas e permissões deste ambiente realmente permitirem. Não diga que concluiu uma etapa sem evidência.

1. CONFIRA O AMBIENTE
Identifique sistema operacional, terminal, ferramentas disponíveis e a pasta de trabalho. Não altere arquivos ou configurações de outros projetos. Crie uma pasta própria para esta atividade quando o ambiente permitir.
Leia a documentação atual antes de instalar ou emitir comandos:
https://university.clay.com/docs/clay-api-cli
https://university.clay.com/docs/using-clay-plugin
https://github.com/clay-run/agent-plugins
Use o caminho do plugin e CLI, sem confundi-lo com a conexão MCP separada. No Windows, confira as exigências atuais de WSL do Clay. Se faltar instalação inicial do sistema, permissão administrativa ou reinicialização, explique o passo exato que preciso realizar e aguarde. Não contorne bloqueios de segurança.

2. PREPARE O PLUGIN
Confira o que já está instalado. Instale e configure o plugin oficial com os comandos suportados e as permissões disponíveis. Evite reinstalar o que já funciona. Se uma ação precisar ser feita no próprio cliente Claude Code ou exigir reinício da sessão, mostre o comando ou ação exata e como retomar. Não finja executar um comando interno que não está disponível às suas ferramentas. Mantenha as permissões normais do ambiente; não as desative para concluir a tarefa.

3. PARE PARA EU AUTENTICAR
Se eu não tiver conta ou sessão no Clay, apresente o endereço oficial necessário e diga o que preciso fazer. Se puder abrir o navegador com uma ferramenta autorizada, abra apenas a página de cadastro ou autenticação correspondente. Caso contrário, apresente o link.
Eu faço cadastro, login, aceite de termos e autorização. Não peça minha senha, código de autenticação, token ou chave no chat. Não crie uma conta em meu nome nem escolha uma assinatura paga. Espere minha confirmação, depois verifique pela ferramenta se a sessão realmente está pronta e qual workspace está conectado. Não considere minha mensagem como prova técnica do acesso.

4. PERGUNTE MINHAS PREFERÊNCIAS
Use AskUserQuestion, se a ferramenta estiver disponível, para apresentar escolhas claras. Se não estiver, faça perguntas numeradas no chat. Não crie nem prometa uma janela que este ambiente não oferece.
Pergunte em pequenos grupos:
- O que vendo e que tipo de empresa quero encontrar?
- Em qual região?
- Que informação observável precisa existir no site oficial?
- O que exclui uma empresa da lista?
- Quantas empresas quero no primeiro lote e onde salvar o arquivo?
Ofereça exemplos de critérios, como página de lojas, atendimento a empresas ou informação de entrega. Permita uma resposta diferente dos exemplos. Se eu não souber um termo, explique antes de pedir uma decisão. Não comece uma busca com escolhas importantes em aberto.

5. CONFIRA ACESSO E CONSUMO
Consulte os filtros e recursos realmente disponíveis. Explique o recorte, a quantidade e qualquer condição de consumo conhecida. Não prometa preço ou cobertura. Não contrate planos, compre créditos ou troque a assinatura.
Se a operação consumir créditos ou ações, mostre o que conseguiu verificar e peça minha decisão antes de iniciar. Se não conseguir calcular o consumo antecipadamente, declare essa limitação e aguarde uma decisão explícita. Permissões do ambiente continuam valendo.

6. PESQUISE E CONFIRA AS FONTES
Execute primeiro um lote pequeno conforme o recorte aprovado. Não invente empresas, sites, citações ou URLs para completar a quantidade. Para cada linha, reúna nome, site, região, critério, trecho de evidência, URL da fonte, data de consulta, estado e pendência.
Leia as fontes com as ferramentas disponíveis, sem me enviar para operar o painel do fornecedor. Separe evidência localizada, informação insuficiente e evidência de que a empresa está fora do recorte. Mostre os trechos para que eu possa revisar pela conversa. Se uma fonte não puder ser lida, mantenha a pendência explícita. Não marque como revisão humana aquilo que só você conferiu.
Não procure dados pessoais, não envie mensagens, não inicie contatos e não configure campanhas ou automações.

7. ENTREGUE E EXPLIQUE
Apresente a lista e os motivos da classificação. Peça minha revisão e mantenha separadas as dúvidas. Exporte um CSV local em UTF-8 com as colunas e fontes, sem duplicatas pelo domínio. Se o ambiente não puder criar arquivo, entregue o conteúdo e explique como salvar.
Não prometa criar tabelas no Clay se essa escrita não existir na CLI. Se qualquer etapa depender de um recurso exclusivo de painel e não houver alternativa documentada, pare e explique o limite, sem apresentar como concluído.
Mostre o caminho do arquivo, a quantidade real de linhas e o que ficou pendente. Registre um resumo em Markdown na pasta desta atividade, sem credenciais, para que eu consiga continuar em outra sessão.

Comece agora pela conferência do ambiente. Ao final de cada etapa, diga brevemente: o que foi feito, qual evidência confirmou e qual é o próximo passo. Pare quando precisar de uma ação minha ou de uma decisão ainda não tomada.
Ainda não tem o Claude Code?

Comece pela instalação e pelo login do próprio Claude. Depois cole o prompt. Abrir início oficial ↗

Este botão copia instruções. Não abre uma sessão, instala software ou conecta sua conta por esta página.

02

VOCÊ RESPONDE. ELE CONTINUA.

O processo acontece
dentro da conversa.

Depois de colar o pedido, acompanhe as etapas no Claude Code. Quando ele pedir cadastro ou login, conclua no endereço oficial indicado e volte para a conversa. Ele deve verificar se o acesso funcionou antes de continuar.

  1. 01
    Conferir o ambiente

    O que já existe, o que falta e quais permissões estão disponíveis.

  2. 02
    Preparar e autenticar

    Plugin e conexão pelo caminho oficial. Sua participação quando houver cadastro, login ou autorização.

  3. 03
    Escolher o recorte

    Setor, região, critério e tamanho do primeiro lote. Perguntas com opções, se o cliente oferecer esse recurso, ou perguntas no chat.

  4. 04
    Pesquisar e entregar

    Fontes, dúvidas, revisão e arquivo local. Sem campanha, contato ou envio de mensagens.

Exemplo ilustrativo. A janela real depende das ferramentas disponíveis no Claude Code ou no Codex.

Prompt para Claude Code. Também pode ser usado no Codex, conforme as ferramentas disponíveis.

PARA RETOMAR DEPOIS DO LOGIN
Concluí o cadastro ou login solicitado. Confira pela ferramenta se a sessão está autenticada e qual workspace está conectado. Se estiver tudo certo, retome a etapa em que paramos. Não considere minha mensagem como prova técnica do acesso e não repita o que já foi configurado.
Uma etapa pode exigir sua participação.

Permissão administrativa, reinício do ambiente ou uma função sem suporte na CLI não desaparecem com o prompt. O Claude deve explicar o limite e parar, em vez de declarar uma conclusão que não aconteceu.

07

DÚVIDAS DE QUEM VAI COMEÇAR

O que vale saber
antes de tentar.

Preciso saber programar? +

Os pedidos podem ser escritos em linguagem comum. A preparação envolve um ambiente técnico, instalação e autorização de conta. Se essa parte for nova para você, siga a documentação com apoio técnico. Entender o critério e revisar a saída continua sendo sua parte.

Isso é uma conexão MCP com o Clay? +

Este caminho usa o plugin e a CLI do Clay. A documentação trata MCP como uma conexão separada. Não use o nome de uma conexão para prometer as ferramentas da outra. [1]

Posso experimentar sem conectar uma conta? +

Sim, nesta página. Você pode editar e copiar o pedido e explorar as quatro fichas inventadas. Uma pesquisa real exige ferramentas instaladas, acesso e condições da conta.

Por que não pedir centenas de empresas de uma vez? +

Um lote pequeno ajuda a descobrir se o critério é claro e se as fontes sustentam a seleção. Corrija o pedido antes de ampliar uma busca ruim. Quantidade não substitui conferência.

O prompt envia mensagens para essas empresas? +

Não. Os pedidos deste guia delimitam pesquisa, revisão e arquivo local. Não pedem contato, envio, importação em outro sistema ou automação.

08

ORIGEM, DATA E PRÓXIMO PASSO

Você pode conferir
de onde veio o processo.

  1. [1]
    Clay: instalação do plugin, API e CLI ↗

    Requisitos, ambiente, acesso e limites documentados. Consultado em 23/10/2026.

  2. [2]
    Clay: aplicações do plugin ↗

    Referência para trabalhar com pesquisa e critérios. Consultado em 23/10/2026.

  3. [3]
    Claude Code: instalação e primeira sessão ↗

    Referência para começar no próprio Claude Code. Consultado em 23/10/2026.

  4. [4]
    Claude Code: ferramentas e perguntas com opções ↗

    A ferramenta AskUserQuestion e sua disponibilidade devem ser conferidas no ambiente em uso. Consultado em 23/10/2026.

Os passos de definição do pedido e revisão da lista são a proposta editorial IA by DNACX. A documentação sustenta as capacidades da ferramenta; não comprova um teste de conta desta sessão. Empresas, telas e trechos da bancada são ilustrações.

Você avança quando estiver pronto.

EXEMPLO ILUSTRATIVO / NÃO É UMA IA AO VIVO

Que sinal você quer encontrar no site?

Escolha um critério que possa ser conferido.

No Claude Code, o recurso de perguntas depende do cliente e das ferramentas disponíveis.