3.1.2 • Published 9 months ago
@arisnetxsolutions/shopify-scraper v3.1.2
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 startDesde 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
📈 Excel (.xlsx):
- Productos
- Variantes
- Imágenes
📄 CSV y JSON:
products.csv/products.jsonvariants.csv/variants.jsonimages.csv/images.jsonsummary.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:
- Fork el proyecto
- Crea una rama para tu feature
- Haz commit de tus cambios
- Push a la rama
- Abre un Pull Request
📞 Soporte
Si encuentras algún problema o tienes preguntas:
- Revisa la documentación
- Abre un issue en GitHub
- 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.