skool-cli 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skool-cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "CLI and programmatic API for Skool.com automation — create lessons, posts, and manage communities via browser automation",
   "type": "module",
   "main": "dist/core/skool-client.js",

package/CLAUDE.md

@@ -1,104 +0,0 @@
-# CLAUDE.md - skool-cli
-
-## Sobre este proyecto
-
-CLI, Skill y MCP Server para automatizar Skool.com. Publicado en npm como `skool-cli` (v1.0.1) y en GitHub como `unikprompt/skool-cli`.
-
-Skool no tiene API publica. Usamos Playwright para auth y la API interna `api2.skool.com` (descubierta via interceptacion de red) para operaciones de contenido.
-
-## Links
-
-- **npm**: npmjs.com/package/skool-cli
-- **GitHub**: github.com/unikprompt/skool-cli
-- **Skool group**: skool.com/operadores-aumentados
-
-## Estructura
-
-```
-skool-cli/
-  src/
-    cli.ts                 # Entry point CLI (Commander.js)
-    mcp/server.ts          # Entry point MCP Server
-    commands/              # 10 comandos CLI
-    core/
-      skool-client.ts      # API publica (high-level)
-      skool-api.ts         # HTTP client + HTML-to-TipTap converter
-      page-ops.ts          # Playwright browser ops (nav, posts, auth)
-      browser-manager.ts   # Playwright lifecycle + session persistence
-      html-generator.ts    # Markdown/JSON → HTML (port de Content-Pipeline)
-      config.ts            # Constantes y env vars
-      types.ts             # TypeScript interfaces
-  skill/SKILL.md           # Claude Code skill (alternativa liviana a MCP)
-  dist/                    # Compiled JS (npm publish from here)
-```
-
-## Comandos
-
-```bash
-skool login -e EMAIL -p PASSWORD     # Auth (guarda cookies en ~/.skool-cli/)
-skool whoami -g GROUP                # Verifica sesion
-skool create-lesson -g GROUP --course COURSE -t TITULO --markdown "contenido"
-skool create-lesson -g GROUP --course COURSE --folder-id ID -t TITULO -f archivo.md
-skool create-folder -g GROUP --course COURSE -t "Nombre Modulo"
-skool delete-lesson --id PAGE_ID
-skool list-lessons -g GROUP --course COURSE
-skool create-post -g GROUP -t TITULO -b "body" -c CATEGORIA
-skool get-posts -g GROUP
-skool get-categories -g GROUP
-skool get-members -g GROUP
-```
-
-## API Interna de Skool (api2.skool.com)
-
-| Endpoint | Metodo | Que hace |
-|----------|--------|----------|
-| `/courses` | POST | Crea pagina (`unit_type: "module"`) o folder (`unit_type: "set"`) |
-| `/courses/{id}` | PUT | Actualiza titulo + contenido (`desc: "[v2]" + TipTap JSON`) |
-| `/courses/{id}` | DELETE | Elimina pagina o folder |
-
-**Auth**: Cookies del browser (`auth_token` JWT).
-
-**IDs necesarios**: `group_id` (de assets URL), `user_id` (de JWT payload), `root_id` (interceptando POST response al crear pagina temporal).
-
-**Formato de contenido**: TipTap JSON con prefijo `[v2]`. Ejemplo:
-```json
-"[v2][{\"type\":\"heading\",\"attrs\":{\"level\":2},\"content\":[{\"type\":\"text\",\"text\":\"Titulo\"}]},{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Contenido con \"},{\"type\":\"text\",\"text\":\"bold\",\"marks\":[{\"type\":\"bold\"}]}]}]"
-```
-
-## Build y publish
-
-```bash
-npm run build              # Compila TypeScript
-npm version patch          # Bump version
-npm publish --access public # Publica en npm
-git push origin main       # Push a GitHub
-```
-
-**npm account**: `unikprompt` (token en `~/.npmrc`)
-
-## Env vars
-
-| Variable | Default | Uso |
-|----------|---------|-----|
-| `SKOOL_EMAIL` | - | Email default para login |
-| `SKOOL_PASSWORD` | - | Password default |
-| `SKOOL_GROUP` | - | Group slug default |
-| `SKOOL_CLI_HEADLESS` | `true` | `false` para ver el browser |
-| `SKOOL_CLI_DATA_DIR` | `~/.skool-cli/` | Donde se guardan cookies |
-| `SKOOL_CLI_TIMEOUT` | `30000` | Timeout en ms |
-
-## Decisiones tecnicas
-
-- **API directa sobre UI automation**: Intentamos 10+ veces automatizar el editor TipTap via Playwright (pencil icon click, setContent, dirty trigger). React synthetic events no responden a dispatchEvent ni a clicks de Playwright en SVGs. La solucion fue descubrir la API interna via interceptacion de red.
-- **Playwright solo para auth**: Login requiere browser real (CAPTCHA, WAF). Despues de auth, todas las operaciones son HTTP puro.
-- **TipTap JSON, no HTML**: Skool almacena contenido como `[v2]` + TipTap JSON, no HTML. El `htmlToSkoolDesc()` en skool-api.ts convierte HTML a este formato.
-- **Session en disco**: `~/.skool-cli/auth-state.json` persiste cookies entre invocaciones del CLI.
-
-## Pendiente
-
-- Fix `--folder` por nombre (endpoint GET para listar items no descubierto, fallback via __NEXT_DATA__)
-- Limpiar dist/ de archivos debug viejos (debug.js, test-api.js siguen en dist/ de v1.0.1)
-- Mejorar parser de inline marks (espacios entre bold/italic y texto adyacente)
-- Soporte para editar lecciones existentes (PUT con ID conocido)
-- Soporte para mover lecciones entre folders
-- Tests automatizados

package/planning.md

@@ -1,135 +0,0 @@
-# skool-cli - Planning Document
-
-## Vision Original (2026-04-01)
-
-Construir la primera herramienta de automatizacion para Skool.com publicable en npm. Skool no tiene API publica, lo que representa una oportunidad: ser el unico CLI/MCP funcional para Skool en todo el ecosistema.
-
-### Modelo de negocio: Picos y Palas
-
-La herramienta gratuita en npm/GitHub alimenta el funnel de UnikPrompt:
-```
-GitHub/npm (descubrimiento gratuito)
-  → TikTok/Instagram (demos en accion)
-    → Facebook Group "Claude Code en Espanol" (soporte gratuito)
-      → Skool "Operadores Aumentados" (comunidad premium)
-```
-
-### Comparacion de enfoques
-
-Se evaluaron 3 opciones:
-
-| Criterio | MCP Server solo | CLI solo | CLI + MCP (elegido) |
-|----------|----------------|----------|---------------------|
-| Audiencia | Solo MCP clients | Todos con terminal | Todos |
-| Scriptable | No | Si | Si |
-| AI integration | Nativa (tools) | Via bash | Ambos |
-| Paquetes npm | 1 | 1 | 2 |
-
-**Decision: CLI + MCP + Skill** (maximo alcance, una sola base de codigo)
-
-Inspirado en opencli (github.com/jackwener/opencli, 10.6K stars) como modelo de CLI universal.
-
-## API Interna Descubierta
-
-Skool usa `api2.skool.com` como backend. Descubierto via interceptacion de red con Playwright `page.on('request')` y `page.on('response')`.
-
-### Endpoints
-
-| Endpoint | Metodo | Uso |
-|----------|--------|-----|
-| `/courses` | POST | Crear pagina (`unit_type: "module"`) o folder (`unit_type: "set"`) |
-| `/courses/{id}` | PUT | Actualizar titulo + contenido |
-| `/courses/{id}` | DELETE | Eliminar pagina o folder |
-
-### Formato de contenido
-
-Skool almacena contenido como TipTap JSON con prefijo `[v2]`:
-```json
-{
-  "title": "Titulo",
-  "desc": "[v2][{\"type\":\"heading\",\"attrs\":{\"level\":2},\"content\":[{\"type\":\"text\",\"text\":\"Mi Heading\"}]},{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Texto normal \"},{\"type\":\"text\",\"text\":\"bold\",\"marks\":[{\"type\":\"bold\"}]}]}]"
-}
-```
-
-### Autenticacion
-
-- Login via Playwright (browser headless)
-- Cookies persistidas en `~/.skool-cli/auth-state.json`
-- `user_id` extraido del JWT `auth_token` cookie (campo `user_id` del payload)
-- `group_id` extraido de assets URL (patron `assets.skool.com/f/{group_id}`)
-- `root_id` descubierto interceptando el POST response al crear pagina temporal
-
-## Decisiones Tecnicas
-
-### Por que API directa sobre Playwright UI automation
-
-Se intento 10+ veces automatizar el editor TipTap de Skool via Playwright:
-1. `dispatchEvent(new MouseEvent(...))` no activa React synthetic events
-2. Click real de Playwright en SVGs (pencil icon) es inconsistente
-3. Incluso detectando "edit mode" (SAVE button), titulo y contenido no se llenaban
-4. 6 workarounds de produccion necesarios (dirty trigger, overlay fix, ref volatility, SPA timing, HTML conversion, title limit)
-
-La API directa elimina toda esa complejidad: un POST crea la pagina, un PUT le pone contenido.
-
-### Stack tecnologico
-
-- TypeScript + Commander.js (CLI)
-- Playwright (solo para login, una vez)
-- MCP SDK + Zod (MCP server)
-- Node.js >= 18
-
-## Cronologia
-
-| Fecha | Hito |
-|-------|------|
-| 2026-04-01 | Inicio: evaluacion MCP vs CLI vs opencli |
-| 2026-04-01 | Scaffolding del proyecto, setup TypeScript + Commander |
-| 2026-04-01 | Login funcional, get-posts, get-categories, get-members |
-| 2026-04-01 | create-post funcional con categoria |
-| 2026-04-01/02 | 10+ intentos de UI automation para create-lesson (fallido) |
-| 2026-04-02 | Pivot a API-first: interceptacion de red |
-| 2026-04-03 | Descubrimiento de api2.skool.com/courses |
-| 2026-04-03 | create-lesson funcional via API (titulo + contenido) |
-| 2026-04-03 | Descubrimiento de folders (unit_type "set") |
-| 2026-04-03 | create-folder + create-lesson --folder-id funcional |
-| 2026-04-04 | Cleanup, delete-lesson, list-lessons |
-| 2026-04-04 | npm publish v1.0.0 y v1.0.1 (npmjs.com/package/skool-cli) |
-| 2026-04-04 | MCP server wrapper (10 tools) |
-| 2026-04-04 | Claude Code Skill (skill/SKILL.md) |
-| 2026-04-04 | GitHub repo (github.com/unikprompt/skool-cli) |
-| 2026-04-04 | Integracion con Content-Pipeline (reemplazo de Playwright) |
-
-## Estado Actual (v1.0.1)
-
-### 10 Comandos
-
-| Comando | Estado |
-|---------|--------|
-| `login` | OK |
-| `whoami` | OK |
-| `create-lesson` | OK (con --folder-id, --course, --file, --markdown) |
-| `create-folder` | OK |
-| `delete-lesson` | OK |
-| `list-lessons` | OK (via sidebar DOM) |
-| `create-post` | OK (con --category) |
-| `get-posts` | OK |
-| `get-categories` | OK |
-| `get-members` | OK |
-
-### 3 Canales de distribucion
-
-| Canal | URL |
-|-------|-----|
-| npm | npmjs.com/package/skool-cli |
-| GitHub | github.com/unikprompt/skool-cli |
-| Skill | skill/SKILL.md (para Claude Code) |
-
-## Pendiente
-
-- Fix `--folder` por nombre (endpoint GET no descubierto, fallback via __NEXT_DATA__)
-- Limpiar dist/ de archivos debug viejos del build anterior
-- Mejorar parser de inline marks (espacios entre bold/italic y texto adyacente)
-- Soporte para editar lecciones existentes (PUT con ID conocido)
-- Soporte para mover lecciones entre folders
-- Tests automatizados
-- Agregar a landing page unikprompt.com