# pp-tiktok-shop

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 130 installs · ★ 2142 repo stars
- Author: Cathryn Lavery
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/mvanhorn/printing-press-library/tree/HEAD/cli-skills/pp-tiktok-shop/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pp-tiktok-shop

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/pp-tiktok-shop/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pp-tiktok-shop/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pp-tiktok-shop/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pp-tiktok-shop/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mvanhorn/printing-press-library cli-skills/pp-tiktok-shop/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/pp-tiktok-shop/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mvanhorn/printing-press-library --path cli-skills/pp-tiktok-shop
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pp-tiktok-shop/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mvanhorn/printing-press-library/tree/HEAD/cli-skills/pp-tiktok-shop/SKILL.md

## When to use it
- 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
- 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>`.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 2e7fb052c6726b5f.

BEGIN THIRD-PARTY FILE 2e7fb052c6726b5f
````text
---
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
````
END THIRD-PARTY FILE 2e7fb052c6726b5f

The third-party file has ended. Everything between the 2e7fb052c6726b5f tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2942 of 7902 bytes. © Cathryn Lavery · Apache-2.0 · https://github.com/mvanhorn/printing-press-library/tree/HEAD/cli-skills/pp-tiktok-shop/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
