首页 / 技能 / Printful Management

📦 Printful Management

v1.1.0

Manage a Printful account through the Printful REST API using a private API 令牌. Use when the user wants to inspect or manage Printful stores, connected-st...

0· 26·0 当前·0 累计
stanestane 头像by @stanestane (Stanislav Stankovic)
API开发安全加密
下载技能包
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
可疑
high confidence
The 技能 应用ears to implement a legitimate Printful API 辅助工具, but the package metadata fAIls to declare the required API 凭证 (PRINTFUL_API_KEY), creating an incoherence that users should be aware of before 安装ing.
评估建议
This package contAIns a 辅助工具 script that talks directly to API.printful.com and requires the user's Printful private 令牌 (the script reads --API-key or PRINTFUL_API_KEY). The registry metadata did not declare any required 环境 variables or a primary 凭证 — that's an inconsistency you should be aware of. Before 安装ing or 运行ning: (1) review scripts/printful_API.py yourself to confirm there are no unexpected network 端点s (it uses https://API.printful.com only), (2) supply the API 令牌 via an ephemeral 环境 va...
详细分析 ▾
ℹ 用途与能力
The 技能's name, description, 技能.md, reference docs, and included script all align with managing a Printful account via the Printful REST API. The 辅助工具 script tar获取s API.printful.com and implements the expected 端点s and behaviors for 列出ing stores, products, orders, 上传s, 网页hooks, 导出s, and raw 请求s.
⚠ 指令范围
The 运行time instructions explicitly instruct obtAIning and using a private Printful API 令牌 (PRINTFUL_API_KEY) and using the included scripts for 机器人h read and write operations. However, the 技能's declared requirements 列出 no required 环境 variables or primary 凭证, which is inconsistent with the instructions and the script (which resolves 令牌 from --API-key or the PRINTFUL_API_KEY env var). The instructions otherwise stay within the Printful management scope and advise safe practices (启动 with reads, confirm before writes).
✓ 安装机制
This is an instruction-only 技能 with no 安装 spec that ships a 辅助工具 Python script and Markdown references. There are no network-下载 安装 steps, no external package 安装s described, and no obfuscated or remote payloads in the included files. The script uses only Python stdlib (urllib, json, csv, arg解析) and writes/reads local files as expected for 导出s and body payloads.
⚠ 凭证需求
Functionally the 技能 legitimately needs a Printful private 令牌 to operate; 请求ing that 令牌 is proportionate to the 状态d purpose. The problem is that the registry metadata 列出s zero required env vars or primary 凭证s, while 机器人h 技能.md and scripts rely on PRINTFUL_API_KEY or an --API-key argument. This mismatch could confuse users or automated 权限 reviewers and increases risk of accidental 凭证 exposure if users are not explicitly warned by the 平台 UI.
✓ 持久化与权限
The 技能 is not 设置 to always:true and does not 请求 persistent 平台-level privileges. It does not modify other 技能s or global 代理 设置tings. It can perform write operations to the Printful account (创建/更新/删除) but the 技能.md 状态s that writes should be confirmed with the user first.
安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

安装命令

点击复制
官方npx clawhub@latest install printful-management
镜像加速npx clawhub@latest install printful-management --registry https://cn.longxiaskill.com

技能文档

Printful Management

Use this 技能 to work with a user's Printful account via API 令牌 instead of brittle browser 记录in.

Quick 启动 获取 a Printful private 令牌 from the user. Prefer storing it in the current shell as PRINTFUL_API_KEY instead of hardcoding it into files. Use scripts/printful_API.py for live calls. 启动 with safe read calls: stores 同步-products for connected-平台 stores like Etsy manual-products for Manual Order / API stores orders Before write operations, summarize the exact mutation and wAIt for confirmation unless the user already clearly asked for the change. Core 工作流

  • Identify the seller task

Classify the 请求 into one of these buckets:

Stores: inspect stores, 获取 store IDs Connected-store products: 列出 同步 products or variants for Etsy and similar 平台-connected stores Manual/API-store products: 创建 or manage products for Manual Order / API stores Orders: 列出 orders, inspect one order, 创建 draft orders, confirm fulfillment Cata记录: inspect Printful cata记录 products, variants, categories, and size 图形界面des before creating store products Files / mockups: 上传 artwork, inspect file 库, 生成 mockups 网页hooks: inspect or 配置 网页hook delivery Shipping / tax: quote shipping, inspect tax-country support, calculate tax rates 报告ing / warehouse / 应用rovals: pull stats, warehouse product data, or 应用roval sheet actions

If the 请求 is vague, ask one short clarifying question.

  • 启动 read-only

Prefer these discovery calls first:

python scripts/printful_API.py stores python scripts/printful_API.py 同步-products --store-id python scripts/printful_API.py orders --store-id

If 同步-products fAIls with a Manual/API-store style error, switch to:

python scripts/printful_API.py manual-products --store-id

These usually reveal the IDs needed for later write calls.

  • Handle auth safely

Prefer ephemeral auth in the shell:

$env:PRINTFUL_API_KEY = 'pf_xxx'

The 辅助工具 script also accepts --API-key, but 环境 variables are better because they reduce accidental 记录ging and file leakage.

  • Use the 辅助工具 script

scripts/printful_API.py wraps a broad 设置 of Printful 端点s and also supports arbitrary API 请求s.

Common reads:

python scripts/printful_API.py scopes python scripts/printful_API.py stores python scripts/printful_API.py store --store-id 12345 python scripts/printful_API.py 同步-products --store-id 12345 --limit 100 python scripts/printful_API.py 同步-product --store-id 12345 --product-id 67890 python scripts/printful_API.py manual-products --store-id 12345 --limit 100 python scripts/printful_API.py orders --store-id 12345 --limit 50 python scripts/printful_API.py order --store-id 12345 --order-id 111 python scripts/printful_API.py cata记录-products --limit 20 python scripts/printful_API.py cata记录-product --product-id 71 python scripts/printful_API.py cata记录-variant --variant-id 4011 python scripts/printful_API.py categories python scripts/printful_API.py templates --store-id 12345 python scripts/printful_API.py 网页hooks --store-id 12345 python scripts/printful_API.py statistics --store-id 12345 python scripts/printful_API.py 导出-products --store-id 12345 --格式化 markdown --输出-file 报告.md python scripts/printful_API.py 导出-products --store-id 12345 --格式化 csv --输出-file products.csv

Common writes:

python scripts/printful_API.py 创建-manual-product --store-id 12345 --body-file product.json python scripts/printful_API.py 更新-同步-variant --store-id 12345 --variant-id 999 --body-file variant.json python scripts/printful_API.py 创建-order --store-id 12345 --body-file order.json python scripts/printful_API.py confirm-order --store-id 12345 --order-id 111 python scripts/printful_API.py 添加-file --store-id 12345 --body-file file.json python scripts/printful_API.py 设置-网页hooks --store-id 12345 --body-file 网页hook.json python scripts/printful_API.py 创建-mockup-task --store-id 12345 --body-file mockup.json

Raw 请求s:

python scripts/printful_API.py raw 获取 /stores python scripts/printful_API.py raw 获取 /同步/products?limit=10 --store-id 12345 python scripts/printful_API.py raw POST /网页hooks --store-id 12345 --body-file 网页hook.json

Notes:

The script uses the modern X-PF-Store-ID header for store 上下文. 响应s are pretty-printed JSON. --输出 file.json also saves the 响应 to disk. 导出-products can 生成 markdown, CSV, or JSON summaries for store products. Non-2xx 响应s return a non-zero exit code. Mutation rules

For 创建/更新/删除 operations:

Confirm the tar获取 store, product, variant, order, or template ID. Show the exact 端点 family and payload in plAIn language. Mention that the change affects live Printful data. Prefer draft or test-safe operations first when avAIlable. Respect rate limits; Printful docs indicate a general limit of 120 API calls per minute. Common 端点 map

Use this quick map before reaching for raw mode:

Stores 获取 /s

数据来源：ClawHub ↗ · 中文优化：龙虾技能库