Skip to main content
skill CX Codex

pp-tiktok-shop — Claude Code skill: what it does, how to install

The pp-tiktok-shop skill connects Claude Code to TikTok Shop commands for auth, shops, orders, products, inventory, and fulfillment data through the CLI and MCP.

Apache-2.0 130 installs ★ 2,142 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-code
Open on GitHub

What pp-tiktok-shop does

pp-tiktok-shop drives tiktok-shop-pp-cli. It checks auth readiness, exchanges and refreshes tokens, and reads shops, orders, products, inventory, warehouses, and fulfillment packages. Order and buyer responses can contain personal data.

Setup uses values obtained through official TikTok Shop Partner Center flows, including app credentials, tokens, and the shop selector. Read commands and token operations are available, while inventory changes are deferred. The skill cannot run its commands without the tiktok-shop-pp-cli binary.

What it helps with

  • check TikTok Shop auth readiness
  • exchange a Partner Center code for tokens
  • search orders and inspect order details
  • review product and SKU inventory
  • list warehouses and fulfillment packages

Example prompts for the agent

  • Check TikTok Shop authentication and return JSON with tiktok-shop-pp-cli doctor --json.
  • Search the shop’s orders, then inspect the order with ID <order-id>.
  • Look up inventory with tiktok-shop-pp-cli inventory list --product-id <id>.

How to install pp-tiktok-shop

1Skills CLI (Vercel)

npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-code

2Manually: put the files in place

~/.claude/skills/pp-tiktok-shop/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pp-tiktok-shop/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pp-tiktok-shop

How do I install pp-tiktok-shop in Claude Code?

Run npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-code, then verify ~/.claude/skills/pp-tiktok-shop/SKILL.md.

What does pp-tiktok-shop do?

It uses the CLI to check authentication, handle token operations, and read TikTok Shop data for shops, orders, products, inventory, warehouses, and fulfillment packages.

Can pp-tiktok-shop update inventory?

The tiktok-shop-pp-cli inventory update command is deferred. The current implementation handles read operations and token calls.

Source text

SKILL.md · Apache-2.0
---
name: pp-tiktok-shop
description: "Printing Press CLI/MCP for confirmed TikTok Shop Seller APIs. Safe v1 supports auth readiness, token exchange/refresh, read-only shops/orders/products/inventory/package/warehouse commands, and defers risky mutations."
author: "Cathryn Lavery"
license: "Apache-2.0"
argument-hint: "<command> [args] | install cli|mcp"
allowed-tools: "Read Bash"
metadata:
  openclaw:
    requires:
      bins:
        - tiktok-shop-pp-cli
    install:
      - kind: go
        bins: [tiktok-shop-pp-cli]
        module: github.com/mvanhorn/printing-press-library/library/commerce/tiktok-shop/cmd/tiktok-shop-pp-cli
---
<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/tiktok-shop/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# TikTok Shop - Printing Press Safe v1

## Prerequisites: Install the CLI

This skill drives the `tiktok-shop-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install tiktok-shop --cli-only
   ```
2. Verify: `tiktok-shop-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/commerce/tiktok-shop/cmd/tiktok-shop-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Official Source Boundaries

Only use official TikTok Shop Partner Center docs for API, auth, signing, scope, endpoint, and rate-limit claims:

- Seller API overview: https://partner.tiktokshop.com/docv2/page/650b1f2ff1fd3102b93c6d3d
- Authorization overview: https://partner.tiktokshop.com/docv2/page/678e3a3292b0f40314a92d75
- Authorization guide: https://partner.tiktokshop.com/docv2/page/678e3a2dbd083702fd17455c
- Signing algorithm: https://partner.tiktokshop.com/docv2/page/678e3a3d4ddec3030b238faf
- Get Authorized Shops: https://partner.tiktokshop.com/docv2/page/6507ead7b99d5302be949ba9
- Get Active Shops: https://partner.tiktokshop.com/docv2/page/650a69e24a0bb702c067291c
- Get Order List: https://partner.tiktokshop.com/docv2/page/650aa8094a0bb702c06df242
- Get Order Detail: https://partner.tiktokshop.com/docv2/page/650aa8ccc16ffe02b8f167a0
- Search Products: https://partner.tiktokshop.com/docv2/page/6503081a56e2bb0289dd6d7d
- Get Product: https://partner.tiktokshop.com/docv2/page/6509d85b4a0bb702c057fdda
- Inventory Search: https://partner.tiktokshop.com/docv2/page/650a9191c16ffe02b8eec161
- Update Inventory, deferred: https://partner.tiktokshop.com/docv2/page/6503068fc20ad60284b38858
- Get Warehouse List: https://partner.tiktokshop.com/docv2/page/650aa418defece02be6e66b6
- Search Package: https://partner.tiktokshop.com/docv2/page/650aa592bace3e02b75db748
- Get Package Detail: https://partner.tiktokshop.com/docv2/page/650aa39fbace3e02b75d8617

Rate limits remain unclear in accessible official docs and are not encoded as numeric claims.

## Command Reference

Implemented:

- `tiktok-shop-pp-cli doctor` - Check config, env, auth readiness, and official-doc basis without sending a live probe.
- `tiktok-shop-pp-cli auth status` - Show whether app credentials, tokens, and shop selector are configured without revealing secrets.
- `tiktok-shop-pp-cli auth exchange --auth-code <code>` - Exchange a Partner Center authorization code for tokens; output redacts tokens.
- `tiktok-shop-pp-cli auth refresh` - Refresh an access token; output redacts tokens.
- `tiktok-shop-pp-cli shops info` - List shops authorized for this app/token and retrieve shop cipher.
- `tiktok-shop-pp-cli orders list` - Search orders; response contains buyer/order PII.
- `tiktok-shop-pp-cli orders get <order-id>` - Get order detail; response contains buyer/order PII.
- `tiktok-shop-pp-cli products list` - Search products/listings.
- `tiktok-shop-pp-cli products get <product-id>` - Get product detail.
- `tiktok-shop-pp-cli inventory list --product-id <id>` or `--sku-id <id>` - Search inventory.
- `tiktok-shop-pp-cli inventory get <sku-id>` - Get inventory for one SKU.
- `tiktok-shop-pp-cli fulfillment list` - Search fulfillment packages; response may contain fulfillment PII.
- `tiktok-shop-pp-cli fulfillment get <package-id>` - Get package detail.
- `tiktok-shop-pp-cli fulfillment warehouses` - List seller warehouses.
- `tiktok-shop-pp-cli which [query]` - Resolve capabilities to commands.
- `tiktok-shop-pp-cli agent-context` - Emit JSON context for agents.

Deferred:

- `tiktok-shop-pp-cli inventory update` - Official endpoint is confirmed, but safe v1 defers execution until idempotency and no-retry mutation behavior are designed.

## Auth Setup

Set values obtained through official TikTok Shop Partner Center flows. Never hardcode secrets.

```bash
export TIKTOK_SHOP_APP_KEY="<from Partner Center>"
export TIKTOK_SHOP_APP_SECRET="<from Partner Center>"
export TIKTOK_SHOP_ACCESS_TOKEN="<from official token exchange>"
export TIKTOK_SHOP_REFRESH_TOKEN="<from official token exchange>"
export TIKTOK_SHOP_SHOP_CIPHER="<from shops info>"
```

Optional overrides:

```bash
export TIKTOK_SHOP_CONFIG="$HOME/.config/tiktok-shop-pp-cli/config.toml"
export TIKTOK_SHOP_BASE_URL="https://open-api.tiktokglobalshop.com"
export TIKTOK_SHOP_AUTH_BASE_URL="https://auth.tiktok-shops.com"
```

Run:

```bash
tiktok-shop-pp-cli doctor --json
```

Token exchange/refresh do not print token values. Add `--save` only when you intentionally want the returned token bundle persisted to `~/.config/tiktok-shop-pp-cli/config.toml` with `0600` permissions.

## Agent Mode

Add `--agent` to any command. It expands to `--json --compact --no-input --no-color --yes`.

Agent-safe examples:

```bash
tiktok-shop-pp-cli doctor --agent
tiktok-shop-pp-cli shops info --agent --dry-run
tiktok-shop-pp-cli which --agent
tiktok-shop-pp-cli inventory update --agent
```

## Safety Rules

- Treat orders, fulfillment, returns, and buyer identifiers as PII.
- Use `shops info` to obtain `shop_cipher`; do not invent or decrypt shop ciphers.
- Use `--dry-run` before first live calls to inspect signed request shape without transmitting it.
- Do not retry mutations. Safe v1 only executes read commands and auth token calls.
- Do not use unofficial endpoints, SDK guesses, blog posts, or copied Postman collections for missing API behavior.

## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | Success, including intentional deferred placeholder output |
| 1 | Unclassified error |
| 2 | Usage error |
| 4 | Authentication/config material missing |
| 5 | Upstream API error |
| 7 | Rate limited |
| 10 | Config error |

## Argument Parsing

Parse `$ARGUMENTS`:

1. Empty, `help`, or `--help` means show `tiktok-shop-pp-cli --help`.
2. Starts with `install` and ends with `mcp` means MCP installation; otherwise CLI installation.
3. Anything else means direct use with `--agent`.
## MCP Server Installation

```bash
go install github.com/mvanhorn/printing-press-library/library/commerce/tiktok-shop/cmd/tiktok-shop-pp-mcp@latest
claude mcp add tiktok-shop-pp-mcp -- tiktok-shop-pp-mcp
```

The MCP server exposes the same safe v1 read surface and an `inventory_update_status` explainer instead of a stock mutation tool.

© Cathryn Lavery · Apache-2.0 · mvanhorn/printing-press-library

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set87

The whole set →
pp-trigger-dev pp-trigger-dev operates Trigger.dev management tasks, groups LLM span costs, and runs offline search over failed runs. Useful for triaging backend job failures directly inside your AI agent. CX Codex +1 144installs pp-facebook-marketplace pp-facebook-marketplace drives a Facebook Marketplace seller CLI to search items, watch listings, generate drafts, and reply to buyers under explicit write confirmation. CX Codex +1 141installs pp-obsidian pp-obsidian is a Claude Code skill that reads Obsidian vault statistics and metadata, including broken links, orphaned notes, tags, and tasks. It analyzes a local SQLite mirror without live Obsidian access. CX Codex +1 136installs pp-domain-goat pp-domain-goat — a Claude Code skill that checks domains through RDAP, WHOIS, and Porkbun pricing without leaving the terminal. It generates name candidates, scores them, and works out the five-year cost before you commit. CX Codex +1 135installs pp-postman-explore pp-postman-explore is a Claude Code skill that finds, compares, and tracks public Postman collections through a local CLI without authentication. CX Codex +1 128installs pp-clarity The pp-clarity skill generates and audits Microsoft Clarity browser code. Use it when adding Clarity to HTML or checking instrumentation before a release. CX Codex +1 120installs pp-podcast-goat pp-podcast-goat pulls long-form podcast transcripts formatted as speaker-labeled markdown. Works via subscriber cookies or public sources like YouTube and RSS. CX Codex +1 118installs pp-fireflies pp-fireflies — a skill for Fireflies.ai: full-text search across meetings offline, extract action items, and track talk patterns without burning API quota. Requires fireflies-pp-cli installed. CX Codex +1 117installs

Project sponsors

Companies that keep this analytics open