Ferramentas do Firecrawl MCP

Escolha uma ferramenta do Firecrawl MCP e entenda sua disponibilidade e funcionamento.

O Firecrawl MCP disponibiliza ferramentas para encontrar, extrair, interagir com e monitorar conteúdo da web. Ao se conectar, seu cliente MCP recebe o esquema de entrada exato de cada ferramenta disponível.

​

Disponibilidade de ferramentas

Modo de conexão	Ferramentas disponíveis
OAuth hospedado	Conjunto completo de ferramentas, sujeito ao plano e às políticas da equipe
Chave de API hospedada	Conjunto completo de ferramentas, sujeito ao plano e às políticas da equipe
Hospedado sem chave	firecrawl_search, firecrawl_scrape e firecrawl_parse
Local com a API em nuvem do Firecrawl	Ferramentas baseadas em API; o Parse direto de arquivos locais não está disponível
Local com uma API do Firecrawl auto-hospedada	Ferramentas compatíveis com os serviços habilitados nessa implantação

Comece pela configuração do MCP para escolher o acesso sem chave, via OAuth ou por chave de API. Algumas ferramentas opcionais podem ser desativadas pelo ambiente ou pelas políticas da equipe.

​

Escolha uma ferramenta

Tarefa	Ferramenta	Use quando
Ler uma página	firecrawl_scrape	Você conhece a URL e precisa do conteúdo da página ou de campos estruturados.
Extrair dados estruturados de uma URL conhecida	firecrawl_scrape com formato JSON	Você sabe qual página contém os dados e quer um resultado que siga um prompt ou esquema.
Encontrar e extrair dados quando as fontes são desconhecidas	firecrawl_agent e firecrawl_agent_status	A tarefa exige a descoberta em uma ou mais fontes antes de produzir resultados estruturados.
Descobrir URLs de um site	firecrawl_map	Você precisa encontrar páginas antes de decidir o que extrair.
Fazer uma busca na web	firecrawl_search	Você tem uma consulta, não uma URL conhecida.
Analisar um arquivo	firecrawl_parse	Você precisa de conteúdo de um PDF, documento, planilha ou arquivo HTML.
Extrair várias páginas	firecrawl_crawl e firecrawl_check_crawl_status	Você precisa percorrer um site ou uma seção. A ferramenta de rastreamento consulta o job até ele atingir um estado final antes de retornar.
Realizar pesquisa autônoma	firecrawl_agent e firecrawl_agent_status	A tarefa abrange várias fontes, e as páginas exatas são desconhecidas.
Interagir com uma página ativa	firecrawl_interact e firecrawl_interact_stop	Você precisa clicar, preencher formulários, navegar ou extrair dados de páginas dinâmicas.
Pesquisar papers e repositórios	firecrawl_research_*	Você precisa descobrir ou ler papers, encontrar trabalhos relacionados ou buscar repositórios públicos.
Responder a uma pergunta de programação	firecrawl_developer_search	Você precisa de respostas de fontes primárias, como issues, pull requests mesclados, READMEs e documentação selecionada.
Monitorar mudanças	firecrawl_monitor_*	Você precisa de verificações recorrentes, diffs e notificações por webhook ou email.
Enviar feedback sobre o produto	firecrawl_search_feedback e firecrawl_feedback	Você quer avaliar resultados de busca ou informar a qualidade de um endpoint.

A antiga ferramenta Extract do MCP está descontinuada e não faz parte do conjunto de ferramentas atual. Use Scrape com formato JSON para uma página conhecida ou Agent quando o Firecrawl precisar descobrir as fontes. Consulte Escolhendo o Extrator de Dados para ver a comparação completa.

Use o esquema exibido pelo seu cliente MCP para os argumentos atuais. Os guias de recursos abaixo explicam o comportamento do Firecrawl sem duplicar esses esquemas aqui.

​

Comportamento importante

Analisar um arquivo local

Um servidor MCP local conectado a uma API do Firecrawl auto-hospedada pode ler filePath diretamente. O servidor hospedado não pode ler arquivos da sua máquina, por isso usa uma transferência em duas chamadas:

1. Chame firecrawl_parse com filePath para receber um comando de upload e uploadRef.
2. Execute o comando de upload na máquina que pode ler o arquivo.
3. Chame firecrawl_parse novamente com o uploadRef retornado.

O comando de upload usa um destino assinado de curta duração e não contém sua chave de API do Firecrawl. Use firecrawl_scrape para um URL de documento público.

Verificar um rastreamento em execução

firecrawl_crawl normalmente inicia um rastreamento e o consulta até atingir um estado terminal antes de retornar. Se essa espera atingir o tempo limite, retome o job com firecrawl_check_crawl_status e o ID do rastreamento. Use a mesma ferramenta de status para um rastreamento criado fora da chamada MCP atual.

firecrawl_agent é assíncrono: retorna um ID de job, e firecrawl_agent_status verifica esse job até que seja concluído ou falhe.

Encerrar sessões de interação

Comece com uma url ou reutilize o scrapeId de uma chamada de Scrape anterior. Quando o fluxo de trabalho for concluído, chame firecrawl_interact_stop com o scrapeId para liberar a sessão.

Gerenciar monitores com segurança

A família firecrawl_monitor_* cria, lista, atualiza, executa e inspeciona monitores recorrentes. firecrawl_monitor_delete remove permanentemente um monitor e só deve ser chamado quando o usuário expressamente quiser excluí-lo.

Habilitar ferramentas opcionais de feedback

Defina FIRECRAWL_NO_SEARCH_FEEDBACK=1 para impedir o registro de firecrawl_search_feedback. Defina FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 para impedir o registro de firecrawl_feedback.

​

Guias de recursos

Scrape

Extraia conteúdo ou campos estruturados de uma URL.

Busca

Encontre fontes relevantes na web, em notícias, imagens e para desenvolvedores.

Rastreamento

Percorra e extraia dados de um site ou seção.

Parse

Converta arquivos em resultados prontos para LLMs.

Interact

Interaja com páginas dinâmicas em uma sessão ativa do navegador.

Agent

Execute pesquisas autônomas em várias fontes.

Monitoring

Acompanhe mudanças nas páginas e receba notificações.

​

Solução de problemas

• Uma ferramenta está ausente: confirme o modo de conexão na configuração do MCP, reconecte ou reinicie o cliente e verifique se a política da equipe desativa ferramentas opcionais.
• O cliente retorna 401: primeiro, verifique a URL do servidor configurada.
  • Se a URL configurada for /v2/mcp-oauth, faça login novamente pelo cliente.
  • Se for /v2/mcp, substitua a chave de API nesse servidor ou atualize a URL do servidor existente para /v2/mcp-oauth e conclua o login.
  • Inicie uma nova sessão do cliente após qualquer uma das alterações.
• O cliente foi limitado por taxa: consulte os limites de taxa atuais, aguarde o intervalo para nova tentativa ou mude do acesso sem chave para o acesso autenticado.