Supply Chain Optimization Tiktok

Supply Chain Bottleneck Analyzer for TikTok Shop sellers. Diagnose cash flow, inventory turnover, affiliate commissions, and return rates. Includes FBT cost...

Security Scan

The skill mostly contains a local calculator for TikTok Shop metrics, but its documentation suggests installing an external npm package and lists TikTok API credentials (which the skill does not declare as required) — the origin is unknown, so proceed cautiously.

Purpose & Capability

The name/description match the included calculator code: both focus on supply-chain metrics for TikTok Shop. The SKILL.md documents optional TikTok API integration (shows env var names) but the skill metadata does not require any credentials; that is plausible for a tool that can run in 'manual input' mode, but it is an inconsistency worth noting because the docs imply capability that may only work if you run external code or provide credentials.

Instruction Scope

SKILL.md stays on-topic (metrics, benchmarks, inputs). It does reference TikTok API endpoints and example env vars, but the runtime instructions do not direct the agent to read unrelated system files or exfiltrate data. However, the docs instruct users to run an npx command to add 'nexscope-ai/eCommerce-Skills', which would fetch external code; that step is outside this skill bundle and could implicitly expand what runs on the host.

Install Mechanism

There is no explicit install spec in the bundle (instruction-only), and the included scripts/calculator.py appears to be local calculation code with no obvious network calls in the visible portion. The SKILL.md's suggested npx install command (npx skills add nexscope-ai/eCommerce-Skills) would pull code from npm when executed by a user — that's a separate risk to review before running.

Credentials

The skill metadata requires no environment variables or credentials, which aligns with a manual/calculator mode. SKILL.md, however, shows example TikTok credentials (TIKTOK_APP_KEY, TIKTOK_APP_SECRET, TIKTOK_ACCESS_TOKEN) for API integration; requiring such credentials would be expected only if you actually connect to TikTok. Because the bundle doesn't declare or automatically use them, be careful not to paste credentials into unknown or external installers.

Persistence & Privilege

The skill does not request always:true, does not claim to modify other skills, and there is no install spec that writes to system locations. It appears to run as-needed without elevated persistence.

What to consider before installing

This skill appears to be a local calculator for TikTok Shop metrics (the included Python script does calculation work), but the README suggests installing an external npm package and shows TikTok API credentials as optional inputs. Before installing or running anything: 1) Verify the publisher/source for 'nexscope-ai/eCommerce-Skills' — don't run the npx command unless you trust that package. 2) Inspect the full scripts/calculator.py and any code pulled by the npx package for network calls, credential use, or unexpected behavior. 3) Never paste TikTok (or other) API keys into a tool unless you trust its code and origin; consider using test/limited-permission keys. 4) Run the code in a sandbox or isolated environment first. If you want, provide the full (untruncated) calculator.py or confirm whether this skill will ever call out to remote APIs automatically — that would change the assessment.

Supply Chain Optimization — TikTok Shop 📦

Supply chain bottleneck analyzer for TikTok Shop sellers. Diagnose cash flow, inventory, affiliate costs, and return rates.

Installation

npx skills add nexscope-ai/eCommerce-Skills --skill supply-chain-optimization-tiktok -g

Platform Characteristics

Feature	TikTok Shop	vs Amazon
Fulfillment	FBT / Self-ship	FBA
Commission	2-8% (category) + 2% transaction	8-15%
Payment cycle	7-15 days	14 days
Traffic source	Content-driven	Search-driven
Return rate	Higher (impulse buying)	Medium

Cost Structure (TikTok Shop)

Selling Price $XX
├── Product Cost
├── Inbound Shipping
├── FBT Fulfillment / Self-ship
├── Platform Fee (2%)
├── Referral Fee (2-8%)
├── Affiliate Commission (10-30%)  ← TikTok-specific
├── Advertising (Spark Ads)
└── Net Profit

Benchmark Configuration

BENCHMARKS = {
    "tiktok": {
        "gross_margin": {
            "healthy": 0.45,    # Need to cover affiliate commission
            "warning": 0.35,
            "danger": 0.25
        },
        "shipping_ratio": {
            "healthy": 0.05,
            "warning": 0.08,
            "danger": 0.12
        },
        "inventory_days": {
            "healthy": 30,      # TikTok viral cycle is short
            "warning": 45,
            "danger": 60
        },
        "cash_cycle": {
            "healthy": 60,      # Fast payment
            "warning": 90,
            "danger": 120
        },
        "net_margin": {
            "healthy": 0.15,    # After affiliate split
            "warning": 0.08,
            "danger": 0.03
        },
        # TikTok-specific metrics
        "return_rate": {
            "healthy": 0.10,    # <10% healthy
            "warning": 0.20,
            "danger": 0.30
        },
        "affiliate_ratio": {
            "healthy": 0.20,    # Affiliate commission ratio
            "warning": 0.30,
            "danger": 0.40
        }
    }
}

TikTok-Specific Costs

Affiliate Commission

Livestream selling: 10-30% commission
Short video promotion: 10-25% commission
Top influencers: May require upfront fees

Return Costs

TikTok return rates typically higher than traditional e-commerce (impulse buying)
Must account for:
├── Return shipping cost
├── Product damage/loss
└── Restocking fees

Input Data

**Sales (TikTok-specific)**
• Average Selling Price: $___
• FBT Fulfillment Fee: $___/unit
• Platform Fee: 2% (fixed)
• Referral Fee: ___%
• Affiliate Commission Rate: ___% (if applicable)
• Spark Ads Spend Ratio: ___%

**Risk (TikTok-specific)**
• Return Rate: ___%
• Return Processing Cost: $___/unit

API Integration

TikTok Shop API

export TIKTOK_APP_KEY="xxx"
export TIKTOK_APP_SECRET="xxx"
export TIKTOK_ACCESS_TOKEN="xxx"

Available Data

Data	API
Orders	Order API
Products	Product API
Logistics	Logistics API
Affiliates	Affiliate API

Bottleneck Diagnosis Focus

TikTok Shop-specific bottlenecks:

1. High affiliate commission → Profit erosion
2. High return rate → Hidden costs
3. Slow inventory turnover → Short viral cycle, high stagnation risk
4. Content dependency → Unstable traffic

vs Amazon Comparison

Item	Amazon	TikTok
Commission	8-15%	4-10%
Affiliate split	None	10-30%
Payment cycle	14 days	7-15 days
Return rate	5-15%	10-30%
Traffic	Stable	Volatile
Viral cycle	Long	Short

---

Part of Nexscope AI — AI tools for e-commerce sellers.