pp-printify

What this skill does

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

# Printify — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `printify-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 printify --cli-only
   ```
2. Verify: `printify-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/commerce/printify/cmd/printify-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 for Printify product automation that needs more than raw endpoint calls: image uploads, manifest-driven drafts, personalization field checks, placement proofing, and operational audits. It is especially useful for agents building or verifying POD product batches from local artwork and CSV inputs.

## Unique Capabilities

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

### Product proofing
- **`personalization-audit`** — Audit a product for documented personalization placeholder fields, missing text/image setup, and unsupported browser-only gaps.

  _Use this before publishing a personalized product or before handing a manifest to another agent._

  ```bash
  printify-pp-cli personalization-audit --product-file ./examples/sample-product.json --agent
  ```
- **`placement-matrix`** — Show variant, print-area, placeholder, uploaded image, x/y/scale/angle, and missing-placement rows for a product.

  _Use this when an agent must prove artwork placement is consistent across variants._

  ```bash
  printify-pp-cli placement-matrix --product-file ./examples/sample-product.json --uploads-file ./examples/sample-uploads.json --agent
  ```
- **`product-drift`** — Compare an intended product manifest against the current Printify product payload after create or update.

  _Use this after automation creates a product and before trusting the resulting listing._

  ```bash
  printify-pp-cli product-drift --product-file ./examples/current-product.json --manifest ./examples/sample-product.json --agent
  ```

### Catalog decisions
- **`catalog-margin-matrix`** — Join catalog variants and shipping data to estimate per-variant cost and margin at a target retail price.

  _Use this before creating a batch when product economics matter more than raw catalog browsing._

  ```bash
  printify-pp-cli catalog-margin-matrix --variants-file ./examples/sample-variants.json --shipping-file ./examples/sample-shipping.json --target-price 24.99 --agent
  ```

### Batch automation
- **`personalization-batch`** — Expand a reusable product manifest and CSV rows into per-product manifests using documented image and text placeholder fields.

  _Use this when an agent needs repeatable personalized product drafts before making API writes._

  ```bash
  printify-pp-cli personalization-batch --template ./examples/template-product.json --csv ./examples/personalization.csv --out ./examples/generated-manifests --agent
  ```

### Operational audits
- **`asset-reuse`** — List uploaded images, where each is used, unused uploads, and products sharing the same artwork.

  _Use this to clean upload libraries or verify that a product batch reuses the expected artwork._

  ```bash
  printify-pp-cli asset-reuse --products-file ./examples/sample-products.json --uploads-file ./examples/sample-uploads.json --agent
  ```
- **`fulfillment-risk`** — Flag open orders tied to risky product, variant, publish, or shipment states.

  _Use this when an agent needs to find fulfillment problems before customer-service work starts._

  ```bash
  printify-pp-cli fulfillment-risk --orders-file ./examples/sample-orders.json --products-file ./examples/sample-products.json --agent
  ```

## Command Reference

**catalog** — Browse the Printify catalog including blueprints, print providers, product variants, and shipping information. Explore available products and their customization options.

- `printify-pp-cli catalog retrieve-alist-of-all-print-providers-that-fulfill-orders-for-aspecific-blueprint` — Retrieve a list of all print providers that fulfill orders for a specific blueprint
- `printify-pp-cli catalog retrieve-alist-of-available-print-providers` — Retrieves the list of blueprints in the catalog to explore from
- `printify-pp-cli catalog retrieve-alist-of-variants-of-ablueprint-from-aspecific-print-provider` — Retrieves the list of of variants options for the Print Provider and Blueprint.
- `printify-pp-cli catalog retrieve-aspecific-blueprint` — Retrieves the list of blueprints in the catalog to explore from
- `printify-pp-cli catalog retrieve-aspecific-print-provider` — Retrieves the list of blueprints in the catalog to explore from
- `printify-pp-cli catalog retrieve-available-shipping-list-information` — Retrieves the list of print providers avilable for the Blueprint
- `printify-pp-cli catalog retrieve-economy-shipping-method-information` — Retrieves the list of print providers available for the Blueprint
- `printify-pp-cli catalog retrieve-express-shipping-method-information` — Retrieves the list of print providers available for the Blueprint
- `printify-pp-cli catalog retrieve-priority-shipping-method-information` — Retrieves the list of print providers available for the Blueprint
- `printify-pp-cli catalog retrieve-shipping-information` — Retrieves the list of print providers avilable for the Blueprint
- `printify-pp-cli catalog retrieve-specific-shipping-method-information` — Retrieves the list of print providers avilable for the Blueprint
- `printify-pp-cli catalog retrieves-list-of-blueprints-in-the` — Retrieves the list of blueprints in the catalog to explore from

**shops** — Manage Printify shops and shop connections. Retrieve shop information and disconnect shops from your account.


**shops-json** — Manage shops json

- `printify-pp-cli shops-json` — This will return the list of available merchant shops (IDs and titles)

**uploads** — Upload and manage images and assets. Upload images from URLs or base64-encoded content, retrieve upload information, and archive uploaded images.

- `printify-pp-cli uploads an-image` — Upload an image
- `printify-pp-cli uploads retrieve-an-uploaded-image-by-id` — Retrieve an uploaded image by id

**uploads-json** — Manage uploads json

- `printify-pp-cli uploads-json` — Retrieve a list of uploaded images


### Finding the right command

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

```bash
printify-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 a shop with narrow output

```bash
printify-pp-cli shops-json --agent --select id,title
```

Use this first so follow-up product and order commands target the right shop without dumping the full shop payload.

### Compile personalized product manifests

```bash
printif