Pp Placeit

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/marketing/placeit/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/". -->

Placeit — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the placeit-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 placeit --cli-only

2. Verify: placeit-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/marketing/placeit/cmd/placeit-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.

Placeit has no public API, no bulk search, and no offline catalog. This CLI mirrors the entire Algolia-indexed catalog into a local SQLite database, then layers on commands no Placeit tool has: rank results by actual purchase count (top), filter Printify-ready mockups for a POD pipeline (pod), assemble matched Twitch kits (kit), and cross-tabulate the catalog's tag facets (gaps). Search and browse need no login; account and saved-templates use your Placeit session.

When to Use This CLI

Use this CLI to search, filter, and analyze Placeit's template catalog programmatically: finding the best-selling or Printify-ready mockups for a product line, assembling matched streamer kits, or auditing catalog coverage across tag facets. It is ideal for print-on-demand sellers, streamers, and social-media managers who batch-produce assets and want scriptable, offline-cacheable catalog access.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to actually render or download a finished design — Placeit's render/download is a browser-only flow; use 'open' to launch the template in your browser instead.
• Do not use this CLI to edit a template's text, colors, or uploaded artwork — there is no headless editor.
• Do not use this CLI to manage billing or change a Placeit subscription.

Unique Capabilities

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

Popularity intelligence

• top — Rank matching templates by real purchase count, not opaque relevance.

  Reach for this when a seller needs the mockups that actually convert, not just the first search hits.

  placeit-pp-cli top "t-shirt" --category mockups --agent

• rank — Show a template's purchase percentile within its category and tag cohort.

  Reach for this to judge whether a specific template is a strong pick before committing to it.

  placeit-pp-cli rank 41935 --agent

Print-on-demand

• pod — Return only Printify-compatible mockups for a query with deep links for a listing pipeline.

  Reach for this when batching POD listings so you never open a mockup that isn't print-ready.

  placeit-pp-cli pod "hoodie" --agent --select stage_link,editor_link

Matched sets

• kit — Assemble a coherent streamer kit (overlay, panels, emotes, frame) and flag missing slots.

  Reach for this when a streamer rebrand needs a visually consistent set, not mismatched single assets.

  placeit-pp-cli kit "neon gaming" --agent

Taxonomy navigation

• industry-map — Map the 152-entry industry taxonomy with template counts from your synced mirror.

  Reach for this to size a niche and find the industries with the most ready-made templates.

  placeit-pp-cli industry-map "coffee shop"

Monitoring

• watch — Persist named searches and report templates newly matching since the last sync.

  Reach for this to keep a client niche fresh without re-running searches by hand every week.

  placeit-pp-cli watch run --agent

Catalog analytics

• gaps — Pivot the catalog across two tag facets to surface under-served template combinations.

  Reach for this to spot mockup coverage gaps (e.g. a device with thin on-model diversity).

  placeit-pp-cli gaps --facet device_tags --by ethnicity_tags

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Command Reference

account — Your Placeit account and subscription status (requires a logged-in session)

• placeit-pp-cli account — Show the signed-in user's account type and subscription status

bookmarks — Templates you've saved/bookmarked on Placeit (requires a logged-in session)

• placeit-pp-cli bookmarks — List the signed-in user's bookmarked templates

campaigns — Active Placeit marketing campaigns and promotions (no login required)

• placeit-pp-cli campaigns — List active Placeit campaigns and promotions

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

placeit-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Find the best-selling Printify t-shirt mockups

placeit-pp-cli pod "t-shirt" --agent --select name,stage_link,purchases

Filters to Printify-ready mockups and narrows the JSON to just the fields a listing pipeline needs.

Rank cached logos by popularity in a niche

placeit-pp-cli top "coffee shop logo" --category logos --limit 20 --agent

Orders local-mirror matches by real purchase count for agent consumption.

Audit on-model mockup diversity

placeit-pp-cli gaps --facet device_tags --by ethnicity_tags

Cross-tabulates two tag facets to reveal under-served mockup combinations.

Narrow a deeply nested template record for an agent

placeit-pp-cli template 41935 --agent --select name,category_name,stage_link,large_thumb,device_tags

Template records carry 40+ fields and 9 tag arrays; --select keeps only what the agent needs.

Watch a client niche for new templates

placeit-pp-cli watch add "halloween instagram" && placeit-pp-cli watch run --agent

Saves a named search, then reports templates newly published since the last sync.