Pular para o conteúdo principal
A Firecrawl oferece diferentes tipos de proxy para ajudar você a fazer scraping de sites com diversos níveis de complexidade. 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 localidades são atualmente compatíveis. As seguintes localidades estão disponíveis:
Country CodeNome do paísSuporte básico de proxySuporte avançado de proxy
AEEmirados Árabes UnidosSimNão
AUAustráliaSimSim
BRBrasilSimNão
CACanadáSimNão
CNChinaSimNão
CZTchéquiaSimNão
DEAlemanhaSimNão
EGEgitoSimNão
ESEspanhaSimNão
FRFrançaSimNão
GBReino UnidoSimNão
GRGréciaSimNão
HUHungriaSimNão
IDIndonésiaSimNão
ILIsraelSimNão
INÍndiaSimNão
ITItáliaSimNão
JPJapãoSimNão
MYMalásiaSimNão
NONoruegaSimNão
PLPolôniaSimNão
PTPortugalSimNão
QACatarSimNão
SGSingapuraSimNão
TRTurquiaSimNão
USEstados UnidosSimSim
VNVietnãSimNão
A lista de locais de proxy compatíveis mudará ao longo do tempo.
Se você precisar de proxies em uma localidade não listada acima, por favor entre em contato conosco e informe suas necessidades. Se você não especificar um proxy ou uma localidade, o Firecrawl usará automaticamente proxies dos EUA.

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 proxy:
  • basic: Proxies para scraping da maioria dos sites. Rápidos e geralmente funcionam.
  • enhanced: Proxies aprimorados para scraping de sites complexos mantendo a privacidade. Mais lentos, mas mais confiáveis em certos sites. Saiba mais sobre o Enhanced Mode →
  • auto: Firecrawl refará automaticamente o scraping usando proxies aprimorados se o proxy básico falhar. Se a nova tentativa com enhanced for bem-sucedida, 5 créditos serão cobrados pelo scraping. Se a primeira tentativa com basic for bem-sucedida, apenas o custo padrão será cobrado.

Observação: Para informações detalhadas sobre o uso de proxies aprimorados, incluindo custos de créditos e estratégias de repetição de tentativas, consulte a documentação do Enhanced Mode.