Pp Scrape Creators

<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/developer-tools/scrape-creators/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Scrape Creators — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the scrape-creators-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: ``bash npx -y @mvanhorn/printing-press-library install scrape-creators --cli-only ``
2. Verify: scrape-creators-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/developer-tools/scrape-creators/cmd/scrape-creators-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

The official CLI mirrors endpoints and the official skills describe curl workflows; neither remembers anything between runs. This CLI syncs profiles, posts, comments with their replies, transcripts, and ads into SQLite with FTS5 search, routes comment-thread fetches on credit economics (comments thread), audits reply completeness against ground truth (comments coverage), and gates expensive sweeps behind a pre-flight credit estimate (account estimate).

When to Use This CLI

Use this CLI when a task touches public social-media data at scale: mining comments and replies for a brand, qualifying creators across platforms, monitoring competitor ads, or searching transcript/comment corpora you have already synced. It is the right choice whenever credit economics matter — its thread routing, sweep budgets, and pre-flight estimates exist so agents never spend blind.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to post, like, follow, or message on any platform — it is read-only public-data scraping
• Do not use it for private/logged-in-only content; it sees what the public sees
• Do not use it as a general web scraper for non-social sites; use a crawling tool instead

Unique Capabilities

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

Comment-thread completeness

• `comments thread` — Fetch one post's complete comment threads, automatically picking the cheaper route between the 15-credit flat include_replies call and 1-credit per-comment reply calls (don't trust child_comment_count to decide: it's unreliable). By default only the first page of top-level comments is fetched and truncated: true reports when more exist; pass --max-credits N to keep traversing further pages under a credit budget that gates every paid call (the envelope's note says why a traversal stopped).

_Reach for this when you need every reply on a post without doing credit arithmetic by hand._

  scrape-creators-pp-cli comments thread https://www.instagram.com/reel/C8rKmYvsrck --agent
  scrape-creators-pp-cli comments thread https://www.instagram.com/reel/C8rKmYvsrck --max-credits 60 --agent

• `comments coverage` — Rank synced posts by how many comments the API reported versus how many actually landed in your local store — ground truth where the API's child_comment_count is unreliable as a thread filter.

_Reach for this after a sweep to find which posts are silently missing their replies._

  scrape-creators-pp-cli comments coverage bracken.design --agent

• `comments sweep` — Pull recent posts for a handle and their comments in one command, stopping cleanly at a credit budget you set.

_The one-command version of a multi-hundred-post comment-mining ritual, budget-gated._

  scrape-creators-pp-cli comments sweep bracken.design --since 7d --max-credits 200 --agent

Credit governance

• `account estimate` — Project the credit cost of a planned run against your live balance and exit non-zero if it would exhaust the budget.

_Run this before any bulk sweep so an agent never burns the balance mid-pipeline._

  scrape-creators-pp-cli account estimate --posts 950 --with-replies flat --agent

• `account budget` — See how fast you're spending API credits and how many days remain at the current pace.

_Check runway before committing to a new recurring pipeline._

  scrape-creators-pp-cli account budget --agent

Cross-platform intelligence

• `creator find` — Given one handle, see which of 12 creator platforms the creator is on with follower counts side-by-side.

_Start any collab qualification here before pulling per-platform detail._

  scrape-creators-pp-cli creator find mkbhd --agent

• `creator compare` — Compare two or more creators side-by-side on follower count, engagement rate, and content volume.

_Strip vanity follower counts out of a collab decision._

  scrape-creators-pp-cli creator compare mkbhd mrwhosetheboss --agent

• `content spikes` — Surface the videos that performed far above a creator's own baseline — the ones that actually went viral.

_Find outlier content without eyeballing hundreds of posts._

  scrape-creators-pp-cli content spikes mkbhd --platform youtube

• `trends triangulate` — Snapshot a hashtag or topic across platforms in one call to see which platform it is biggest on.

_Decide where to publish before creating the content._

  scrape-creators-pp-cli trends triangulate "matcha" --agent

Local state that compounds

• `transcripts search` — FTS5 full-text search across every platform transcript you've synced — nine resource types spanning YouTube, TikTok, Instagram, Facebook, LinkedIn, Rumble, and more.

_Search transcripts you already paid for instead of re-fetching them._

  scrape-creators-pp-cli transcripts search "pricing objection" --limit 10

• `ads monitor` — Snapshot a brand's live ads across Facebook, TikTok, Google, and LinkedIn ad libraries; on rerun, diff new ads versus ones that disappeared.

_Rerun weekly and read only the delta of a competitor's ad activity._

  scrape-creators-pp-cli ads monitor nike --agent

• `comments search` — Full-text search across every synced comment and reply, offline.

_Mine questions and complaints from comments you already pulled without spending credits._

  scrape-creators-pp-cli comments search "refund" --limit 20

• `creator track` — Append a follower snapshot per run on a chosen platform, then read the growth trajectory over time.

_Track a partner's growth on a schedule you control._

  scrape-creators-pp-cli creator track mkbhd --platform instagram

• `creator tagged` — Snapshot the posts a creator or brand is tagged in and diff new mentions on rerun.

_Weekly UGC check for a client brand without re-reading the full list._

  scrape-creators-pp-cli creator tagged bracken.design --agent

Command Reference

account — Manage account

• scrape-creators-pp-cli account list — Returns the number of API credits remaining on your Scrape Creators account.