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 pelo Agent MCP ou pelo Human MCP para escolher o acesso via OAuth, chave de API ou sem chave. Algumas ferramentas opcionais podem ser desativadas pelo ambiente ou pelas políticas da equipe.

​
Escolha uma ferramenta

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

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 e firecrawl_agent retornam IDs de job. Use firecrawl_check_crawl_status ou firecrawl_agent_status até que o job 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.
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 no Agent MCP ou Human MCP, reconecte ou reinicie o cliente e verifique se a política da equipe desativa ferramentas opcionais.
  • O cliente retorna 401: repita o login via OAuth ou verifique se a variável de ambiente configurada para o token Bearer contém uma chave de API do Firecrawl válida.
  • 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.