olx-dealslisted
Install: claude install-skill Rafael-CN/olx-deals
# OLX Deals
CLI de coleta e triagem em massa da olx.com.br. Um comando varre o país, filtra
por etapas configuráveis e ranqueia achados contra o preço mediano do próprio
produto na OLX.
## Antes de qualquer coisa: os limites que mandam no desenho
Estes não são detalhes de implementação, são o que decide se uma coleta funciona.
Foram todos medidos contra o site, não deduzidos.
1. **Teto de 5.000 por consulta.** A OLX pagina no máximo 100 páginas de 50. A
página 101 devolve a 100 de novo, sem erro. `q=iphone` no Brasil reporta mais
de 100 mil resultados — nenhuma consulta única alcança isso. O `plan` fatia a
busca por estado, categoria e faixa de preço até cada pedaço caber.
2. **`sortBy` troca o conjunto, não a ordem.** Aplicar qualquer ordenação faz a
OLX responder com outros anúncios: `s22 ultra` no RS dá 71 sem ordenação e 7
com. Por isso a coleta usa sempre `relevance` (o conjunto mais amplo) e ordena
localmente. **Não mude isso** para "ordenar por menor preço no servidor" — você
estaria varrendo um corpus menor.
3. **Cloudflare bloqueia, e é o gargalo real.** Blocos de 403 chegam por IP e
valem para todo o domínio, `www` incluído. Três coisas seguem disso:
- **Uma "requisição" não é uma requisição.** Abrir uma página da OLX no
browser dispara o documento, os chunks do Next, analytics, slots de anúncio
e as chamadas de API da própria página — dezenas de hits, muitos para
olx.com.br. Por isso o `olx-deals` **não abre página**