Agent skill

Pp Tiktok Shop

by mvanhorn in mvanhorn/printing-press-library

Printing Press CLI/MCP for confirmed TikTok Shop Seller APIs.

Apache-2.0Auto-check: notesBackend & APIs

Install Pp Tiktok Shop

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mvanhorn/printing-press-library pp-tiktok-shop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-skills/pp-tiktok-shop .claude/skills/pp-tiktok-shop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pp-tiktok-shop
GitHub stars
2.1k
Token cost
~2k tokens
SKILL.md length
611 words
Files
1
Skills in repo
506
Repo updated
First seen
Licence
Apache-2.0

At a glance

Printing Press CLI/MCP for confirmed TikTok Shop Seller APIs.

  • Works in 3 steps: Install via the Printing Press… → Verify: tiktok-shop-pp-cli --version → Ensure the reported install directory is…
  • Tasks that involve OAuth and OpenID Connect
  • SKILL.md covers Prerequisites: Install the CLI, Official Source Boundaries, Command Reference and Auth Setup, plus 5 more sections
  • Calls go, npx and claude; reaches open-api.tiktokglobalshop.com and auth.tiktok-shops.com; needs TIKTOK_SHOP_APP_KEY and TIKTOK_SHOP_APP_SECRET

What it does

Pp Tiktok Shop is an agent skill from mvanhorn/printing-press-library. 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.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering OAuth and OpenID Connect. It works with TikTok and Model Context Protocol. The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve OAuth and OpenID Connect

Example prompts

  • “/pp-tiktok-shop”

Requirements

  • Node.js
  • A credential in TIKTOK_SHOP_APP_KEY
  • A credential in TIKTOK_SHOP_APP_SECRET
  • Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
  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.

What it can do on your machine

Read from SKILL.md and the folder at commit d9a1696. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go
    • npx
    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • open-api.tiktokglobalshop.com
    • auth.tiktok-shops.com

    Also links to:

    • partner.tiktokshop.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TIKTOK_SHOP_APP_KEY
    • TIKTOK_SHOP_APP_SECRET
    • TIKTOK_SHOP_ACCESS_TOKEN
    • TIKTOK_SHOP_REFRESH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pp Tiktok Shop loads about 2k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 611 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvanhorn/printing-press-library at commit d9a1696, republished under its Apache-2.0 licence (© mvanhorn). 611 words, ~1,975 tokens.

Download SKILL.mdSave it as .claude/skills/pp-tiktok-shop/SKILL.md (or your agent's skills folder).
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.
allowed-tools
Read, Bash
author
Cathryn Lavery
license
Apache-2.0
argument-hint
<command> [args] | install cli|mcp
<!-- 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:

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.
Show full SKILL.md (217 more words)Show less

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

CodeMeaning
0Success, including intentional deferred placeholder output
1Unclassified error
2Usage error
4Authentication/config material missing
5Upstream API error
7Rate limited
10Config 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.

© mvanhorn, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-skills/pp-tiktok-shop of mvanhorn/printing-press-library.

Open the folder on GitHubat commit d9a1696

Compare with similar skills

Pp Tiktok Shop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pp Tiktok Shop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pp Tiktok Shop this skillmvanhorn/printing-press-library2.1k—~2kAutomated safety check: NotesApache-2.0
Xquik MCPXquik-dev/x-twitter-scraper2111 repos~997Automated safety check: PassMIT
Passport Developmenttrypostit/trypost692—~1.9kAutomated safety check: PassMIT
Neo4j Aura Agent Skillneo4j-contrib/neo4j-skills114—~4.4kAutomated safety check: NotesMIT
Frontmcp Auth UIagentfront/frontmcp146—~3.7kAutomated safety check: PassApache-2.0
Entra Agent Idmicrosoft/GitHub-Copilot-for-Azure2552 repos~4kAutomated safety check: PassMIT

Similar skills

  • Xquik MCP

    Xquik-dev/x-twitter-scraper

    Connect, verify, and troubleshoot Xquik's remote MCP server.

    211 GitHub starsUsed in 1 repo~997 tokens
    Backend & APIsAuto-check passed
  • Passport Development

    trypostit/trypost

    Develops OAuth2 API authentication with Laravel Passport. An agent skill from trypostit/trypost.

    692 GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Neo4j Aura Agent Skill

    neo4j-contrib/neo4j-skills

    Manages Neo4j Aura Agents via the v2beta1 REST API — create, list, get, update, delete, and invoke Aura agents backed by an AuraDB instance.

    114 GitHub stars~4.4k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Frontmcp Auth UI

    agentfront/frontmcp

    A skill your agent uses when customizing, branding, or replacing the built-in FrontMCP OAuth pages (the login, consent, federated-select, incremental-authorization, and error pages) with your own…

    146 GitHub stars~3.7k tokensUpdated today
    Backend & APIsAuto-check passed
  • Entra Agent Id

    microsoft/GitHub-Copilot-for-Azure

    Official

    Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…

    255 GitHub starsUsed in 2 repos~4k tokens
    Backend & APIsAuto-check passed
  • MCP Dart Streamable HTTP

    leehack/mcp_dart

    A skill your agent uses when serving an MCP server over HTTP with mcpdart or connecting to a remote one: StreamableMcpServer setup, Host and Origin allowlists (DNS rebinding protection), CORS for…

    116 GitHub stars~2k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed

More from mvanhorn/printing-press-library

All 506 skills in this repo
  • Agent Desktop

    mvanhorn/printing-press-library

    Desktop automation through the real Rust agent-desktop CLI, published in Printing Press through a small bridge.

    2.1k GitHub stars~2.3k tokensUpdated today
    Auto-check: notes
  • Gfonts

    mvanhorn/printing-press-library

    Search, browse, and download Google Fonts from the terminal via the gfonts CLI.

    2.1k GitHub stars~574 tokensUpdated today
    Auto-check passed
  • Pp 1688

    mvanhorn/printing-press-library

    The free, offline Trigger phrases: search 1688 for, find a factory on 1688 for, wholesale price on 1688 for, who is the cheapest supplier on 1688 for, compare 1688 suppliers for, use 1688, run 1688.

    2.1k GitHub stars~3k tokensUpdated today
    Auto-check: notes
  • Pp Activity Japan

    mvanhorn/printing-press-library

    Inspect known Activity Japan plan IDs or URLs, compare dated prices and sessions, check language-sitemap coverage, and hand off to canonical booking pages.

    2.1k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Pp Adminbyrequest

    mvanhorn/printing-press-library

    Every Admin By Request portal action, plus a local SQLite mirror of audit, events, inventory and requests for ad-hoc...

    2.1k GitHub stars~3.3k tokensUpdated today
    Auto-check: notes
  • Pp Agent Capture

    mvanhorn/printing-press-library

    macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.

    2.1k GitHub stars~1.6k tokensUpdated today
    Auto-check: notes

Categories

Questions about Pp Tiktok Shop

What does Pp Tiktok Shop do?

Printing Press CLI/MCP for confirmed TikTok Shop Seller APIs. Pp Tiktok Shop is an agent skill from mvanhorn/printing-press-library. Printing Press CLI/MCP for confirmed TikTok Shop Seller APIs.

When should I use Pp Tiktok Shop?

Pp Tiktok Shop fits situations like: tasks that involve OAuth and OpenID Connect.

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`. Or copy the skill folder (cli-skills/pp-tiktok-shop in mvanhorn/printing-press-library) into .claude/skills/pp-tiktok-shop in your project. Claude Code loads it when a task matches its description.

How do I install Pp Tiktok Shop in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a codex`. Or copy the skill folder (cli-skills/pp-tiktok-shop in mvanhorn/printing-press-library) into .agents/skills/pp-tiktok-shop in your project. Codex loads it when a task matches its description.

Can I use Pp Tiktok Shop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvanhorn/printing-press-library --skill pp-tiktok-shop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-tiktok-shop, .gemini/skills/pp-tiktok-shop, .github/skills/pp-tiktok-shop and .opencode/skills/pp-tiktok-shop in your project.

What does Pp Tiktok Shop need to run?

Going by SKILL.md and its folder, Pp Tiktok Shop needs the command-line tools its instructions call (go, npx and claude) and credentials named TIKTOK_SHOP_APP_KEY, TIKTOK_SHOP_APP_SECRET, TIKTOK_SHOP_ACCESS_TOKEN and TIKTOK_SHOP_REFRESH_TOKEN. Our summary lists: Node.js; A credential in TIKTOK_SHOP_APP_KEY; A credential in TIKTOK_SHOP_APP_SECRET. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp Tiktok Shop access the network?

SKILL.md names 3 domains. In commands or code: open-api.tiktokglobalshop.com and auth.tiktok-shops.com; the agent is likely to contact these when it follows the instructions. As links in the text: partner.tiktokshop.com. This is read from the text; nothing was executed.

Is Pp Tiktok Shop safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp Tiktok Shop use?

Pp Tiktok Shop is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp Tiktok Shop use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pp Tiktok Shop?

Skills that share tags, products or a category with Pp Tiktok Shop: Xquik MCP (Xquik-dev/x-twitter-scraper, 211 stars), Passport Development (trypostit/trypost, 692 stars), Neo4j Aura Agent Skill (neo4j-contrib/neo4j-skills, 114 stars) and Frontmcp Auth UI (agentfront/frontmcp, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Tiktok Shop?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,056 GitHub stars. The repository holds 506 skills in this directory. The repository was last updated on October 9, 2026.

Source: mvanhorn/printing-press-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.