Skip to main content
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

Comece pelos Primeiros passos e escolha Para agentes ou Para humanos. Algumas ferramentas opcionais podem ser desativadas pelo ambiente ou pelas políticas da equipe.

​
Escolha uma ferramenta

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 schema exibido pelo seu cliente MCP para os argumentos atuais. Os guias de recursos abaixo explicam o comportamento do Firecrawl sem duplicar esses schemas aqui.

​
Comportamento importante

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.
firecrawl_crawl normalmente inicia um rastreamento e o consulta até atingir um estado final 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.
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.
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.
As ferramentas do Alexandria exigem uma sessão autenticada. Sessões sem chave não têm acesso às ferramentas do Alexandria.
  1. Descobrir. O firecrawl_search autenticado usa sources: ["web", "alexandria"] por padrão e retorna as ferramentas correspondentes em data.tools. Use sources: ["alexandria"] para obter apenas ferramentas ou sources: ["web"] para omitir a descoberta semântica de ferramentas.
  2. Inspecionar. Chame firecrawl_find_tools sem argumentos para navegar por categorias, depois por providers e, por fim, por ferramentas. Use query ou urls para encontrar ferramentas para uma tarefa ou um site. Use capabilities para ler o contrato completo de uma ferramenta. Siga o nextTool retornado para passar à próxima etapa.
  3. Executar. Chame firecrawl_scrape com alexandria: {provider, capability, options} em vez de url. Envie um array de até 10 chamadas para executá-las juntas. Cada resultado em data.alexandria contém data ou um error.
A descoberta é gratuita. Cada execução custa o preço indicado na respectiva ferramenta. Se um provider exigir a aceitação de termos, a ferramenta retorna THIRD_PARTY_DATA_TERMS_REQUIRED com requiresAction.url. Envie esse URL a um administrador da organização, que aceitará os termos no painel do Firecrawl. O agente não deve aceitar os termos. Depois que o administrador confirmar, envie a mesma chamada novamente.
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.

Research Index

Busque papers, leia trechos e siga citações.

Índice para desenvolvedores

Responda a perguntas de programação com base em issues, PRs, READMEs e documentação.

Rastreamento

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

Analisar

Converta arquivos em resultados prontos para LLMs.

Interagir

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.

Alexandria

Encontre e execute ferramentas de dados de providers terceiros.

​
Solução de problemas

  • Uma ferramenta está ausente: confirme o modo de conexão em Primeiros passos, 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.