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.

Related MCP server: LinkedIn MCP Server

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__*)

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.