mcpField
T
topview-tiktok-shop-ops

topview-tiktok-shop-ops

github.com/topviewaiMarketing & growth41100 installsUpdated 14w ago
Repository

About topview-tiktok-shop-ops

A skill for using TikTok Shop data through the host's unified `topview-mcp` server. It guides agents through deferred tool discovery and calls, while setting rules for concise findings and missing inputs.

Key features

  1. 01Use deferred TikTok data tools
  2. 02Discover tool schemas progressively
  3. 03Route requests to TikTok tools
  4. 04Ask for missing region or product details
  5. 05Avoid inventing private ad metrics
  6. 06Hand off media production to `topview-generate`

Use cases

  1. 01Reviewing TikTok market or item data
  2. 02Researching creators, videos, or livestreams
  3. 03Clarifying a request missing region or category
  4. 04Routing video or image production requests

MCP support

Uses the host's unified `topview-mcp` server. TikTok tools are deferred and accessed through progressive disclosure using `get_tool_schema` and `call_tool`.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/topviewai/skill --skill topview-tiktok-shop-ops

After installing, type/topview-tiktok-shop-opsin Claude Code to confirm it loaded.

Bundled filesreferences/tool_routing.md

Details

From the project README

Topview TikTok Shop Ops

TikTok Shop data via the host's unified topview-mcp server (progressive disclosure; domain tiktok; deferred td_* tools).

Step 0 — Bootstrap

  1. Confirm MCP server topview-mcp is connected (look for use_tiktok_data, get_tool_schema, call_tool). Do not expect td_* as top-level tools/list entries.
  2. If missing, point the user to mcp.example.json → ~/.cursor/mcp.json, reload MCP.
  3. Do not run scripts/mcp_call.py, open SSE yourself, or use curl/raw HTTP.

Execution

Server: topview-mcp (unified). Never open SSE yourself.

TikTok data tools are deferred. Invoke via progressive disclosure:

  1. Read the use_tiktok_data description on tools/list (embedded Tools catalog). Calling use_tiktok_data only to list tools is optional.
  2. Pick a deferred td_* name from the catalog or references/tool_routing.md.
  3. get_tool_schema with { "name": "<td_*>", "domain": "tiktok" }.
  4. call_tool with { "name": "<td_*>", "domain": "tiktok", "arguments": { "req": { ... } } } (confirm shape with schema).

Typical host tool ids: mcp__topview-mcp__get_tool_schema / mcp__topview-mcp__call_tool.
Prefer td_* for market/item/creator/video/live intelligence. Do not use use_amazon_data / Amazon deferred names for TikTok intents.

UX Rules

  1. Be concise; lead with actionable findings.
  2. Ask for region / category / product identifiers when missing.
  3. Do not invent private shop-backend ads metrics.
  4. For video/image/avatar production, chain to topview-generate.
  5. Match the user's language.

Source

Adapted from Marketing Studio TikTok Shop expert skills (V030) + topview-mcp.

Comments

Markdown supported