Proxies | Firecrawl

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
AU	Austrália	Sim	Não
BR	Brasil	Sim	Não
CA	Canadá	Sim	Não
CN	China	Sim	Não
DE	Alemanha	Sim	Não
DK	Dinamarca	Sim	Não
EE	Estônia	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
NL	Países Baixos	Sim	Sim
PT	Portugal	Sim	Não
QA	Catar	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

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.

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.

​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