pp-scrape-creators

name	pp-scrape-creators
description	Every Scrape Creators endpoint across 28 platforms, plus a local store with offline transcript search, cross-platform joins, and ad-library diffing no other Scrape Creators tool ships. Trigger phrases: `find which platforms a creator is on`, `compare these creators' engagement`, `monitor a brand's ads`, `search creator transcripts for a keyword`, `track a hashtag across platforms`, `use scrape creators`, `run scrape-creators`.
author	Adrian Horning
license	Apache-2.0
argument-hint	<command> [args] | install cli|mcp
allowed-tools	Read Bash
metadata	{"openclaw":{"requires":{"bins":["scrape-creators-pp-cli"]},"install":[{"kind":"go","bins":["scrape-creators-pp-cli"],"module":"github.com/mvanhorn/printing-press-library/library/developer-tools/scrape-creators/cmd/scrape-creators-pp-cli"}]}}

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:

   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.5 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.

Scrape Creators exposes 164 read-only endpoints across TikTok, Instagram, YouTube, Facebook, LinkedIn, GitHub, Spotify, and 21 more platforms behind one API key. This CLI mirrors all of them as typed commands and MCP tools, then adds the layer the official CLI lacks: a local SQLite store with FTS5 so paid transcripts, profiles, and ad creatives become a queryable, diffable corpus. Cross-platform commands like 'creator find', 'trends triangulate', and 'ads monitor' answer questions no single endpoint can.

When to Use This CLI

Use this CLI when an agent or analyst needs on-demand public social-media data across many platforms and wants to accumulate it locally for repeat querying. It is the right choice for competitive ad monitoring, influencer discovery and vetting, transcript-corpus building for RAG, and cross-platform trend and follower tracking — anything where a local, diffable copy of paid data beats stateless per-call fetches.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to post, comment, message, or modify anything on any platform — every endpoint is read-only public-data extraction.
• Do not use it as a free data source — every request costs a Scrape Creators credit; for one-off ad-hoc reads the hosted MCP or a single curl may be cheaper than a full sync.