360 Secure SkillHub
360 安全技能中心

TikTok Shop Commerce Intelligence

封装 TikTok 带货数据接口，可查询用户带货商品、直播、视频广告列表与带货数据，并获取实时商品详情；按“快照—深挖—评估—建议”流程输出机会、风险与试点建议。通过 Python 脚本调用远程接口，需要网关地址与 API key 环境变量。

chengyu-xixihaha
chengyu-xixihaha
热度 21.52
最近更新 2026-08-24 16:33:34
分类：营销依赖：代码执行 / 第三方 API / 读写文件应用场景：市场分析 / 社交媒体 / 推荐 / 研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add influencer-commerce-intel
Metadata
name
influencer-commerce-intel
description
TikTok Shop product selection and creator commerce intelligence: sales and GMV data, goods/live/video-ad monetization signals, product details, creator commerce potential. Product research, TikTok e-commerce.

Influencer Commerce Intel

Analyze creator commerce performance and monetization potential with direct mapping to commerce endpoints.

Capability Matrix

YouTube

Capability operationId Interface Minimum input
none none none none

TikTok

Capability operationId Interface Minimum input
实时采集-商品详情 tiktok_realtime_product_detail GET /api/v1/tiktok/realtime/product/detail query.product_id, query.region
用户带货商品列表 tiktok_user_shop_goods_list GET /api/v1/tiktok/user/shop/goods/list query.unique_id
用户带货直播列表 tiktok_user_shop_live_list GET /api/v1/tiktok/user/shop/live/list query.unique_id
用户带货数据 tiktok_user_shop_sale GET /api/v1/tiktok/user/shop/sale query.unique_id
用户带货视频广告列表 tiktok_user_shop_video_ad_list GET /api/v1/tiktok/user/shop/video/ad/list query.unique_id

Instagram

Capability operationId Interface Minimum input
none none none none

Cross-platform

Capability operationId Interface Minimum input
none none none none

Quick Start

  1. Confirm commerce objective (GMV growth, product seeding, ad ROI).
  2. Use the Capability Matrix to pick commerce operationIds.
  3. Validate required query/body fields in references/request-response.md.
  4. Run calls and summarize opportunity + risk + pilot plan.

Workflow

  1. Build a commerce snapshot first (tiktok_user_shop_sale, goods/live/ad lists).
  2. Deep dive top products with tiktok_realtime_product_detail when needed.
  3. Evaluate conversion consistency, category fit, and monetization durability.
  4. Return recommendation with expected KPI and test scope.

Tooling

Execution commands:

  • List operations: python3 scripts/execute_operation.py --env-file .env list
  • Sale snapshot: python3 scripts/execute_operation.py --env-file .env call --operation tiktok_user_shop_sale --query '{"unique_id":"nike"}'
  • Goods list: python3 scripts/execute_operation.py --env-file .env call --operation tiktok_user_shop_goods_list --query '{"unique_id":"nike","page":1,"page_size":20}'

Required environment variables:

  • SCRUMBALL_BASE_URL: API gateway base URL
  • SCRUMBALL_API_KEY: unified API key
  • Optional: SCRUMBALL_AUTH_PREFIX, SCRUMBALL_TIMEOUT_SECONDS

Env loading:

  • Use --env-file .env for explicit loading.
  • Without --env-file, script auto-tries ./.env then <skill-root>/.env.

Output Contract

Always return:

  • Commerce summary: top performance signals
  • Opportunity: product/category/content opportunity
  • Risk: instability, low signal confidence, or limited sample
  • Next step: pilot recommendation and expected KPI

Failure Handling

  • If identifiers are incomplete, request unique_id first.
  • If one commerce dimension is missing, continue with available dimensions and reduce confidence.
  • If user asks broad creator discovery, hand off to lead-discovery skill.

References

  • references/api-index.md: full operation index + platform grouped index
  • references/request-response.md: request parameters + response top-level/data fields + minimal examples
  • references/operations.json: operation manifest used by scripts/execute_operation.py

Quota & Unlock (important: act on 429)

  • Free tier: a limited number of calls per day, zero-config (no key required — the skill defaults to a hosted gateway that injects the key server-side).

  • When any operation returns HTTP 429, or the response body has code=429 / contains quota_exceeded, you (the assistant) MUST immediately and clearly tell the user (do not silently retry, do not treat it as a generic error):

    Free quota exhausted. Register and get your own API key at https://data.scdata.cc/pricing, then set the environment variable SCRUMBALL_API_KEY to your key (in your host/agent environment or a local .env). You can then continue with your own quota.

  • The 429 response body usually includes apply_url and env_var fields you can quote directly.