~/ecommerce/shopify-scraper

Scraper de Shopify — Datos de producto de cualquier tienda

Herramienta de nivel profesional para extraer datos de producto de alta fidelidad de cualquier tienda basada en Shopify, incluyendo colecciones, búsqueda y recomendaciones de producto.

general TypeScriptCheerio Global

ejecutar en Apify

proooxy/shopify-scraper — spec

categoríaecommerce / general

lenguajeTypeScript

stackTypeScript, Cheerio

mercadosGlobal

salidaJSON limpio y listo para RAG

características clave

Universal — funciona con cualquier tienda basada en Shopify

Extracción de catálogo completo de la tienda y soporte de búsqueda

Recomendaciones de producto (hasta 20 por producto)

Scraping de colecciones y productos individuales

Extracción de etiquetas y categorías

Normalización de divisa (precios x100) para mayor precisión

Recuento real de inventario por variante (opcional)

Planes de venta, suscripciones y vídeos de producto

Código de barras/GTIN, peso y precios por volumen B2B

casos de uso

Investigación de mercado en tiendas Shopify de cualquier nicho
Análisis competitivo para marcas DTC
Agregación de catálogo de producto para plataformas de comparación
Seguimiento de tendencias en tiendas de e-commerce independientes
Construcción de datasets de recomendación de producto
Seguimiento de precios para revendedores

parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`startUrls`	array	obligatorio	URLs de tienda Shopify — producto, colección o inicio de la tienda
`query`	string	opcional	Consulta de búsqueda para encontrar productos dentro de una tienda
`maxRequestsPerCrawl`	number	opcional	Límite de solicitudes (por defecto: 100, 0 = sin límite)
`maxResults`	number	opcional	Detenerse tras este número de productos (por defecto: 0, sin límite)
`maxRecommendationsPerProduct`	number	opcional	Productos recomendados a obtener (por defecto: 0, máx: 20)
`grabRealInventory`	boolean	opcional	Lee el stock real por variante cuando la tienda lo expone
`maxInventoryFetches`	number	opcional	Límite de consultas de inventario por ejecución (por defecto: 200)
`grabStorefrontDetail`	boolean	opcional	Obtiene planes de venta, vídeos y precios por volumen B2B
`maxStorefrontFetches`	number	opcional	Límite de consultas de detalle de tienda por ejecución (por defecto: 200)
`proxy`	object	opcional	Se recomienda proxy residencial para obtener mejores resultados

Ejemplo de salida

 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

¿Funciona con cualquier tienda Shopify?

Sí, el scraper funciona con cualquier tienda basada en Shopify. Aprovecha la estructura de datos de producto estándar de Shopify, que es consistente en todas las tiendas.

¿Puedo buscar productos específicos?

Sí, usa el parámetro query para buscar dentro de una tienda específica. Esto es útil para encontrar tipos de producto concretos sin extraer todo el catálogo.

¿Cómo se extraen las recomendaciones de producto?

Establece maxRecommendationsPerProduct para obtener productos relacionados. Hay disponibles hasta 20 recomendaciones por producto, útil para construir grafos de producto.