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
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/pp-tiktok-shop/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pp-tiktok-shop/
1Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a codex2Manually: put the files in place
.agents/skills/pp-tiktok-shop/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a cursor2Manually: put the files in place
.cursor/skills/pp-tiktok-shop/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mvanhorn/printing-press-library cli-skills/pp-tiktok-shop/SKILL.md2Manually: put the files in place
.github/skills/pp-tiktok-shop/SKILL.md1Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a gemini-cli2Platform CLI
gemini skills install https://github.com/mvanhorn/printing-press-library --path cli-skills/pp-tiktok-shopManually: put the files in place
.devin/skills/pp-tiktok-shop/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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