A Firecrawl oferece diferentes tipos de proxy para ajudar você a fazer scraping de sites com diversos níveis de proteção anti-bot. O tipo de proxy pode ser especificado usando o parâmetro proxy.
Por padrão, a Firecrawl roteia todas as requisições por meio de proxies para garantir confiabilidade e acesso, mesmo que você não especifique um tipo de proxy ou localização.

Seleção de proxy por localização

O Firecrawl seleciona automaticamente o melhor proxy com base na sua localização especificada ou detectada. Isso ajuda a otimizar o desempenho e a confiabilidade da extração. No entanto, nem todas as localizações são atualmente compatíveis. As seguintes localizações estão disponíveis:
Código do paísNome do paísSuporte a modo stealth
AEUnited Arab EmiratesNo
AUAustraliaYes
BRBrazilYes
CACanadaNo
CNChinaNo
CZCzechiaNo
DEGermanyYes
FRFranceYes
GBUnited KingdomNo
ILIsraelNo
INIndiaNo
ITItalyNo
JPJapanNo
PLPolandNo
PTPortugalNo
QAQatarNo
TRTurkeyNo
USUnited StatesYes
VNVietnamNo
A lista de localizações de proxy compatíveis foi atualizada pela última vez em 12 de set. de 2025. A disponibilidade pode mudar ao longo do tempo.
Se você precisar de proxies em uma localização não listada acima, entre em contato conosco e informe suas necessidades. Se você não especificar um proxy ou localização, o Firecrawl selecionará automaticamente a melhor opção com base no site de destino e na sua solicitação.

Como especificar a localização do proxy

Você pode solicitar uma localização específica de proxy definindo o parâmetro location.country na sua requisição. Por exemplo, para usar um proxy no Brasil, defina location.country como BR. Para ver todos os detalhes, consulte a referência da API de location.country.
from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

doc = firecrawl.scrape('https://example.com',
    formats=['markdown'],
    location={
        'country': 'US',
        'languages': ['en']
    }
)

print(doc)
Se você solicitar um país onde não há proxy disponível, o Firecrawl usará a região disponível mais próxima (UE ou EUA) e definirá a localização do navegador para o país solicitado.

Tipos de proxy

Firecrawl oferece suporte a três tipos de proxies:
  • basic: Proxies para scraping de sites com nenhuma ou com soluções anti-bot básicas. Rápidos e geralmente funcionam.
  • stealth: Proxies stealth para scraping de sites com soluções anti-bot avançadas ou para sites que bloqueiam proxies comuns. Mais lentos, mas mais confiáveis em certos sites. Saiba mais sobre o Modo Stealth →
  • auto: O Firecrawl tentará automaticamente fazer o scraping novamente com proxies stealth se o proxy básico falhar. Se a nova tentativa com stealth for bem-sucedida, 5 créditos serão cobrados pelo scrape. Se a primeira tentativa com basic for bem-sucedida, apenas o custo regular será cobrado.

Nota: Para informações detalhadas sobre o uso de proxies stealth, incluindo custos de crédito e estratégias de nova tentativa, consulte a documentação do Modo Stealth.