Proxies

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 Code	Nome do país	Suporte básico de proxy	Suporte avançado de proxy
AE	Emirados Árabes Unidos	Sim	Não
AT	Áustria	Sim	Não
AU	Austrália	Sim	Não
BE	Bélgica	Sim	Não
BR	Brasil	Sim	Não
CA	Canadá	Sim	Não
CH	Suíça	Sim	Não
CN	China	Sim	Não
DE	Alemanha	Sim	Não
DK	Dinamarca	Sim	Não
EG	Egito	Sim	Não
ES	Espanha	Sim	Não
FR	França	Sim	Não
GB	Reino Unido	Sim	Não
GR	Grécia	Sim	Não
IL	Israel	Sim	Não
IN	Índia	Sim	Não
IT	Itália	Sim	Não
JP	Japão	Sim	Não
MX	México	Sim	Não
NL	Países Baixos	Sim	Sim
PL	Polônia	Sim	Não
QA	Catar	Sim	Não
SE	Suécia	Sim	Não
TR	Turquia	Sim	Não
US	Estados Unidos	Sim	Sim

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 na Alemanha, defina location.country como DE. Para ver todos os detalhes, consulte a referência da API de location.country.

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # Nenhuma API key necessária para começar — adicione uma para limites de taxa maiores:
  # api_key="fc-YOUR-API-KEY",
)

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

print(doc)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({
  // Nenhuma API key necessária para começar — adicione uma para limites de taxa mais altos:
  // apiKey: "fc-YOUR-API-KEY",
});

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

console.log(doc.metadata);

# Não é necessária uma chave de API para começar — adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa maiores:
curl -X POST "https://api.firecrawl.dev/v2/scrape" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "formats": ["markdown"],
    "location": { "country": "US", "languages": ["en"] }
  }'

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.

Recomendamos fortemente deixar location sem especificar, a menos que você tenha certeza de que precisa disso.

Tipos de Proxy

O parâmetro proxy está descontinuado. Recomendamos auto — o padrão — que permite que o Firecrawl selecione o proxy para você.

basic: Proxies para scraping da maioria dos sites.
enhanced: Proxies aprimorados para scraping de sites complexos mantendo a privacidade. Saiba mais sobre o Enhanced Mode →
auto: Recomendado. Firecrawl refará automaticamente o scraping usando proxies aprimorados se o proxy básico falhar.

Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para obter instruções de onboarding automatizado.

Primeiros passos

Endpoints principais

Mais

Guias de início rápido

Guias para desenvolvedores

Webhooks

Casos de uso

Outros

Como contribuir

Seleção de proxy por localização

Como especificar a localização do proxy

Tipos de Proxy

​Seleção de proxy por localização

​Como especificar a localização do proxy

​Tipos de Proxy

Seleção de proxy por localização

Como especificar a localização do proxy

Tipos de Proxy