用途:通过 tiktok-shop-pp-cli 二进制驱动 TikTok Shop 卖家 API,面向需以只读方式查询店铺、商品、订单、库存与履约数据的场景,为智能体提供安全的 JSON 上下文。
主要能力(已实现):doctor 检查配置与环境就绪,auth status 查看凭证状态,auth exchange/auth refresh 完成令牌交换与刷新(输出脱敏),shops info 列出授权店铺并获取 shop cipher;orders list/get 查询订单(含买家 PII),products list/get 查询商品,inventory list/get 查询库存,fulfillment list/get/warehouses 查询包裹与仓库;which 与 agent-context 用于能力解析和智能体上下文。
延迟项:inventory update 官方端点已确认,但安全 v1 在幂等与不重试的写入行为设计完成前不执行。
使用方式:安装 npx -y @mvanhorn/printing-press-library install tiktok-shop --cli-only,或 go install github.com/mvanhorn/printing-press-library/library/commerce/tiktok-shop/cmd/tiktok-shop-pp-cli@latest;用 tiktok-shop-pp-cli --version 验证。通过 Partner Center 获取的 APP_KEY、APP_SECRET、ACCESS_TOKEN、REFRESH_TOKEN、SHOP_CIPHER 设为环境变量,切勿硬编码密钥。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes。首次实际调用前建议先用 --dry-run 检查签名请求结构。MCP 安装:go install .../cmd/tiktok-shop-pp-mcp@latest,再执行 claude mcp add tiktok-shop-pp-mcp -- tiktok-shop-pp-mcp,MCP 暴露相同的安全只读面与 inventory_update_status 说明。
限制:订单、履约、退货与买家标识视为 PII;不得重试写操作;不得使用非官方端点或猜测的 SDK;速率限制在可访问的官方文档中不明确,未编码为数字声明。退出码包含 0 成功、1 未分类错误、2 用法错误、4 认证缺失、5 上游错误、7 限流、10 配置错误。