Pp Creativefabrica

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

Creative Fabrica — Printing Press CLI

Prerequisites: Install the CLI

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

2. Verify: creativefabrica-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.4 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/commerce/creativefabrica/cmd/creativefabrica-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.

Creative Fabrica has no official API; its site search is powered by a public Algolia index, and this CLI queries that same index directly over plain HTTPS (no browser, no Cloudflare at runtime). It adds the filters crafters and print-on-demand sellers actually need: file format (svg/dxf/png/eps), commercial-license (POD), subscription-free, and real discount depth — plus designer profiling and a "what's new since last run" tracker. All agent-native with --json, --csv, and --select.

When to Use This CLI

Use this CLI when an agent or script needs to search, filter, or profile the Creative Fabrica design-asset catalog — finding fonts, graphics, SVG/DXF cut files, embroidery files, or POD-licensable designs by keyword, type, category, format, price, or designer. It is ideal for print-on-demand sourcing, Cricut/Silhouette project hunting, and tracking specific designers' new releases over time via the local mirror.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to download, purchase, or access files in a user's personal Creative Fabrica library or favorites — v1 is the anonymous public catalog only.
• Do not use this CLI to upload or sell products as a designer.
• Do not use this CLI for Creative Fabrica's AI Studio generation tools.
• Do not use this CLI to redeem the curated 24-hour daily-gifts — it surfaces the permanent free-item catalog, not the daily timed freebies.

Unique Capabilities

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

Filters the web UI doesn't have

• find — Narrow craft results to a specific cut/print file format (SVG, DXF, PNG, EPS, PES) that Creative Fabrica has no facet for.

  Reach for this when a crafter needs a machine-ready format the web UI can't filter on.

  creativefabrica-pp-cli find "mandala" --format svg,dxf --agent

• find — Keep only assets usable outside an active subscription.

  Use this when you need standalone-licensable assets, distinct from free or POD.

  creativefabrica-pp-cli find "valentine svg" --no-subscription --agent

Local synthesis

• deals — Rank on-sale items by their actual regular-to-sale price drop, not just whether they are flagged on sale.

  Use this to surface the deepest genuine discounts instead of discount-theater.

  creativefabrica-pp-cli deals "font bundle" --agent

• designer-stats — Profile a designer's catalog: product-type mix, price band, free count, POD count, and newest release. Counts use Algolia facets (catalog-wide) when available; price/newest are labeled as a sample when the catalog is larger than the scanned window.

  Pick this when you need a one-shot read on a creator instead of scrolling their page.

  creativefabrica-pp-cli designer-stats "DigiArt" --agent --max-scan-pages 5

• designer-compare — Compare two designers head-to-head: catalog size, type mix, price band, free/POD share, and popularity. Free/POD/sale counts are from the scanned sample.

  Use this for competitor research when sourcing or scouting creators.

  creativefabrica-pp-cli designer-compare "DigiArt" "CraftLab" --agent

Local state that compounds

• new-since — Show only catalog items added since your last sync for a tracked query or designer.

  Reach for this to track fresh drops without re-scanning the whole catalog.

  creativefabrica-pp-cli new-since "watercolor flowers" --agent

• tags — Show the top tags and categories that co-occur with a query, to refine the next search.

  Use this to discover better refinement terms before a deep search.

  creativefabrica-pp-cli tags "christmas" --agent

Command Reference

products — Search and browse the Creative Fabrica catalog (Algolia)

• creativefabrica-pp-cli products — Low-level Algolia multi-query passthrough (prefer the top-level search/browse/free/pod commands)
• creativefabrica-pp-cli products --requests '[{"indexName":"prod_Productsv2","query":"svg"}]' — Optional JSON array (or {"requests":[...]}) of Algolia query objects

Finding the right command

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

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