pp-tiktok-shop — скилл для Claude Code: что делает и как установить
Скилл pp-tiktok-shop подключает команды TikTok Shop для авторизации, магазинов, заказов, товаров, остатков и отгрузок. Подходит для работы через CLI и MCP.
Apache-2.0 130 установок ★ 2 142 обновлён 2026-10-24
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-codeЧто делает pp-tiktok-shop
pp-tiktok-shop управляет CLI tiktok-shop-pp-cli и проверяет готовность авторизации, обменивает и обновляет токены, показывает магазины, товары, заказы, остатки, склады и посылки. Ответы команд могут содержать персональные данные покупателей и заказов.
Для подключения нужны значения из официальных процессов TikTok Shop Partner Center: ключ приложения, секрет, токены и идентификатор магазина. Команды чтения и операции с токенами выполняются, а изменение остатков отложено. Без установленного tiktok-shop-pp-cli скилл не выполнит команды.
Какие задачи решает
- проверить готовность авторизации TikTok Shop
- обменять код Partner Center на токены
- найти заказы и получить детали заказа
- проверить товары и остатки по SKU
- посмотреть склады и посылки
Примеры запросов агенту
- Проверь авторизацию TikTok Shop и выведи результат в JSON через
tiktok-shop-pp-cli doctor --json. - Найди заказы магазина и покажи детали заказа с идентификатором
<order-id>. - Проверь остатки товара через
tiktok-shop-pp-cli inventory list --product-id <id>.
Как установить pp-tiktok-shop
1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-code2Вручную: положить файлы
~/.claude/skills/pp-tiktok-shop/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pp-tiktok-shop/
1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a codex2Вручную: положить файлы
.agents/skills/pp-tiktok-shop/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a cursor2Вручную: положить файлы
.cursor/skills/pp-tiktok-shop/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mvanhorn/printing-press-library cli-skills/pp-tiktok-shop/SKILL.md2Вручную: положить файлы
.github/skills/pp-tiktok-shop/SKILL.md1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a gemini-cli2Командой платформы
gemini skills install https://github.com/mvanhorn/printing-press-library --path cli-skills/pp-tiktok-shopВручную: положить файлы
.devin/skills/pp-tiktok-shop/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о pp-tiktok-shop
Как установить pp-tiktok-shop в Claude Code?
Выполните npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a claude-code, затем проверьте файл ~/.claude/skills/pp-tiktok-shop/SKILL.md.
Что делает pp-tiktok-shop?
Скилл вызывает CLI для проверки авторизации, работы с токенами и чтения данных TikTok Shop: магазинов, заказов, товаров, остатков, складов и посылок.
Можно ли через него изменить остатки?
Команда tiktok-shop-pp-cli inventory update отложена. Текущий вариант выполняет команды чтения и операции с токенами.
Исходный текст
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