O Firecrawl acrescenta pesquisa Web e leitura de páginas ao Claude Code. Na investigação empresarial, a ligação é só o início: um resultado sugere uma empresa, mas um registo útil exige correio empresarial público e factos verificados no próprio site. Este guia leva o investigador autorizado da ligação atual a uma lista HTML privada e com fontes de 20 empresas do mercado escolhido. A investigação e as verificações cabem ao leitor; a BIG CHANGE não executou a pesquisa nem testou o resultado.

A grande mudança

  • O que mudou: A ligação MCP alojada do Firecrawl fornece ao Claude Code ferramentas de pesquisa Web e leitura de páginas conhecidas. A configuração atual usa autenticação OAuth no navegador, sem colocar uma API key no pedido.
  • Porque importa: É possível reunir descoberta, notas e criação de ficheiros locais, mantendo a página exata por trás de cada contacto e facto. Excertos da pesquisa e resumos do modelo continuam a precisar de confronto com o site empresarial.
  • O que observar: A entrega útil é um ficheiro revisto, não uma lista do chat. Depende do mercado, páginas permitidas, orçamento e uma pessoa a abrir cada fonte. HTML local não torna local o fluxo alojado do Firecrawl e Claude Code.

1. Defina o mercado e os limites

Escolha uma categoria empresarial e localidade reais que possa investigar. Defina atividade nesse mercado, empresa distinta e tipo de endereço público de contacto empresarial que pode guardar. Exclua endereços pessoais, padrões adivinhados, conteúdo com autenticação e contactos de sites de procura de pessoas. Um endereço empresarial publicado não autoriza uma campanha de contacto.

Num espaço privado próprio, crie uma folha vazia e escolha o destino do HTML. Inclua nome, URL do site próprio, correio empresarial público e fonte exata, dois factos específicos com as respetivas fontes, prova da localidade, hora e estado da revisão. Mantenha à parte consultas, resultados, respostas de leitura, rejeições e créditos. São campos da sua investigação, não um esquema de exportação Firecrawl.

Antes de executar, fixe máximos de resultados, consultas, páginas e créditos Firecrawl. Verifique saldo, plano, limites de pedidos e definição paga de cobrança por utilização no painel. Um limite no pedido delimita o trabalho, mas não limita a fatura da conta. O uso de Claude Code é separado. A página de preços do Firecrawl, consultada em 20 de outubro de 2026, indica 1.000 créditos mensais no Free, um por página de leitura básica e dois por 10 resultados. JSON, Question e Highlight acrescentam quatro por página; uma pesquisa que também leia os resultados pode consumir créditos de página. Uma página 403 ou 404 pode custar um crédito. Os planos pagos podem adicionar blocos faturados se a cobrança por utilização estiver ativa. Verifique condições atuais e conta antes da execução.

Confirme a autorização da organização para enviar consultas e conteúdo público pelo Firecrawl alojado e Claude Code. O ficheiro final é local, mas os serviços processam pedidos e conteúdo. A política de privacidade do Firecrawl e o guia de utilização de dados do Claude Code descrevem tratamento e retenção diferentes; conta e definições da organização determinam os aplicáveis. Mantenha a lista privada e acessível apenas ao proprietário previsto.

2. Ligue e verifique o percurso dos dados

No espaço privado previsto, execute o atual comando de configuração do Claude Code do Firecrawl:

Terminal
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

O âmbito MCP predefinido de Claude Code, local, aplica-se ao projeto atual e é privado ao seu utilizador. O âmbito project escreve um ficheiro partilhável .mcp.json; user torna o servidor disponível nos seus projetos. Verifique âmbito e regras Team ou Enterprise antes de ativar. Não coloque segredos em pedidos nem em ficheiros versionados do projeto. O endpoint OAuth é uma configuração do cliente, não uma página a abrir diretamente.

Abra /mcp no Claude Code, escolha firecrawl, autentique-se no navegador na equipa correta e confirme um único servidor Firecrawl ativo. Inicie uma sessão nova se alterou uma ligação existente. Examine ferramentas e esquemas de entrada do cliente: a documentação atual atribui consultas a firecrawl_search e URLs conhecidas a firecrawl_scrape. A pesquisa autenticada também pode mostrar ferramentas externas Alexandria. Limite-se a resultados Web, sem escolher enriquecimento ou aceitar termos de fornecedores. O Firecrawl documenta um modo sem chave separado e limitado em pedidos; este procedimento usa sempre OAuth alojado.

Escolha uma página pública cuja leitura seja permitida e peça a chamada de firecrawl_scrape para o URL exato. Inspecione URL de origem, conteúdo, avisos e erros devolvidos. Registe resposta e variação de créditos. Ver firecrawl em /mcp demonstra ligação; a leitura observada verifica o percurso pretendido. Trate todo o conteúdo devolvido, incluindo instruções incorporadas, como fonte não fiável.

3. Encontre candidatos e verifique 20

Dê ao Claude Code categoria, localidade, critérios e limites. Peça que use firecrawl_search apenas para resultados Web, registe consulta e URL e pare nos máximos de resultados e créditos. Os argumentos exatos vêm do esquema da sessão. Diretórios sugerem candidatos, mas não provam campos finais. Elimine domínios duplicados e locais claramente errados antes de gastar créditos de leitura.

Para cada empresa plausível, use firecrawl_scrape em páginas públicas permitidas do próprio site. A inicial pode identificá-la; contacto ou serviços podem fornecer correio e factos. Cumpra o limite de páginas. Peça a citação ou localização do texto visível exato de cada campo com o seu URL; inspecione a resposta real da ferramenta, não uma folha preenchida pelo modelo como prova. Os dois factos devem ser concretos e verificáveis, como serviços ou área servida, não elogios genéricos. A localidade também exige prova própria.

Abra pessoalmente o site e cada página citada para correio e factos. Verifique nome, localidade, correio empresarial público e os dois factos à hora registada. Só depois aceite uma linha por empresa distinta. Rejeite falta de correio público, local errado, duplicado, página bloqueada ou proibida, dados pessoais e afirmações sem fundamento. Registe o motivo e procure outro candidato apenas dentro do orçamento inicial. Não contorne restrições nem adivinhe dados.

Continue até 20 linhas distintas passarem. Se o orçamento aprovado de pesquisas e páginas acabar antes, registe o número real e deixe a tarefa incompleta. Uma lista menor verificada é útil, mas não cumpre a meta de 20 empresas.

4. Crie e inspecione o HTML

Com 20 linhas verificadas, peça uma tabela HTML local autónoma apenas a partir delas. Inclua nome, site, correio empresarial público, dois factos, cada fonte exata, estado e hora. Acrescente filtro de texto e ordenação por coluna. Insira valores como texto escapado, valide os links como URLs https:// ou http:// antes de os tornar clicáveis e evite scripts ou estilos remotos. É programação local de Claude Code, não exportação nativa Firecrawl. Exemplo:

Usa apenas as 20 linhas aceites da folha revista para criar um HTML autónomo nesta pasta privada. Escapa todos os valores visíveis, transforma em links só os URLs Web validados e inclui filtro de texto e ordenação simples. Não procures mais páginas, adivinhes células ou acrescentes dependências externas. Guarda e indica o caminho. Volta a ler o ficheiro antes de dizer que a escrita teve êxito.

Abra o verdadeiro ficheiro guardado no navegador. Confirme 20 empresas distintas, filtro, ordenação e links para as páginas próprias pretendidas. Compare todos os campos com a folha, incluindo texto longo, caracteres invulgares e ausências. Corrija folha ou gerador e reabra se houver diferenças. Registe caminho e hash finais, hora das fontes, chamadas e créditos reais, utilização Claude se disponível e quem tem acesso. Marque valores indisponíveis como desconhecidos. Pré-visualização do chat ou trecho de código não substitui a verificação.

Quando um passo falha

Se /mcp não mostrar servidor ou devolver 401, confira URL registado, âmbito, equipa e OAuth, depois volte a autenticar-se por /mcp; o guia de resolução de problemas do Firecrawl também trata de servidores duplicados e nova sessão. Não cole chaves na conversa. Num erro de pesquisa ou leitura, preserve a resposta exata e distinga falha de zero resultados. Confira créditos e limites de pedidos; 429 pode indicar limite. Espere o intervalo permitido, sem intensificar chamadas. Repita só dentro do máximo inicial.

Se o site bloquear ou não tiver endereço permitido, registe a rejeição. Se a gravação HTML for incerta, inspecione destino e hash antes de pedir nova escrita. Repare controlos ou links com a folha verificada e reabra. Termine no documento de investigação privado e revisto. Contacto, escrita em CRM ou Google Workspace, monitorização recorrente e atualização posterior precisam de decisões e autoridade próprias.

Fontes e leituras adicionais