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.