pp-substack

Automate Substack publishing and growth analytics via a command-line interface.

Updated May 22, 2026
One-click install
npx skills add https://github.com/shekerkamma/peopletech-marketplace --skill pp-substack-shekerkamma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pp-substack
Source: https://github.com/shekerkamma/peopletech-marketplace/tree/main/plugins/integrations/skills/substack
Command: npx skills add https://github.com/shekerkamma/peopletech-marketplace --skill pp-substack-shekerkamma

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about pp-substack

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Substack publishing and growth analytics without an official API?▼

You can automate Substack publishing and growth analytics by using a CLI that reverse-engineers the platform's undocumented API, enabling automated post scheduling, engagement tracking, and subscriber attribution directly from the terminal.

How do I track Substack engagement reciprocity and subscriber attribution locally?▼

You track Substack engagement reciprocity and subscriber attribution by syncing publication data into a local SQLite database, allowing cross-table joins to connect Notes to paid and free subscriber growth.

Can I schedule Substack Notes from the command line without algorithm penalties?▼

You can schedule Substack Notes from the command line using built-in cadence guards that prevent algorithm penalties, automate publishing workflows, and preview content with dry-run modes.

Do I need a Chrome browser session to automate Substack content publishing?▼

Yes, you need an active Chrome browser session for cookie-based authentication to authorize the CLI binary to interact with your Substack publication securely.

How can an AI agent automate my Substack engagement and measurement loop?▼

An AI agent can automate your Substack engagement loop because every CLI command supports JSON output, dry-run previews, and non-interactive flags, enabling full publish-engage-measure automation without human intervention.

What is the best way to identify optimal Substack posting times without manual dashboard work?▼

The best way to identify optimal Substack posting times is running local SQLite analytics on your synced publication data, bypassing manual dashboard work to measure historical engagement patterns directly.