Pp Printify

<!-- 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:

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

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.

  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.

  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.

  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.

  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.

  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.

  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.

  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:

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

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

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

Turn a reusable template and row data into deterministic product manifests before any API writes.

Proof artwork placement

printify-pp-cli placement-matrix --product-file ./examples/sample-product.json --uploads-file ./examples/sample-uploads.json --agent --select variant_id,print_area,image_id,x,y,scale,angle

Inspect only the placement columns an agent needs before publishing.