What problem does it solve?
Substack lacks a public API and existing tools only cover basic Notes scheduling and heatmaps, forcing creators to manually track growth and engagement across multiple disconnected interfaces. This skill provides a complete command-line interface that reverse-engineers the full Substack API surface, enabling automated publishing, scheduling, engagement, and cross-table growth analytics from a single terminal.
Core Features & Use Cases
- End-to-End Growth Loop: Publish Notes and long-form posts, schedule content with cadence guards to avoid algorithm penalties, engage with other writers, and measure subscriber attribution in one workflow.
- Cross-Table Analytics: Connect Notes to paid and free subscriber growth, track engagement reciprocity to identify free-riders, and discover optimal posting times using local SQLite analytics.
- Agent-Native Automation: Every command supports JSON output, dry-run previews, field selection, and non-interactive flags, making it ideal for AI agents to drive the full publish-engage-measure-swap loop without human intervention.
Quick Start
Use the pp-substack skill to authenticate with your Substack browser session, sync your recent publication data, and run a growth attribution analysis to identify which of your last 30 days of Notes drove the most subscriptions.