SuperAPI AI 工具集

printify

办公与效率

查看项目

更新于 10-26 19:14

技能介绍

用途:Printify 技能借助 printify CLI 对按需印刷业务进行管理,涵盖店铺、商品、上传文件、订单与商品目录查询等操作。

主要能力:支持查询连接状态(status)、获取授权链接(authorize-url)、验证令牌(verify)、通过标准输入设置令牌(set-token)、断开连接(disconnect);列出店铺(shops);查询、创建、更新、删除、发布商品(products、create-product、update-product、delete-product、publish-product);查询与创建订单(orders、create-order);上传文件(upload);以及目录查询,包括 blueprints、print-providers、variants 和 shipping。全局选项 --timeout-secs 用于设置 HTTP 超时,默认 30 秒。

使用方式:直接在 PATH 中调用 printify <子命令> [选项]。首次使用先运行 printify status 检查连接状态;若未连接且返回 connect_url,则以 Markdown 链接形式分享该地址引导用户连接;若缺少 connect_url,可运行 printify authorize-url 获取。用户可在 https://printify.com/app/account/api 生成令牌,令牌只能通过 printify set-token 存储,不可直接写入认证文件,且不得在对话中打印访问令牌。设置后可运行 printify verify 确认令牌有效。执行店铺相关操作前需先列出店铺以获得正确的 shop_id;浏览目录时从 blueprints 开始,再深入 print-providers 与 variants。

输出契约:各命令返回结构化 JSON,包含 parse、ok、status、connect_url、authorize_url、action、error、body、config_path、removed 等字段;读取结果保留 Printify 原始时间戳,并补充语义化的 UTC 与用户本地时间形式,覆盖记录创建/更新以及订单的生产、履约、配送或取消时间。

适用场景:适合需要以脚本或命令行方式批量维护 Printify 店铺商品、核对目录与供应商信息、查询订单状态,以及在明确授权下创建订单的按需印刷运营工作流。

限制与规则:每次 API 调用前应检查连接状态;创建、更新、发布商品及创建订单前需与用户确认(订单可能产生费用),删除商品在请求明确时可执行;遇 HTTP 401 应提示令牌可能过期并重新生成。具体费率、平台支持范围与更多细节暂未提供。