Agent Skills › win4r/MuseAI-Skills › printify

printify

GitHub

通过 CLI 管理 Printify 代印服务，涵盖店铺、商品上下架、订单处理及目录查询。包含认证配置与操作规范，用于自动化电商履约流程。

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

触发场景

需要创建或管理 Printify 店铺和商品查询产品目录或变体信息创建、查看或取消订单检查 Printify API 连接状态

安装

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

更多选项

非标准路径

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

不安装直接使用

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.