Firecrawl MCP: primeiro ligue a entrada hospedada sem chave para buscar e extrair

Para quem

Quem precisa que um agente compatível com MCP busque, extraia e interaja com a web ao vivo e obtenha contexto limpo usável por modelo. Serve a operadores que conseguem primeiro ligar a entrada hospedada oficial, aceitam que o patamar gratuito sem chave só abre scrape / search / parse com limite de taxa, e sabem que crawl, map e agent ainda pedem chave. Não serve a quem quer colocar a chave na URL do servidor ou na janela de chat, nem a quem entende «conectado» como crawl ilimitado do site inteiro. Repositório oficial: https://github.com/firecrawl/firecrawl-mcp-server

Primeira tentativa em 3 minutos

Só um caminho oficial: primeiro ligue o patamar gratuito hospedado sem chave. Não instale primeiro npx local nem configure primeiro uma chave.

Pré-requisito: o cliente consegue adicionar um MCP remoto. No patamar sem chave scrape, search e parse funcionam com limite de taxa; crawl, map e agent ainda precisam de chave.

Local de instalação e configuração: no cliente, escreva o endereço do servidor como a entrada hospedada, sem nenhum parâmetro de consulta de chave:

https://mcp.firecrawl.dev/v2/mcp

Ação de baixo risco: após conectar com sucesso você deve ver só 3 ferramentas: firecrawl_scrape, firecrawl_search, firecrawl_parse. Chame primeiro firecrawl_search, com um tema que você já tenha; não invente um endereço de site que não aparece na evidência. Se precisar verificar a extração, só extraia um endereço já na evidência, como a página do repositório oficial https://github.com/firecrawl/firecrawl-mcp-server . Não chame na primeira tentativa crawl / map / agent, que precisam de chave.

Sinal de sucesso: o cliente lista essas 3 ferramentas, search ou scrape devolve resultado estruturado, ou uma nota clara de limite de taxa, não um pedido para enfiar chave na URL. Se a autenticação falhar, verifique primeiro se você colou uma chave no endereço.

Casos de uso

Caso 1: busca ou extração de uma página sem chave. Corresponde à fonte «search, scrape, and interact with the live web» e à entrada hospedada que só expõe firecrawl_search / firecrawl_scrape / firecrawl_parse. Use search para um lote de resumos, ou scrape para recolher uma URL única em dados estruturados limpos. A evidência diz que o patamar sem chave tem limite de taxa e não escreve a sintaxe de search nem todos os parâmetros de scrape; só se confirma a camada «contexto limpo ou erro de limite».

Caso 2: capacidade mais profunda com chave. Uma configuração padrão completa registra 25 ferramentas (incluindo de feedback); a fonte nomeia crawl, map, agent e «Deep research with autonomous agent» e «Interact with pages — click, navigate, and operate». Elas visitam a web ao vivo; clique e navegação têm efeitos colaterais. Para esse caminho, configure Authorization: Bearer <FIRECRAWL_API_KEY> no cabeçalho de segurança ou nas definições de chave do cliente; nunca coloque a chave na URL do servidor ou na conversa. A evidência não dá a tabela de parâmetros dessas 25 ferramentas nem um comando local npx sem placeholder; não invente uma string de instalação local.

Limites de uso

A entrada hospedada sem chave abre só 3 ferramentas, e scrape / search / parse têm limite de taxa. As 25 ferramentas do patamar completo, mais crawl / map / agent, ficam fora desta fronteira gratuita.

A fonte também tem uma entrada só de busca https://mcp.firecrawl.dev/v2/mcp-search O extrato é cortado em «exposes a fixed 6», então não se pode afirmar os nomes dessas 6 ferramentas.

Nunca coloque uma chave de API na URL do servidor ou na conversa do agente; só na gestão de chaves do cliente. readOnlyHint também não é risco zero: search e scrape visitam a web ao vivo e consomem cota hospedada.

A evidência não dá uma lista fixa de clientes. O exemplo local npx no extrato traz uma chave placeholder e não é um comando oficial copiável. Para auto-hospedagem ou SSE, a fonte só lista nomes de capacidades, sem configuração passo a passo; não complete o que falta.