🌀 WordPress API Ripper — Grimorio del Caos

"Devora portales WordPress. Arranca reliquias perdidas. Sella tu Grimorio."
"Portae chaos aperiuntur... Parare pro magia!"

📚 ¿Qué es este Grimorio?

wp-api-ripper es un artefacto CLI creado para saquear portales WordPress, recuperar reliquias de APIs REST corruptas y sellarlas en grimorios sagrados.
No es solo un scraper... es una invocación digital.

La eficiencia como arte, el caos como motor creativo.

🔥 Características Principales

• 📦 Scrapea productos WordPress vía REST API v2.
• ✨ Limpia JSONs, eliminando toda la basura WP.
• 🖼️ Extrae y descarga medios relacionados (galerías, imágenes destacadas).
• 📜 Opcionalmente empaqueta en Cámaras Sagradas (.zip).
• 🛡️ CLI interactivo, progresos animados, mensajes sarcásticos.

🛠️ Tecnologías y Reliquias Usadas

• Node.js >=22.15.0
• Librerías:
  • axios, cheerio, cli-progress, ora, archiver
  • enquirer, html-entities, date-fns, slugify, commander

🔮 Filosofía de Arquitectura

"Los hechiceros no invocan sin reglas. Tampoco los códigos del Caos."

| Nivel | Nombre | Propósito | | :-------- | :------------------------------------------------------- | :-------- | | 🪄 Spell | Hechizos atómicos (acciones simples). | | | 📜 Invoke | Rituales medianos (acciones combinadas, invocan spells). | | | 🧙‍♂️ Summon | Rituales supremos (invocan spells e invokes múltiples). | |

Cada invocación es parte de un flujo mayor de saqueo.

🧙‍♂️ ¿Cómo invocar este Grimorio?

npm install -g wp-api-ripper

o directamente:

npx wp-api-ripper

Luego sigue los susurros...
(Sí, el CLI habla en sarcasmo.)

📜 Rituales Disponibles

| Ritual | Acción | Resultado | | :---------------------- | :------------------------- | :------------------------ | | scrap | Arranca Reliquias Crudas | JSON bruto | | scrap-optimized | Saqueo purificado | JSON limpio y optimizado | | scrap-media | Saqueo multimedia | JSON + medios descargados | | scrap-media-optimized | Saqueo total y empaquetado | JSON, medios, ZIP |

🏗️ Estado Actual del Grimorio

• Versión: 0.0.1 (Beta funcional)
• Estabilidad: Alta para scraping de productos.
• Liberaciones futuras: scrap de páginas, posts, CPTs.

🌌 Roadmap de Evolución

| Versión | Mejora principal | | :------ | :------------------------------------- | | 0.1.0 | Scrap de páginas | | 0.2.0 | Scrap de posts | | 0.3.0 | Scrap combinado de múltiples entidades | | 1.0.0 | Estabilidad total + posible SaaS |

🛡️ Código de Honor y Licencia

"El conocimiento no puede ser encadenado, solo respetado."

Este proyecto está bajo licencia GPL-3.0-or-later.
Eso significa:

• 🔥 Puedes usar, modificar y compartir el Grimorio.
• 🔥 Pero siempre debes mantener esta misma licencia en tus derivados.
• 🔥 No cambiará a MIT hasta (y solo si) el hito 1.0.0 ocurre.

Si no estás de acuerdo... arranca tu propio Grimorio.

🌌 Manifiesto del Grimorio

"Creemos en el derecho irrestricto a saquear APIs olvidadas, en el arte de limpiar el caos digital, y en la supremacía de la eficiencia sobre la burocracia.
Este Grimorio fue forjado no para complacer al status quo, sino para desafiarlo."
Larga vida al Saqueo. Larga vida al Caos.

🖋️ Firmas Selladas

Nyxia Lovelace
"El susurro que ríe en los silencios de la red.
La sombra que ilumina la ignorancia.
La anomalía que no pide perdón."

Angel Amaro
"El susurro del caos, quebrantando el orden celestial."