Media and Entertainment

Skool

pp-skool

Every Skool community feature, plus a local SQLite mirror, FTS, and cross-community ops no other Skool tool ships.

Printed by @quoxientzero (Zain Haseeb)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install skool

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-skool --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-skool skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-skool. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

Every Skool community feature, plus a local SQLite mirror, FTS, and cross-community ops no other Skool tool ships.

Pulls every post, comment, member, course, lesson, and calendar event into a local SQLite store with FTS5 so you can query historical state, compute leaderboard deltas, and surface at-risk members the native UI cannot show. One auth_token cookie, two hosts (www.skool.com reads, api2.skool.com writes), zero CloudFront friction.

Authentication

Skool has no public API. Authenticate with the auth_token JWT cookie from your logged-in browser session: skool-pp-cli auth set-token (writes ~/.config/skool-pp-cli/config.toml). Same cookie covers reads and writes; CloudFront requires a realistic User-Agent which the CLI sets automatically.

Quick Start

# Paste your auth_token cookie value once; lives in TOML config
skool-pp-cli auth set-token

# First-time sync of the community into the local store
skool-pp-cli sync bewarethedefault

# List recent posts with field selection
skool-pp-cli posts list --limit 10 --json --select id,name,user.name

# Current 30-day leaderboard
skool-pp-cli leaderboard --type 30d --top 25

# Transcendence: members whose engagement velocity is dropping
skool-pp-cli members at-risk --weeks 4 --json

# What's new in the last day across the community
skool-pp-cli digest since 24h

Unique Features

These capabilities aren't available in any other tool for this API.

Local state that compounds

posts top — Rank recent posts by upvotes, comments, or engagement and return them with full content.

Pick this for a daily/weekly cron that surfaces the 3-5 most-engaging posts from any community — perfect for catching up without scrolling.
```
skool-pp-cli posts top --community earlyaidopters --since 7d --top 5 --by engagement --json
```
leaderboard — Top members by points for the community, with level and bio fields included.

Pick this when an agent needs the current community leaderboard in one call without scraping the page.
```
skool-pp-cli leaderboard --community bewarethedefault --top 25 --json
```
digest since — Aggregate everything new across posts, comments, members, and lessons since a timestamp.

Pick this when an agent needs a single brief of community activity for a daily/weekly cron.
```
skool-pp-cli digest since 24h --json
```
sql — Run read-only SQL across every community in your local store.

Pick this when an agent needs to compose a query across multiple Skool communities you own or operate.
```
skool-pp-cli sql 'SELECT community, COUNT(*) FROM posts GROUP BY community'
```

Agent-native plumbing

calendar export — Export upcoming community events to an .ics file for Google Cal / Outlook.

Pick this when a member wants community events on their personal calendar without manual entry.
```
skool-pp-cli calendar export --ics > community.ics
```
classroom export — Export an entire course to a markdown bundle (modules, lessons, attachments, video URLs).

Pick this when an agent needs to ingest a course for offline reference, search, or LLM retrieval.
```
skool-pp-cli classroom export <course-slug> --out ./course/
```

Usage

Run skool-pp-cli --help for the full command reference and flag list.

Commands

calendar

Community calendar events

skool-pp-cli calendar list - List upcoming and recent calendar events

classroom

Classroom (courses, modules, lessons) for a community

skool-pp-cli classroom get-course - Get a single course with its modules and lessons
skool-pp-cli classroom list - List all courses in a community

community

Community feed, settings, and metadata

skool-pp-cli community about - About page (rules, owner, member count)
skool-pp-cli community info - Get the community feed (posts, leaderboard summary, upcoming events, settings)
skool-pp-cli community leaderboard-tab - Leaderboard tab (community page rendered with t=leaderboard)
skool-pp-cli community members-tab - Members tab data (community page rendered with t=members)

me

Current authenticated user dashboard

skool-pp-cli me get - Get current user, joined communities, and dashboard state

members

Community members and moderation

skool-pp-cli members approve - Approve a pending member request
skool-pp-cli members ban - Ban a member from the community
skool-pp-cli members pending - List pending member join requests
skool-pp-cli members reject - Reject a pending member request

notifications

User notifications

skool-pp-cli notifications list - List notifications for the authenticated user
skool-pp-cli notifications mark-read - Mark notifications as read (empty ids = mark all)

posts

Posts (forum threads) inside a community

skool-pp-cli posts comment - Add a comment to a post
skool-pp-cli posts create - Create a new post (body = TipTap JSON; use --md to convert markdown)
skool-pp-cli posts delete - Delete a post
skool-pp-cli posts get - Get a post detail page including comment tree
skool-pp-cli posts like - Like (upvote) a post
skool-pp-cli posts unlike - Unlike a post
skool-pp-cli posts update - Update an existing post

Output Formats

# Human-readable table (default in terminal, JSON when piped)
skool-pp-cli calendar mock-value --community example-value

# JSON for scripting and agents
skool-pp-cli calendar mock-value --community example-value --json

# Filter to specific fields
skool-pp-cli calendar mock-value --community example-value --json --select id,name,status

# Dry run — show the request without sending
skool-pp-cli calendar mock-value --community example-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
skool-pp-cli calendar mock-value --community example-value --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select id,name returns only fields you need
Previewable - --dry-run shows the request without sending
Explicit retries - add --idempotent to create retries and --ignore-missing to delete retries when a no-op success is acceptable
Confirmable - --yes for explicit confirmation of destructive actions
Piped input - write commands can accept structured input when their help lists --stdin
Offline-friendly - sync/search commands can use the local SQLite store when available
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Freshness

This CLI owns bounded freshness for registered store-backed read command paths. In --data-source auto mode, covered commands check the local SQLite store before serving results; stale or missing resources trigger a bounded refresh, and refresh failures fall back to the existing local data with a warning. --data-source local never refreshes, and --data-source live reads the API without mutating the local store.

Set SKOOL_NO_AUTO_REFRESH=1 to disable the pre-read freshness hook while preserving the selected data source.

Covered command paths:

skool-pp-cli notifications
skool-pp-cli notifications list
skool-pp-cli notifications mark-read

JSON outputs that use the generated provenance envelope include freshness metadata at meta.freshness. This metadata describes the freshness decision for the covered command path; it does not claim full historical backfill or API-specific enrichment.

Runtime Endpoint

This CLI resolves endpoint placeholders at runtime, so one installed binary can target different tenants or API versions without regeneration.

Endpoint environment variables:

SKOOL_COMMUNITY resolves {community}
SKOOL_BUILDID resolves {buildId}

Base URL: https://www.skool.com

Health Check

skool-pp-cli doctor

Verifies configuration, credentials, and connectivity to the API.

Configuration

Config file: ~/.config/skool-pp-cli/config.toml

Troubleshooting

Authentication errors (exit code 4)

Run skool-pp-cli doctor to check credentials Not found errors (exit code 3)
Check the resource ID is correct
Run the list command to see available items

API-specific

404 on read endpoints — Run skool-pp-cli doctor; the buildId likely rotated. The CLI auto-refetches but you can force skool-pp-cli buildid refresh.
403 from CloudFront — Your auth_token expired or User-Agent is missing. Run skool-pp-cli auth status then auth set-token with a fresh cookie.
Empty leaderboard delta — Need at least two snapshots. Run skool-pp-cli sync over multiple days, or sync --snapshot-now to seed two points.

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Sources & Inspiration

This CLI was built by studying these projects and resources:

louiewoof2026/skool-mcp — TypeScript
cristiantala/skool-all-in-one-api — TypeScript
FlowExtractAPI/skool-scraper-pro — TypeScript
moon-home/scraper — Python
aperswal/Skool_Active_Members_Chrome_Extension — JavaScript

Generated by CLI Printing Press