skool-mcp-kit

Servidor MCP + skill de Claude Code para operar y analizar tu comunidad de Skool con tu propia sesión: ver el calendario de reuniones/eventos, leer el feed y los posts, consultar la comunidad, el classroom y los miembros, buscar, y publicar/comentar en tu nombre (con confirmación). Espejo del patrón del kit de LinkedIn del autor. Cero dependencias npm (Node ≥ 18, fetch global).

⚠️ Skool no tiene API pública: esto usa su API interna vía tu sesión autenticada. Va contra el ToS de Skool; úsalo solo con tu cuenta, a ritmo humano, asumiendo el riesgo. No afiliado a Skool.

Arquitectura

• Lectura (primaria): rutas SSR de Next.js www.skool.com/_next/data/{buildId}/…json con las cookies de sesión (self poblado = autenticado). El buildId se scrapea en vivo.
• api2.skool.com: búsqueda de miembros, comentarios de un post, metadata pública y las escrituras (POST /posts, POST /comments).
• Auth: cookies auth_token (JWT, ~1 año) + client_id + aws-waf-token (~3 días, lo acuña un navegador). Guardadas en ~/.skool-mcp/session.json (chmod 600), nunca en el repo.

Instalación

git clone https://github.com/elchamoluso/skool-mcp-kit.git && cd skool-mcp-kit
bash install.sh            # copia la skill + registra el MCP (scope user)
# Sesión (una vez por máquina):
node bin/skool-session.js seed --from <storageState.json>   # desde un state de agent-browser/Playwright
#   o:  node bin/skool-session.js login                     # login interactivo en navegador
node bin/skool-session.js status                            # verifica token_valid
# Reinicia Claude Code para cargar el server MCP.

Registro manual (si no usas el installer): copia configs/claude-code.mcp.json a tu .mcp.json, o:

claude mcp add skool --scope user --transport stdio --env SKOOL_COMMUNITY=ailinkvip -- node "$PWD/skool-mcp-server.js"

Herramientas (mcp__skool__*)

Tool	Qué hace
skool_status	Valida la sesión y devuelve tu identidad + comunidad.
skool_community_info	Nombre, descripción, dueño, totales, pestañas, enlaces.
skool_calendar	Calendario de eventos/reuniones (por defecto próximas). from/to/next/limit.
skool_event	Detalle de un evento por event_id (+ occurrence_id).
skool_feed	Feed de posts (page, sort, label, pinned_only).
skool_post	Un post por post_slug + su hilo de comentarios.
skool_members	Directorio paginado (email omitido salvo include_email:true).
skool_search	Busca miembros por nombre.
skool_classroom	Cursos; con course_id, resumen del curso.
skool_create_post ⚠️	Publica un post (content, title?, label?, confirm:true).
skool_create_comment ⚠️	Comenta un post (post_slug|post_id, content, confirm:true).

Las escrituras exigen confirm:true (gate en el server) además de los guardrails de la skill (confirmación por acción, sin bulk, topes diarios, ritmo humano, stop-on-checkpoint).

CLI de sesión (bin/skool-session.js)

seed --from <state> · status · login (navegador headed → re-siembra y refresca el aws-waf-token) · logout.

Sesión caducada / bloqueo del WAF

status da token_valid:false, o una lectura devuelve 403 → corre node bin/skool-session.js login. El aws-waf-token (~3 días) solo lo acuña un navegador real; login lo refresca y re-siembra session.json.

Créditos

Código propio (molde de plumbing MCP: nt-mcp-server). Conocimiento de la API interna de Skool documentado a partir de louiewoof2026/skool-mcp (API-DISCOVERY.md), reimplementado sin copiar código. Licencia MIT. Ver README.en.md para la versión en inglés.