skool-monitor

Skool Community Monitoring & Interaction

Goal

Monitor AND interact with Skool community via reverse-engineered API. Read posts, create posts, reply to comments, like content, and search.

CRITICAL SAFETY CONSTRAINTS

NEVER perform write operations without explicit user approval:

• DO NOT create posts unless explicitly requested
• DO NOT like posts unless explicitly requested
• DO NOT reply to posts unless explicitly requested
• Read operations are safe and can be performed freely

Scripts

• ./scripts/skool_unreads.py - Fetch unread posts
• ./scripts/skool_scraper.py - Read posts and extract content
• ./scripts/skool_browser_client.py - Write operations (recommended)
• ./scripts/skool_client.py - Write operations (legacy)
• ./scripts/skool_comment_scraper.py - Scrape comments

Quick Reference

# Check unreads from last 48 hours (most common)
python3 ./scripts/skool_unreads.py --since 48 --summary

# Just get unread count
python3 ./scripts/skool_unreads.py --count-only

# Read posts
python3 ./scripts/skool_scraper.py posts --community makerschool --limit 10

# Create post (REQUIRES APPROVAL)
python3 ./scripts/skool_browser_client.py create \
  --title "Title" --content "Content" --labels 3b2896c64f8f415ca62105fdae269357

# Reply to post (REQUIRES APPROVAL)
python3 ./scripts/skool_browser_client.py reply --post-id <id> --content "Reply"

# Like post (REQUIRES APPROVAL)
python3 ./scripts/skool_browser_client.py like --post-id <id>

# Search
python3 ./scripts/skool_client.py search --query "keyword"

Unread Posts

# Last 48 hours with summary
python3 ./scripts/skool_unreads.py --since 48 --summary

# Export to JSON
python3 ./scripts/skool_unreads.py --since 48 --output .tmp/unreads.json

Output categorizes as:

• New posts (never viewed)
• New comments (posts with new activity)

Write Operations (Browser-Based)

Uses Playwright to maintain real browser session and auto-generate WAF tokens.

# Create post
python3 ./scripts/skool_browser_client.py create \
  --title "My Post" --content "Content here" --labels <label_id>

# Reply
python3 ./scripts/skool_browser_client.py reply --post-id <id> --content "Reply text"

# Like/Unlike
python3 ./scripts/skool_browser_client.py like --post-id <id>
python3 ./scripts/skool_browser_client.py unlike --post-id <id>

Rate Limits

• Reading: Stay under 1 req/sec
• Writing: Max 1 post per 30 seconds, 5 comments per minute, 10 likes per minute

Troubleshooting

Error	Solution
403 Forbidden	WAF token expired (use browser_client instead of manual)
401 Unauthorized	Update auth_token from browser cookies
429 Too Many Requests	Wait 60 seconds, reduce frequency

Environment

SKOOL_AUTH_TOKEN=your_token
SKOOL_CLIENT_ID=your_client_id

---

Schema

Inputs

Name	Type	Required	Description
since	integer	No	Hours to look back (default: 48)
community	string	No	Community slug (default: makerschool)
action	string	No	Action: read, create, reply, like, search

Outputs

Name	Type	Description
posts	array	Unread posts with metadata
summary	string	AI summary of unreads (if --summary flag)

Credentials

Name	Source
SKOOL_AUTH_TOKEN	.env
SKOOL_CLIENT_ID	.env

Composable With

Skills that chain well with this one: skool-rag

Cost

Free (reverse-engineered API)