Shopify Data Extractor

Un extractor de datos de tiendas Shopify que utiliza la API oficial para obtener información de productos, variantes e imágenes, exportándolos en formatos CSV, JSON y Excel.

📦 Instalación

Desde npm (Recomendado)

# Instalación global
npm install -g @arisnetxsolutions/shopify-scraper

# Uso directo
shopify-scraper start

Desde código fuente

# Clonar repositorio
git clone https://github.com/arisnetxsolutions/shopify-scraper.git
cd shopify-scraper

# Instalar dependencias
npm install

📦 Dependencias

• axios: Cliente HTTP para llamadas a la API
• csv-writer: Generación de archivos CSV
• json2csv: Conversión de JSON a CSV
• xlsx: Generación de archivos Excel con múltiples hojas

⚙️ Configuración

Puedes configurar la herramienta usando un archivo config.json:

{
  "storeUrl": "https://tu-tienda.com/",
  "outputDir": "./output",
  "apiTimeout": 5000,
  "currency": "USD",
  "limits": {
    "maxConcurrentRequests": 5
  },
  "export": {
    "csv": true,
    "json": true,
    "summary": true,
    "excel": true
  }
}

🚀 Características

• API Shopify: Extracción eficiente usando la API oficial
• Datos Completos: Productos, variantes e imágenes
• Múltiples Formatos: Exportación en CSV, JSON y Excel
• Arquitectura Modular: Código organizado y mantenible
• Manejo de Errores: Control robusto de errores y timeouts
• Reportes: Generación automática de estadísticas
• CLI Integrada: Interfaz de línea de comandos simple

📊 Datos Extraídos

Formatos de Salida

1. 📈 Excel (.xlsx):
   • Productos
   • Variantes
   • Imágenes
2. 📄 CSV y JSON:
   • products.csv / products.json
   • variants.csv / variants.json
   • images.csv / images.json
   • summary.json

Campos Extraídos

Productos

• ID del producto
• Título
• Handle (identificador URL)
• Vendor
• Tipo de producto
• Fechas de creación/actualización
• Tags
• URL del producto

Variantes

• ID de la variante
• ID del producto padre
• Título
• Precio
• SKU
• Código de barras
• Inventario
• Peso

Imágenes

• ID de la imagen
• ID del producto
• URL
• Texto alternativo
• Posición

🔧 Consideraciones

• La tienda debe tener habilitada la API pública de Shopify
• Se respetan los límites de tasa de la API
• Algunos datos pueden no estar disponibles según la configuración de la tienda

📄 Licencia

Este proyecto está bajo la licencia MIT. Ver archivo LICENSE para más detalles.

🤝 Contribuciones

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature
3. Haz commit de tus cambios
4. Push a la rama
5. Abre un Pull Request

📞 Soporte

Si encuentras algún problema o tienes preguntas:

1. Revisa la documentación
2. Abre un issue en GitHub
3. Contacta al equipo de desarrollo

Nota: Asegúrate de cumplir con los términos de servicio de Shopify y las políticas de la tienda objetivo.