~/ecommerce/woocommerce-scraper

Scraper de WooCommerce — produtos, preços, estoque e avaliações

Extraia produtos, variações, categorias e avaliações de clientes de qualquer loja WooCommerce. Informe um domínio e ele encontra o catálogo, mesmo quando a loja desativou sua API JSON.

geral TypeScriptCheerio Global

executar no Apify

proooxy/woocommerce-scraper — especificações

categoriaecommerce / geral

linguagemTypeScript

stackTypeScript, Cheerio

mercadosGlobal

saídaJSON limpo e pronto para RAG

principais recursos

Basta um domínio — o Actor encontra o catálogo sozinho

Continua funcionando em lojas com a API JSON desativada ou bloqueada por firewall

Todas as variações dos produtos variáveis, cada uma com SKU, preço e situação de estoque próprios

Avaliações de clientes como registros separados, com nota, autor e data

Preços em unidade monetária mínima junto do formato da própria loja, para que o cálculo nunca arredonde errado

Limites por loja, para que um catálogo grande não sufoque os demais numa execução com várias lojas

Busca por palavra-chave em cada loja da execução, não apenas varredura completa do catálogo

Concorrência conservadora por padrão — a maioria das lojas WooCommerce são WordPress pequenos e auto-hospedados

casos de uso

Monitoramento de preço e sortimento em lojistas WooCommerce independentes
Montar um catálogo a partir da cauda longa de lojas pequenas que nenhum marketplace cobre
Pesquisa competitiva quando o concorrente roda WordPress em vez de Shopify
Mineração de avaliações para percepção do produto e distribuição de notas
Alimentar comparadores, marketplaces e agentes de compra com dados de produto
Acompanhamento de estoque e disponibilidade para checagens de distribuição e revenda

parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
`domains`	array	opcional	Domínios simples, um por linha — a forma mais direta de apontar para uma loja
`startUrls`	array	opcional	Qualquer URL WooCommerce: raiz da loja, categoria, página de tag ou produto único
`maxProducts`	integer	opcional	Quantos registros de produto salvar em toda a execução
`maxProductsPerStore`	integer	opcional	Limite por loja, para que um catálogo grande não consuma todo o orçamento
`includeVariations`	boolean	opcional	Buscar todas as variações dos produtos variáveis, com SKU, preço e estoque
`includeReviews`	boolean	opcional	Salvar avaliações de clientes como registros separados com nota, autor e data
`query`	string	opcional	Termo de busca aplicado a cada raiz de loja ou domínio da execução
`allowHtmlFallback`	boolean	opcional	Permitir o recuo para HTML em lojas com a API JSON desativada ou bloqueada
`proxy`	object	opcional	Configuração de proxy; o scraper só escala quando a loja exige

Exemplo de saída

 1{
 2  "source": {
 3    "id": "1251",
 4    "canonicalUrl": "https://www.shoprootscience.com/shop/sample-kit",
 5    "retailer": "shoprootscience.com",
 6    "language": "en",
 7    "currency": "USD"
 8  },
 9  "title": "Sample Kit",
10  "brand": "",
11  "categories": ["Samples"],
12  "price": {
13    "current": 2000,
14    "currentFormatted": "$20.00",
15    "previous": 2000,
16    "stockStatus": "InStock",
17    "stockCount": 0
18  },
19  "stats": { "rating": 4.75, "reviewCount": 4 },
20  "options": [
21    { "type": "Sample 1", "values": [
22      { "id": "Bare Facial Serum", "name": "Bare Facial Serum" },
23      { "id": "Youth Facial Serum", "name": "Youth Facial Serum" }
24    ] }
25  ],
26  "variants": [
27    { "sku": "SK-BARE", "price": { "current": 2000, "currentFormatted": "$20.00", "stockStatus": "InStock" } }
28  ]
29}

Dicas

Comece com um domínio e um limite baixo. Cem produtos já mostram qual superfície aquela loja expõe e quão completos são os registros. Defina maxProductsPerStore em execuções com várias lojas. Sem isso, o primeiro catálogo grande consome o orçamento antes de chegar às demais. Ative avaliações de propósito. São registros e cobranças à parte, e a maior parte do trabalho de preços não precisa delas. Mantenha o recuo para HTML ligado. É o que torna as lojas fechadas viáveis; o limite por execução mantém o custo sob controle.

faq

E se a loja estiver com a API JSON desligada?

Esse é o caso comum para o qual este Actor foi feito. Ele detecta a situação e ainda assim coleta o catálogo, então uma loja fechada também retorna produtos.

Como sei se o site é mesmo WooCommerce?

Aponte o Actor para o domínio e deixe que ele decida — a detecção faz parte da execução.

As variações são registros separados?

Não. Um registro é um produto, com as variações aninhadas em variants, cada uma com SKU, preço e situação de estoque. Apenas as avaliações, quando ativadas, formam registros separados.