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

Printify (Print on Demand) / Printify（按需印刷）

Purpose / 用途

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

使用 printify CLI 管理店铺、商品、上传、订单以及目录查询。

Tooling / 工具

Use the installed CLI directly from PATH:

直接使用 PATH 中已安装的 CLI：

printify <subcommand> [options]

Global flags:
全局标志：

• --timeout-secs <seconds> (optional, default 30): HTTP timeout.
  • --timeout-secs <seconds>（可选，默认 30）：HTTP 超时。

Core commands:
核心命令：

• status
  （查看状态）
• authorize-url
  （获取授权链接）
• verify
  （验证连接）
• set-token (reads token from stdin)
  （设置令牌，从 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:
JSON 输出约定：

• status: parse ok, status, connect_url, disconnect_url, and reason
  • status：解析 ok、status、connect_url、disconnect_url 和 reason
• authorize-url: parse ok, authorize_url, and connect_url
  • authorize-url：解析 ok、authorize_url 和 connect_url
• verify: parse ok, action, and error
  • verify：解析 ok、action 和 error
• set-token: parse ok, status, and reason
  • set-token：解析 ok、status 和 reason
• disconnect: parse ok, action, config_path, removed
  • disconnect：解析 ok、action、config_path、removed
• parse ok, status, body, and error
  • 解析 ok、status、body 和 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.
  • 读取结果保留 Printify 的原始时间戳，并针对记录的创建/更新以及订单的生产、履约、交付或取消时间，补充语义化的 UTC 和用户本地时间形式。

Auth / 认证

First-use setup:
首次使用设置：

1. Run printify status to check connection state.
   1. 运行 printify status 检查连接状态。
2. 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.
   2. 如果未连接且返回了 connect_url，用返回的 URL 替换 <connect_url>，并原样分享这个 Markdown 链接：[Connect Printify](<connect_url>)；不要单独粘贴原始 URL。
3. If connect_url is missing, run printify authorize-url and share the returned connect_url the same way.
   3. 如果缺少 connect_url，运行 printify authorize-url，并以同样方式分享返回的 connect_url。
4. The user can generate a token at https://printify.com/app/account/api.
   4. 用户可以在 https://printify.com/app/account/api 生成令牌。
5. If the user provides a token through the CLI flow, store it only through printify set-token; do not write auth files directly.
   5. 如果用户通过 CLI 流程提供令牌，只能通过 printify set-token 存储；不要直接写认证文件。
6. Run printify verify after setup when you need to confirm the token works.
   6. 设置完成后，如需确认令牌可用，运行 printify verify。
7. Never print the access token in chat output.
   7. 绝不在聊天输出中打印访问令牌。

Operating Rules / 操作规则

1. Always check printify status before API calls. If not connected, guide the user through the auth setup above.
   1. API 调用之前必须先检查 printify status。如果未连接，引导用户完成上述认证设置。
2. List shops before performing shop-specific operations to get the correct shop_id.
   2. 在执行店铺相关操作之前先列出店铺，以获得正确的 shop_id。
3. Confirm with the user before creating, updating, or publishing products. Product deletion may proceed from a clear, unambiguous request without an additional confirmation.
   3. 创建、更新或发布商品之前与用户确认。商品删除在有清晰、无歧义的请求时可以直接执行，无需额外确认。
4. Confirm with the user before creating orders (orders may trigger charges).
   4. 创建订单之前与用户确认（订单可能触发扣款）。
5. When browsing the catalog, start with blueprints then drill into print-providers and variants.
   5. 浏览目录时，从 blueprints 开始，再深入 print-providers 和 variants。
6. On HTTP 401, tell the user their token may be expired and to generate a new one at https://printify.com/app/account/api.
   6. 遇到 HTTP 401 时，告知用户令牌可能已过期，可在 https://printify.com/app/account/api 生成新令牌。

【评论】值得注意的反差设计：创建/更新/发布商品需要确认，而删除商品反而只需"清晰、无歧义的请求"即可执行——与常见的"删除从严"直觉相反，属于把删除视为不可逆但低金钱影响的操作分级。