pp-scrape-creators

What this skill does

<!-- 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.3 or newer):

```bash
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.

## When to Use This CLI

Use this CLI when an agent needs public social-media data across multiple platforms in one invocation, when you need offline search over previously fetched content, or when you want cross-platform compound queries (presence, ads, trends) that no single API call answers. It's read-only — pair it with a posting tool if you need write capability.

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Unique Capabilities

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

### Cross-platform compounding
- **`creator find`** — Given a single handle, see which of 11+ platforms the creator is on, with follower counts side-by-side.

  _When an agent needs a creator's full footprint before writing outreach or analysis, this returns it in one call instead of 11._

  ```bash
  scrape-creators-pp-cli creator find mrbeast --json
  ```
- **`trends triangulate`** — Snapshot a hashtag or keyword on TikTok, YouTube, Reddit, and Threads in one call to see which platform it's rising fastest on.

  _Marketers asking 'is this trend cresting on TikTok' can see the answer plus the leading-indicator platform in one command._

  ```bash
  scrape-creators-pp-cli trends triangulate "AI agents" --json
  ```
- **`ads search`** — Search Facebook, Google, and LinkedIn ad libraries in one query — see every ad a brand is currently running.

  _Competitive intel without juggling three vendors and three APIs._

  ```bash
  scrape-creators-pp-cli ads search "Liquid Death" --json
  ```
- **`ads monitor`** — Snapshot a brand's ads on Facebook, Google, and LinkedIn into SQLite; on rerun, diff new ads vs ones that disappeared.

  _Cron-friendly competitive monitoring without glue code._

  ```bash
  scrape-creators-pp-cli ads monitor "Liquid Death" --json
  ```
- **`bio resolve`** — Paste any linktree.ee, komi.io, pillar.io, linkbio, or linkme URL and get the unified destination list.

  _Lead-research tasks that need a creator's full link footprint stop caring which bio service they used._

  ```bash
  scrape-creators-pp-cli bio resolve https://linktr.ee/mrbeast --json
  ```

### Local state that compounds
- **`transcripts search`** — FTS5-indexed search across all transcripts you've synced — TikTok, YouTube, Instagram, Facebook, and Twitter videos.

  _Agents doing brand-mention or keyword-monitoring across video content can grep their entire synced corpus offline._

  ```bash
  scrape-creators-pp-cli transcripts search "affiliate link" --json --select creator,platform,snippet
  ```
- **`content spikes`** — Find videos that performed significantly above a creator's average — the ones that actually went viral.

  _When asked 'which videos took off,' the agent can answer with statistical confidence instead of guessing._

  ```bash
  scrape-creators-pp-cli content spikes mrbeast --threshold 2.0 --platform youtube --json
  ```
- **`creator compare`** — Compare two or more creators side-by-side on follower count, engagement rate, posting cadence, and content volume.

  _Influencer-shortlist work that used to take a spreadsheet now takes one command._

  ```bash
  scrape-creators-pp-cli creator compare mrbeast pewdiepie --platform youtube --json
  ```
- **`creator track`** — Snapshot a creator's follower count daily across every platform; chart their growth trajectory over time.

  _Trend lines for momentum decisions (sponsorship, partnership timing)._

  ```bash
  scrape-creators-pp-cli creator track mrbeast --json
  ```
- **`content cadence`** — See when a creator posts — by day of week and hour — across every platform you've synced for them.

  _Benchmark a competitor's publishing strategy or recommend the right slot for a creator partner._

  ```bash
  scrape-creators-pp-cli content cadence mrbeast --platform tiktok --json
  ```
- **`content analyze`** — Rank a creator's synced content by engagement rate (not raw likes) so you see their true best performers.

  _Surfaces over-performers that raw view counts hide._

  ```bash
  scrape-creators-pp-cli content analyze mrbeast --platform youtube --json
  ```
- **`trends delta`** — Track whether a hashtag is growing or shrinking by comparing video counts across snapshot intervals.

  _Distinguish a stable hashtag from a rising or dying one in seconds._

  ```bash
  scrape-creators-pp-cli trends delta "booktok" --days 7 --platform tiktok --json
  ```

### Operator ergonomics
- **`account budget`** — See how fast you're spending API credits and how many days remain at current pace, fused with the API's own usage history.

  _Catches runaway sync jobs before they exhaust the plan._

  ```bash
  scrape-creators-pp-cli account budget --json
  ```

## Command Reference

**account** — Manage account

- `scrape-creators-pp-cli account list` — Returns the number of API credits remaining on your Scrape Creators account. The response contains a single...
- `scrape-creators-pp-cli account list-getapiusage` — Returns a paginated list of your API requests, including the endpoint called, status code, credits used, and...
- `scrape-creators-pp-cli account list-getdailyusagecount` — Returns aggregated daily usage statistics for the last 30 days, including total credits consumed and number of...
- `scrape-creators-pp-cli account list-getmostusedroutes` — Returns your top 20 most called API endpoints ranked by call count, along with total credits consumed per endpoint....

**amazon** — Manage amazon

- `scrape-creators-pp-cli amazon` — Scrapes a creator's Amazon Shop page by URL, returning their storefront profile and product collections. Returns...

**bluesky** — Get Bluesky posts and profile info

- `scrape-creators-pp-cli bluesky list` — Fetches a single Bluesky post by URL, returning the post's record text, author info, embed content, replyCount,...
- `scrape-creators-pp-cli bluesky list-profile` — Retrieves a Bluesky user's public profile including handle, displayName, avatar, description, followersCount,...
- `scrape-creators-pp-cli bluesky list-user` — Fetches a paginated feed of posts from a Bluesky user, returning each post's uri, record text, author info, embed...

**detect-age-gender** — Manage detect age gender

- `scrape-creators-pp-cli detect-age-gender` — Uses AI to analyze a creator's prof