brightdata/bright-data-best-practices

O que bright-data-best-practices faz?

Crie integrações prontas para produção com o Bright Data, incorporando as melhores práticas. Documentação de referência para desenvolvedores que utilizam assistentes de codificação (Claude Code, Cursor, etc.) para implementar web scraping, pesquisa, automação de navegador e extração estruturada de dados. Abrange Web Unlocker API, SERP API, Web Scraper API e Browser API (Scraping Browser).

Visão Geral

Este skill fornece um guia abrangente sobre as melhores práticas para usar o Bright Data em projetos de scraping e automação web. Ele se concentra em:

• Configuração e autenticação segura das APIs
• Uso eficiente de proxies e rotação de IPs
• Estratégias para contornar bloqueios (CAPTCHAs, rate limiting)
• Boas práticas para extração de dados estruturados
• Integração com assistentes de IA para geração de código

APIs Cobertas

Web Unlocker API

Automatiza a resolução de desafios de bloqueio (geolocalização, CAPTCHAs, fingerprinting) para acessar conteúdo restrito.

Exemplo de uso:

import requests

response = requests.get(
    'https://api.brightdata.com/webunlocker/request',
    headers={'Authorization': 'Bearer SEU_TOKEN'},
    params={'url': 'https://site-alvo.com/pagina-protegida'}
)
print(response.text)

SERP API

Extrai dados de mecanismos de busca (Google, Bing, etc.) como resultados orgânicos, anúncios e snippets.

Exemplo de uso:

from brightdata import SerpApi

api = SerpApi(api_key='SEU_TOKEN')
results = api.search(
    query='inteligência artificial 2025',
    engine='google',
    country='BR'
)
print(results['organic_results'])

Web Scraper API

Realiza scraping estruturado de páginas web inteiras, extraindo dados em formato JSON ou CSV.

Exemplo de uso:

curl -X POST https://api.brightdata.com/webscraper/scrape \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://exemplo.com/produtos",
    "output": "json",
    "fields": ["nome", "preco", "descricao"]
  }'

Browser API (Scraping Browser)

Automatiza ações em navegador headless para interações JavaScript e renderização dinâmica.

Exemplo de uso:

const { ScrapingBrowser } = require('brightdata');

const browser = new ScrapingBrowser({ apiKey: 'SEU_TOKEN' });
const page = await browser.newPage();
await page.goto('https://site-dinamico.com');
const content = await page.content();
console.log(content);

Melhores Práticas

1. Gerenciamento de Tokens: Armazene tokens de API em variáveis de ambiente (.env), nunca no código-fonte.
2. Tratamento de Erros: Implemente retry com backoff exponencial para lidar com timeouts e rate limits.
3. Caching: Utilize cache em nível de aplicação para reduzir requisições repetidas.
4. Conformidade: Respeite os termos de serviço dos sites alvo e implemente atrasos entre requisições.
5. Logging: Habilite logging detalhado para depuração e monitoramento.

Configuração Rápida

# Instale o SDK oficial
npm install brightdata   # Node.js
pip install brightdata  # Python

# Configure a chave de API
export BRIGHTDATA_API_KEY="sua-chave-aqui"

Links Úteis

• Documentação Oficial do Bright Data
• Console de Gerenciamento
• Guia de Integração com Assistentes de IA

---

Nota: Este skill foi projetado para ser usado como referência rápida por assistentes de codificação. As melhores práticas listadas aqui são baseadas em casos reais de uso corporativo.