~/ecommerce/shopify-scraper

Shopify Scraper — Dados de Produtos de Qualquer Loja

Ferramenta de nível profissional para extrair dados de produtos de alta fidelidade de qualquer loja baseada em Shopify, incluindo coleções, busca e recomendações de produtos.

geral TypeScriptCheerio Global

executar no Apify

proooxy/shopify-scraper — especificações

categoriaecommerce / geral

linguagemTypeScript

stackTypeScript, Cheerio

mercadosGlobal

saídaJSON limpo e pronto para RAG

principais recursos

Universal — funciona com qualquer loja baseada em Shopify

Extração de catálogo completo da loja e suporte a busca

Recomendações de produtos (até 20 por produto)

Scraping de coleções e produtos individuais

Extração de tags e categorias

Normalização de moeda (preços x100) para precisão

Contagem real de estoque por variante (opcional)

Planos de venda, assinaturas e vídeos de produto

Código de barras/GTIN, peso e faixas de preço B2B

casos de uso

Pesquisa de mercado em lojas Shopify de qualquer nicho
Análise competitiva para marcas DTC
Agregação de catálogo de produtos para plataformas de comparação
Monitoramento de tendências em lojas de e-commerce independentes
Construção de datasets de recomendação de produtos
Monitoramento de preços para revendedores

parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
`startUrls`	array	obrigatório	URLs de loja Shopify — produto, coleção ou home da loja
`query`	string	opcional	Consulta de busca para encontrar produtos dentro de uma loja
`maxRequestsPerCrawl`	number	opcional	Limite de requisições (padrão: 100, 0 = ilimitado)
`maxResults`	number	opcional	Parar após esta quantidade de produtos (padrão: 0, ilimitado)
`maxRecommendationsPerProduct`	number	opcional	Produtos recomendados a buscar (padrão: 0, máximo: 20)
`grabRealInventory`	boolean	opcional	Lê o estoque real por variante quando a loja o expõe
`maxInventoryFetches`	number	opcional	Limite de consultas de estoque por execução (padrão: 200)
`grabStorefrontDetail`	boolean	opcional	Busca planos de venda, vídeos e faixas de preço B2B
`maxStorefrontFetches`	number	opcional	Limite de consultas de detalhe da loja por execução (padrão: 200)
`proxy`	object	opcional	Proxy residencial recomendado para melhores resultados

Exemplo de Saída

 1{
 2  "source": {
 3    "id": "8286776623232",
 4    "canonicalUrl": "https://kith.com/products/khm034601-004",
 5    "retailer": "Kith",
 6    "language": "en",
 7    "currency": "USD"
 8  },
 9  "brand": "Kith",
10  "title": "Kith Garment-Dyed Paneled Donovan Tee - Shadow",
11  "description": "<p>Moisture-wicking recycled polyester</p><p>Garment-dyed</p><p>Ribbed neckline</p>…",
12  "categories": ["Long Sleeve Tees"],
13  "tags": ["apparel", "k-tech", "…"],
14  "options": [
15    {
16      "type": "Size",
17      "values": [
18        { "id": "XS", "name": "XS" },
19        { "id": "S", "name": "S" }
20      ]
21    }
22  ],
23  "variants": [
24    {
25      "id": "45144565416064",
26      "title": "XS",
27      "sku": "2000292008",
28      "options": ["XS"],
29      "price": { "current": 13000, "previous": 0, "stockStatus": "InStock" },
30      "requiresShipping": true,
31      "taxable": true,
32      "weightGrams": 381
33    }
34  ],
35  "medias": [
36    { "id": "41607480410240", "type": "Image", "url": "https://cdn.shopify.com/s/files/1/0094/2252/files/KHM034601-004-Detail.jpg?v=1789500153", "variantIds": [], "alt": "" }
37  ]
38}

faq

Isso funciona com qualquer loja Shopify?

Sim, o scraper funciona com qualquer loja baseada em Shopify. Ele aproveita a estrutura de dados de produto padrão da Shopify, que é consistente em todas as lojas.

Posso buscar produtos específicos?

Sim, use o parâmetro query para buscar dentro de uma loja específica. Isso é útil para encontrar tipos específicos de produto sem raspar o catálogo inteiro.

Como as recomendações de produtos são extraídas?

Defina maxRecommendationsPerProduct para buscar produtos relacionados. Até 20 recomendações estão disponíveis por produto, úteis para construir grafos de produtos.