POD Benchmark

podbenchmark

在终端中比较不同供应商的同款按需打印产品：Printify、Printful、Gelato、Prodigi、CustomCat、Fourthwall 和 Inkthreadable 的产品成本、运费、到手总价和配送时间。专为卖家、开发者和 AI Agent 打造。

npx podbenchmark compare bella-canvas-3001 --size m --color black --to US

价格来自 POD Benchmark，该网站会根据你选择的目的地查询每家供应商的价格和运费。完整的交互式比较：https://podbenchmark.com。

安装

npx podbenchmark          # run without installing
npm i -g podbenchmark     # or install the `podbenchmark` command

需要 Node.js 22 或更高版本。无需其他依赖项。

查找产品、选择尺寸和颜色，然后进行比较

分为三步。每一步都会显示下一步要运行的命令。

$ podbenchmark search "bella canvas 3001"

Products for “bella canvas 3001” · 138 found · delivered to the US in USD

ID                    PRODUCT                                             FROM  SUPPLIERS
bella-canvas-3001     Bella+Canvas 3001 Unisex Jersey Short Sleeve Tee  $15.38     6 of 6
bella-canvas-3001u    Bella+Canvas 3001U USA-Made Unisex Jersey Tee     $23.54     1 of 1
bella-canvas-3001rcy  Bella+Canvas 3001RCY Unisex Recycled Organic Tee  $22.95     1 of 1
FROM is the lowest delivered price (product + shipping) for the usual size and color. Compare a specific one with `compare`.

next: npx podbenchmark options bella-canvas-3001

options 会列出产品提供的尺寸、颜色和其他选项。添加关键词或标志来缩小列表范围：

$ podbenchmark options bella-canvas-3001 m black

bella-canvas-3001 · choices for the US in USD · 5 matching combinations

size    m
color   black, black-heather, oxblood-black, solid-black-blend, vintage-black

Opens on  Adult M · Black

SIZE  COLOR              SUPPLIERS
m     black                      6
m     black-heather              4
m     oxblood-black              3
m     solid-black-blend          1
m     vintage-black              5

next: npx podbenchmark compare bella-canvas-3001 --size m --color black --to US

$ podbenchmark compare bella-canvas-3001 --size m --color black --to US

Bella+Canvas 3001 · Adult M · Black · delivered to the US in USD

SUPPLIER                      PRODUCT                   SHIPPING  PRODUCT + SHIPPING  ARRIVES   VS CHEAPEST
Gelato                        Premium Unisex Crewneck…     $4.99     $15.68  4–6 days     cheapest
Fourthwall                    Bella+Canvas Unisex Sup…     $4.29     $16.04  6–8 days       +$0.36
Printify via Printify Choice  Unisex Jersey Short Sle…     $4.95     $16.24  3–7 days       +$0.56
CustomCat                     Bella + Canvas Unisex J…     $4.99     $16.46  3–9 days       +$0.78
Printful                      Unisex Staple T-Shirt |…     $4.69     $16.61  6–9 days       +$0.93
Prodigi                       Bella+Canvas 3001           $10.75     $22.75  3–8 days       +$7.07

Product + shipping excludes duty and sales tax; duty is shown separately.
Prices checked 2026-09-30 to 2026-10-21.

Full comparison  https://podbenchmark.com/t-shirts/bella-canvas-3001?destination=US&currency=USD&configuration=size%3Dapparel%253Aadult%253Am%26color%3Dblack

网站上的每个选择器都有一个同名标志：--size、--color、--capacity、--page-count、--device-fit……（podbenchmark compare --help 会列出所有标志）。--option <key> 接受来自 options --json 的确切键值。

也可以从供应商链接开始，而不是使用 ID。CLI 会查找产品、链接中选定的颜色，并将该供应商视为你当前使用的供应商：

podbenchmark compare https://printify.com/app/products/12/bella-canvas/unisex-jersey-short-sleeve-tee

请使用产品页面本身的网址，就像从供应商目录中复制时那样；utm_… 等跟踪参数可以保留，Fourthwall 的 selectedColor 也会指定颜色。目前还无法匹配选中了其他选项的链接、编辑器链接和推荐链接路径：请打开普通产品页面并复制其网址，或使用 --current <supplier> 传入产品 ID。

其他目的地和货币：

podbenchmark compare bella-canvas-3001 --size m --color black --to GB             # prices in GBP
podbenchmark compare bella-canvas-3001 --size m --color black --to DE --currency USD

目的地：US、GB、DE、CA、AU。货币：USD、EUR、GBP、CAD、AUD。货币默认为目的地所用货币。

每笔销售的到手金额

说明你目前使用的供应商、售价和销售渠道。表格会显示扣除产品成本、运费、关税和平台费用后的到手金额，并将当前供应商列在最前面：

$ podbenchmark compare bella-canvas-3001 --size m --color black \
    --current printful --sell-for 24 --on etsy

Bella+Canvas 3001 · Adult M · Black · delivered to the US in USD
selling at $24.00 on Etsy · your supplier: Printful

SUPPLIER                      PRODUCT + SHIPPING  YOU KEEP  VS PRINTFUL
Printful (yours)                 $16.61     $4.86        yours
──────────────────────────────────────────────────────────────────────────
Gelato                           $15.68     $5.79       +$0.93  keeps most
Fourthwall                       $16.04     $5.43       +$0.57
Printify via Printify Choice     $16.24     $5.23       +$0.37
CustomCat                        $16.46     $5.01       +$0.15
Prodigi                          $22.75    -$1.28       -$6.14

You keep = $24.00 − (product + shipping) − deducted duty − $2.53 Etsy fees (Transaction fee $1.56 + Etsy Payments percentage $0.72 + Etsy Payments fixed charge $0.25). Before tax.
Etsy fees checked 2026-08-19.
Product + shipping excludes duty and sales tax; duty is shown separately.
Prices checked 2026-09-30 to 2026-10-21.

标志	含义
--current <supplier>	你目前使用的供应商：printify、printful、gelato、prodigi、customcat 或 fourthwall。
--sell-for <price>	客户购买每件商品支付的价格，以所选货币计。
--on <channel>	etsy、shopify、woocommerce 或 tiktok-shop。
--shop-in <country>	你的商店所在国家。提供价格和渠道时，默认为目的地。
--plan <plan>	base（标准价格，默认值）、tier1 或 tier2（付费套餐）。
--supplier <supplier>	仅显示该供应商，并将其每种产品和打印供应商作为额外行列出。
--similar	同时列出相似产品；由于它们并非同款空白产品，因此会单独显示。

定价

price 命令可以反向计算：输入你希望每笔销售保留的金额占比，即可查看各供应商对应的售价。

$ podbenchmark price bella-canvas-3001 --size m --color black --margin 30 --on etsy --current printful

SUPPLIER                      PRODUCT + SHIPPING   FEES  CHARGE  YOU KEEP  VS PRINTFUL
Printful (yours)                 $16.61  $2.91  $28.00     $8.48        yours
───────────────────────────────────────────────────────────────────────────────────
Gelato                           $15.68  $2.77  $26.50     $8.05       -$1.50  lowest price
Fourthwall                       $16.04  $2.82  $27.00     $8.14       -$1.00
Printify via Printify Choice     $16.24  $2.87  $27.50     $8.39       -$0.50
CustomCat                        $16.46  $2.91  $28.00     $8.63        $0.00
Prodigi                          $22.75  $3.91  $38.50    $11.84      +$10.50

Charge = the price that leaves you 30% of the sale after product + shipping, deducted duty and Etsy fees. Before tax.

供应商和指南

podbenchmark suppliers                                  # the seven suppliers compared
podbenchmark supplier printful                          # plans, fees, branding, who handles support and refunds
podbenchmark supplier printify --locations --country US # where it reports printing
podbenchmark supplier printify --providers              # a marketplace's print providers
podbenchmark supplier printify --prices --vs printful   # how many products each is cheapest for, and by how much
podbenchmark guide mugs --on etsy                       # which suppliers fit your shop, with dated reasons

guide 可接受 t-shirts、hoodies、mugs、wall-art、stickers 或 phone-cases，以及 --branding、--free-start 和 --choose-provider。supplier --prices 可接受 --category、--within 1（或 5%，用于设定接近最低价的范围）、--search 和 --plan。

此外，还有：podbenchmark categories [words]、podbenchmark product <id>（规格、打印方式、相似产品），以及在 search 中使用 --facets，统计结果中的品牌、供应商、受众和规格。使用 --category、--brand、--supplier、--for（unisex、mens、womens、kids）、--fit、--material、--eco、--neckline、--sleeve、--construction、--label、--capacity、--fabric、--weight 4-8、--priced 和 --sort cheapest|priciest|most-suppliers|name 筛选 search 结果。重复指定筛选标志即可接受多个值。

每个列表命令都支持 --limit 和 --offset。

默认值

保存你通常需要在每条命令中重复指定的内容：

podbenchmark config set --to GB --current printful --on etsy --shop-in GB
podbenchmark config show
podbenchmark config reset

优先级从高到低：标志、环境变量、已保存的配置、内置默认值。

设置	标志	环境变量
目的地	--to	PODBENCHMARK_TO
货币	--currency	PODBENCHMARK_CURRENCY
你的供应商	--current	PODBENCHMARK_CURRENT
销售渠道	--on	PODBENCHMARK_ON
店铺所在国家/地区	--shop-in	PODBENCHMARK_SHOP_IN

配置是一个小型 JSON 文件，位于 $XDG_CONFIG_HOME/podbenchmark/config.json（默认为 ~/.config/podbenchmark/config.json）。PODBENCHMARK_API_URL 可将 CLI 指向其他服务。

用于脚本和 AI Agent

在终端中运行时，输出为表格。在以下情况下，输出为 JSON，内容与服务返回的内容完全一致：

• 传入 --json，
• 标准输出不是终端（而是管道或文件），或
• 检测到 Agent 工具环境（Claude Code、Codex、Cursor、OpenCode、Gemini CLI、Amp、Augment、Qwen Code、Pi、Copilot、Warp 或 AI_AGENT=<name>）。

--table 可强制恢复表格输出。检测到 Agent 时，CLI 还会在 X-Podbenchmark-Agent 标头中发送其名称，以便统计 Agent 的使用量；它始终会发送 X-Podbenchmark-Client: cli/<version>，不会发送关于你的其他信息。

podbenchmark compare bella-canvas-3001 --size m --color black --json | jq '.suppliers[].offer | {supplier, delivered}'
podbenchmark compare bella-canvas-3001 --schema        # exact input and output fields, as JSON Schema; no request
podbenchmark compare bella-canvas-3001 --size m --dry-run   # the request that would be sent; no request

在 JSON 中，缺少的价格为 null，而不是 0。请将 null 视为未知。

教会你的 Agent

podbenchmark skills add                    # the agent you are in, else every one installed here
podbenchmark skills add --agent claude     # claude, codex, opencode, cursor or all
podbenchmark skills add --agent all --project   # write into this repository instead of your home folder

此命令会将 podbenchmark 技能（一个 SKILL.md）写入每个 Agent 的技能文件夹，并打印所有路径：

Agent	个人	使用 --project
Claude Code	~/.claude/skills/podbenchmark/	.claude/skills/podbenchmark/
Codex	~/.agents/skills/podbenchmark/	.agents/skills/podbenchmark/
OpenCode	~/.config/opencode/skills/podbenchmark/	.opencode/skills/podbenchmark/
Cursor	~/.cursor/skills/podbenchmark/	.cursor/skills/podbenchmark/

再次运行会更新该文件。除非传入 --force，否则它绝不会替换非由它写入的 SKILL.md。

没有技能文件夹？改为将以下内容粘贴到你的 Agent 中：

使用 npx podbenchmark 比较按需印刷供应商的价格。流程：使用 search <words> --json 查找产品 ID，使用 options <id> --json 查看准确的尺寸和颜色值（切勿猜测），然后运行 compare <id> --size <value> --color <value> --to <US|GB|DE|CA|AU> --json。只有在卖家明确说明时，才添加 --current <supplier> --sell-for <price> --on <etsy|shopify|woocommerce|tiktok-shop>。null 表示未知，绝不是 0。回答时请链接结果中的 product.url。--schema 会显示所有字段。

将其用作 MCP 服务

MCP 客户端也可通过可流式传输的 HTTP 使用相同的工具，地址为 https://podbenchmark.com/api/mcp，无需密钥或登录：

{
  "mcpServers": {
    "podbenchmark": {
      "type": "streamable-http",
      "url": "https://podbenchmark.com/api/mcp"
    }
  }
}

Claude Code：claude mcp add --transport http podbenchmark https://podbenchmark.com/api/mcp。Codex：codex mcp add podbenchmark --url https://podbenchmark.com/api/mcp。

退出代码

代码	含义
0	成功。价格未知时仍以 0 退出；未知价格显示为 —（在 JSON 中为 null）。
1	命令、标志或选项值无效（例如 --to FR，或产品没有提供的尺寸；错误信息会列出有效值）。
2	没有可比较的内容：产品未知、供应商链接无法匹配，或没有供应商报价。
3	无法连接服务、服务在 30 秒内未响应、服务不可用，或对你进行了速率限制（消息会说明需要等待多久）。

使用 --json（或通过管道传输）时，失败会在标准输出中以 JSON 格式打印错误（{"ok": false, "error": {"code", "message", "retryable"}}），并使用相同的退出代码。如果完全无法连接服务，代码为 network。网络错误或收到 5xx 响应时，CLI 会在短暂暂停后重试一次；对于 4xx 响应则绝不重试。

关于数字

• 价格是供应商报价，已在所示日期（Prices checked …）核实，以目的地货币计价，不含销售税。到手价 = 产品价格 + 运费。供应商收取的关税单独列出：已确定金额（包括零）、标注为估算的金额，或未经核实。利润会扣除已确定的关税或换算后的估算金额，并保留其限定说明。估算或未经核实的关税，以及有条件的设计／设置价格，不会用于确定利润最高者或差额，包括目标利润率模式。
• 没有的价格显示为 —。绝不会将其计为零，也绝不会将其视为最低价。
• Printify 是一个市场平台：每行显示其会将订单分配给的印刷供应商（“via Printify Choice”）。使用 --supplier printify 查看所有供应商。
• 供应商未列出适用于你所在目的地或尺寸的产品，不会出现在表格中。
• 利润数据依据平台费用调研及其核查日期（Etsy fees checked …）估算，且为税前金额。
• 表格仅链接到 POD Benchmark 自有页面。在 JSON 中，某项报价的 actionUrl 可能包含联盟推广标识（见 affiliateDisclosure）；这不会改变价格或排名。
• 速率限制：每个 IP 地址每分钟 120 次请求。达到限制时，CLI 会告知你需要等待多少秒。

链接

• 网站和完整比较：https://podbenchmark.com
• 此工具页面：https://podbenchmark.com/tools/cli
• 面向 AI 助手的 MCP 端点：https://podbenchmark.com/api/mcp
• 源代码：https://github.com/FilipLjubic/podbenchmark-cli
• 问题或更正：https://podbenchmark.com/about

采用 MIT 许可。