Ferramentas disponíveis
1. Ferramenta de Scraping (firecrawl_scrape)
redactPII nos argumentos da ferramenta de scraping.
2. Ferramenta Map (firecrawl_map)
Opções da ferramenta Map:
url: URL base do site a ser mapeadosearch: Termo de busca opcional para filtrar URLssitemap: Controla o uso do sitemap - “include”, “skip” ou “only”includeSubdomains: Indica se os subdomínios devem ser incluídos no mapeamentolimit: Número máximo de URLs a retornarignoreQueryParameters: Indica se os parâmetros de consulta devem ser ignorados durante o mapeamento
3. Ferramenta de Busca (firecrawl_search)
Opções da ferramenta de busca:
query: String da consulta de busca (obrigatória)limit: Número máximo de resultados a retornarlocation: Localização geográfica dos resultados de buscatbs: Filtro de busca por período (por exemplo,qdr:dpara o último dia,qdr:wpara a última semana,qdr:mpara o último mês)filter: Filtro de busca adicionalsources: Array de tipos de fonte a serem pesquisados (web,images,news)scrapeOptions: Opções de scraping das páginas de resultados de buscaenterprise: Array de opções empresariais (default,anon,zdr)
4. Ferramenta Parse (firecrawl_parse)
FIRECRAWL_API_URL, o servidor MCP pode ler filePath diretamente e envia os bytes do arquivo para /v2/parse.
Quando você usa o servidor MCP hospedado remoto, ele não pode ler arquivos da sua máquina. Nesse caso, firecrawl_parse usa uma transferência em duas etapas que também funciona na URL remota sem chave:
- Chame
firecrawl_parsecomfilePath. A ferramenta retorna um comando de upload pré-preenchido e umnextToolCallcontendo umuploadRef. - Execute o comando de upload na máquina que pode ler o arquivo e chame
firecrawl_parsenovamente com ouploadRefretornado.
Opções da ferramenta Parse:
filePath: Caminho local do arquivo que você deseja analisar. Use-o na primeira chamada.uploadRef: Referência retornada pela primeira chamada ao MCP hospedado. Use-a na segunda chamada após o upload ser concluído.formats: Formatos de resultado. O padrão émarkdown.parsers: Controles do analisador, como opções de análise de PDF.contentType: Substituição opcional do tipo MIME do arquivo.declaredSizeBytes: Indicação opcional do tamanho do arquivo. O tamanho máximo dos arquivos é 50 MB.
firecrawl_scrape; ele detectará e analisará documentos a partir de URLs.
5. Ferramenta de rastreamento (firecrawl_crawl)
6. Verificar o status do rastreamento (firecrawl_check_crawl_status)
7. Ferramenta Extract (firecrawl_extract)
Opções da ferramenta Extract:
urls: Array de URLs para extrair informaçõesprompt: Prompt personalizado para extração com LLMschema: Schema JSON para extração de dados estruturadosallowExternalLinks: Permitir extração de links externosenableWebSearch: Habilitar a busca na web para contexto adicionalincludeSubdomains: Incluir subdomínios na extração
8. Ferramenta de Agente (firecrawl_agent)
firecrawl_agent_status para verificar quando é concluído e recuperar os resultados.
Opções da ferramenta de agente:
prompt: Descrição em linguagem natural dos dados desejados (obrigatório, máximo de 10.000 caracteres)urls: Array opcional de URLs para direcionar o agente a páginas específicasschema: Schema JSON opcional para resultado estruturado
firecrawl_agent_status para consultar os resultados.
9. Verificar o status do agente (firecrawl_agent_status)
Opções de status do agente:
id: O ID do job do agente retornado porfirecrawl_agent(obrigatório)
processing: O agente ainda está pesquisando — continue consultandocompleted: Pesquisa concluída — a resposta inclui os dados extraídosfailed: Ocorreu um erro
10. Interaja com uma página (firecrawl_interact)
- Passe
urlpara abrir e interagir com uma nova página em uma única chamada MCP. - Passe o
scrapeIdde uma chamada anterior parafirecrawl_scrapepara reutilizar a página já carregada.
url e scrapeId ao mesmo tempo. Forneça prompt ou code. scrapeOptions só pode ser usado no modo url.
Exemplo do modo URL:
Opções da ferramenta Interact:
url: Página com a qual interagir; abre a sessão para você. Use esta ouscrapeId.scrapeId: ID do job de scraping de uma chamada anterior afirecrawl_scrape. Use este ouurl.prompt: Instrução em linguagem natural que descreve a ação a ser realizada. Forneçapromptoucode.code: Código a ser executado na sessão do navegador. Forneçacodeouprompt.language:bash,pythonounode(opcional; o padrão énode; usado apenas comcode).timeout: Tempo limite de execução em segundos, de 1 a 300 (opcional; o padrão é 30).scrapeOptions: Controles opcionais de scraping usados apenas no modourl.
11. Encerrar sessão de interação (firecrawl_interact_stop)
Opções para interromper o Interact:
scrapeId: O ID de scraping da sessão a ser interrompida (obrigatório)
Sistema de logs
- Status e progresso das operações
- Métricas de desempenho
- Monitoramento do uso de créditos
- Acompanhamento dos limites de taxa
- Condições de erro
Tratamento de erros
- Novas tentativas automáticas para erros transitórios
- Tratamento de limite de taxa com backoff
- Mensagens de erro detalhadas
- Avisos sobre o uso de créditos
- Resiliência de rede

