Skill

tiktok-shop

Safe v1 TikTok Shop Seller API CLI/MCP for auth readiness, token exchange and refresh, read-only shops, orders, products, inventory search, fulfillment packages, and warehouses.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use tiktok-shop

Choose if

You operate a TikTok Shop seller account and need an agent to read orders, products, inventory, fulfillment packages, and warehouses safely — with the OAuth token-exchange and refresh handled for you. Versus the official Seller Center web UI or a raw HTTP integration, the CLI's `--compact` output, typed exit codes, and explicit Safe-v1 read-only boundary mean an agent can run unattended without risk of accidental mutation.

Avoid if

You need write operations on TikTok Shop — inventory updates, product create/ edit, returns/refunds, shipping-label printing, finance, or webhook registration. Safe v1 deliberately excludes all of these pending an idempotency/retry/operator-confirmation design. Also avoid handling the PII in orders without your own access controls — the README warns operators explicitly.

Risk Flags

  • MEDIUM auth Requires a TikTok Shop developer account and the OAuth dance (token exchange + refresh). The CLI ships auth-readiness and token-refresh commands but the upstream credentials must be provisioned by the operator.
  • HIGH scope Safe v1 deliberately excludes inventory mutation, product mutation, returns/refunds, shipping-label mutation, finance, and webhook registration — all deferred until idempotency, retry, and operator-confirmation safety are designed. Agents needing write operations on TikTok Shop will not get them here.
  • HIGH data_quality Orders, fulfillment data, buyer IDs, and returns/refunds data may contain PII. Operators are explicitly warned not to retry mutations and not to add endpoints from SDK guesses, blog posts, or copied Postman collections.
  • LOW runtime npx path requires Node.js; alternative `go install` requires Go 1.26.3+. Sandboxed runtimes without those binaries need a pre-built release.

Cost

Type: Free · Free tier: The CLI itself is free to install. Pricing of the upstream TikTok Shop Seller API is not disclosed in the README. Authentication is via TikTok Shop OAuth (token exchange + refresh handled by the CLI).

Install

Default

npx -y @mvanhorn/printing-press install tiktok-shop
# Provision TikTok Shop Seller credentials in your env first.
# The CLI handles token exchange/refresh but won't mint app credentials.
# Safe v1 is strictly read-only — no inventory/product/refund mutations.

Setup docs →

Estimated time to first success: ~20 min

Dependencies

Minimum runtime: Node.js (npx) or Go 1.26.3+ for source install

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT