Agent Skills › win4r/MuseAI-Skills › printify

printify

GitHub

通过CLI管理Printify按需打印业务，涵盖店铺、商品、订单及目录查询。提供认证配置、状态检查及操作确认流程，支持自动化电商内容管理。

opt/hatch/skills/printify/SKILL.md win4r/MuseAI-Skills

Trigger Scenarios

需要浏览或搜索Printify产品目录创建、更新或删除Printify店铺商品查看或创建Printify订单初始化或验证Printify API连接

Install

npx skills add win4r/MuseAI-Skills --skill printify -g -y

More Options

Non-standard path

npx skills add https://github.com/win4r/MuseAI-Skills/tree/main/opt/hatch/skills/printify -g -y

Use without installing

npx skills use win4r/MuseAI-Skills@printify

指定 Agent (Claude Code)

npx skills add win4r/MuseAI-Skills --skill printify -a claude-code -g -y

安装 repo 全部 skill

npx skills add win4r/MuseAI-Skills --all -g -y

预览 repo 内 skill

npx skills add win4r/MuseAI-Skills --list

SKILL.md

Frontmatter

{
    "icon": "printify",
    "name": "printify",
    "metadata": {
        "includeInPrompt": false
    },
    "description": "Use Printify to browse catalog data, manage shops and products, and review or create orders."
}

Printify (Print on Demand)

Purpose

Use the printify CLI to manage shops, products, uploads, orders, and catalog lookups.

Tooling

Use the installed CLI directly from PATH:

printify <subcommand> [options]

Global flags:

--timeout-secs <seconds> (optional, default 30): HTTP timeout.

Core commands:

status
authorize-url
verify
set-token (reads token from stdin)
disconnect
shops
products --shop-id <id> [--product-id <id>]
create-product --shop-id <id> --json '<json>'
update-product --shop-id <id> --product-id <id> --json '<json>'
delete-product --shop-id <id> --product-id <id>
publish-product --shop-id <id> --product-id <id>
orders --shop-id <id> [--order-id <id>]
create-order --shop-id <id> --json '<json>'
upload --file <path>
blueprints [--blueprint-id <id>]
print-providers --blueprint-id <id>
variants --blueprint-id <id> --provider-id <id>
shipping --blueprint-id <id> --provider-id <id>

JSON output contract:

status: parse ok, status, connect_url, disconnect_url, and reason
authorize-url: parse ok, authorize_url, and connect_url
verify: parse ok, action, and error
set-token: parse ok, status, and reason
disconnect: parse ok, action, config_path, removed
parse ok, status, body, and error
Read results retain Printify's raw timestamps and add semantic UTC and user-local forms for record creation/update and order production, fulfillment, delivery, or cancellation times.

Auth

First-use setup:

Run printify status to check connection state.
If not connected and connect_url is present, replace <connect_url> with the returned URL and share exactly this Markdown link: [Connect Printify](<connect_url>); do not paste the raw URL separately.
If connect_url is missing, run printify authorize-url and share the returned connect_url the same way.
The user can generate a token at https://printify.com/app/account/api.
If the user provides a token through the CLI flow, store it only through printify set-token; do not write auth files directly.
Run printify verify after setup when you need to confirm the token works.
Never print the access token in chat output.

Operating Rules

Always check printify status before API calls. If not connected, guide the user through the auth setup above.
List shops before performing shop-specific operations to get the correct shop_id.
Confirm with the user before creating, updating, or publishing products. Product deletion may proceed from a clear, unambiguous request without an additional confirmation.
Confirm with the user before creating orders (orders may trigger charges).
When browsing the catalog, start with blueprints then drill into print-providers and variants.
On HTTP 401, tell the user their token may be expired and to generate a new one at https://printify.com/app/account/api.