> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-27eiio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<div id="tool-availability">
  ## Disponibilidade de ferramentas
</div>

| 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](/pt-BR/mcp-server) 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.

<div id="choose-a-tool">
  ## Escolha uma ferramenta
</div>

| 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.                                                               |

<Note>
  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](/pt-BR/developer-guides/usage-guides/choosing-the-data-extractor) para ver a comparação completa.
</Note>

<Tip>
  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.
</Tip>

<div id="important-behavior">
  ## Comportamento importante
</div>

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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`.
  </Accordion>
</AccordionGroup>

<div id="feature-guides">
  ## Guias de recursos
</div>

<CardGroup cols={3}>
  <Card title="Scrape" href="/pt-BR/features/scrape" icon="file-lines">
    Extraia conteúdo ou campos estruturados de uma URL.
  </Card>

  <Card title="Busca" href="/pt-BR/features/search" icon="magnifying-glass">
    Encontre fontes relevantes na web, em notícias, imagens e para desenvolvedores.
  </Card>

  <Card title="Rastreamento" href="/pt-BR/features/crawl" icon="spider-web">
    Percorra e extraia dados de um site ou seção.
  </Card>

  <Card title="Parse" href="/pt-BR/features/parse" icon="file-import">
    Converta arquivos em resultados prontos para LLMs.
  </Card>

  <Card title="Interact" href="/pt-BR/features/interact" icon="arrow-pointer">
    Interaja com páginas dinâmicas em uma sessão ativa do navegador.
  </Card>

  <Card title="Agent" href="/pt-BR/features/agent" icon="sparkles">
    Execute pesquisas autônomas em várias fontes.
  </Card>

  <Card title="Monitoring" href="/pt-BR/features/monitoring" icon="bell">
    Acompanhe mudanças nas páginas e receba notificações.
  </Card>
</CardGroup>

<div id="troubleshooting">
  ## Solução de problemas
</div>

* **Uma ferramenta está ausente:** confirme o modo de conexão na [configuração do MCP](/pt-BR/mcp-server), 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](/pt-BR/rate-limits) atuais, aguarde o intervalo para nova tentativa ou mude do acesso sem chave para o acesso autenticado.