mcpField
F
finding-tiktok-shop-trending-products

finding-tiktok-shop-trending-products

github.com/apidojo-ioMarketing & growth1821 installsUpdated 24w ago
Repository

About finding-tiktok-shop-trending-products

A research skill for spotting TikTok Shop products gaining momentum from creator promotions and engagement. It groups posts by product and scores trend stage using promotion density, reach, and engagement.

Key features

  1. 01Search TikTok posts by keywords or URLs
  2. 02Group promotional posts by product
  3. 03Measure creator promotion density
  4. 04Score reach and engagement momentum
  5. 05Classify trend stages

Use cases

  1. 01Find products gaining traction in a category
  2. 02Compare creator promotion and post engagement
  3. 03Flag saturated or potentially fading trends

MCP support

Can use the Apify MCP server to run the TikTok scraper actor; CLI and REST API alternatives are also documented.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/apidojo-io/apidojo-skills --skill finding-tiktok-shop-trending-products

After installing, type/finding-tiktok-shop-trending-productsin Claude Code to confirm it loaded.

Details

From the project README

Finding TikTok Shop Trending Products

Identifies products gaining momentum on TikTok Shop by analyzing creator promotion density and engagement. A product promoted by many creators simultaneously is a strong viral commerce signal.

Prerequisites

  • APIFY_TOKEN environment variable set
  • Optional: Apify MCP server installed

Inputs

ParameterTypeRequiredDefaultNotes
startUrlsarrayOptional[]TikTok URLs — user profiles, hashtags, music pages, search, locations
keywordsarrayOptional[]Search keywords/terms to find posts
sortTypestringOptionalRELEVANCESort order for keyword results: RELEVANCE, MOST_LIKED, DATE_POSTED
locationstringOptional—ISO 3166-1 alpha-2 country code for regional filtering (e.g. US, GB)
maxItemsnumberOptionalUnlimitedMaximum posts to return across the run
includeSearchKeywordsbooleanOptionalfalseAdd the matched search keyword field to each post
customMapFunctionstringOptional—JavaScript function to transform each output object

Workflow

Progress:
- [ ] Step 1: Search TikTok Shop hashtags for category
- [ ] Step 2: Extract products from promotional posts
- [ ] Step 3: Count creator promotion density per product
- [ ] Step 4: Score product trend momentum
- [ ] Step 5: Deliver trending product list
Step 1: Search Posts

Recommended — run_actor.js (handles waiting, output, and file saving automatically):

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

APIFY_TOKEN must be set in environment or .env file.

If Apify MCP is available:

Tool: apify:run-actor
Actor: "apidojo~tiktok-scraper"
Input:
{
  "keywords": ["#tiktokshop[category]", "#[category]deals", "#tiktokmademebuyit"],
  "maxItems": 300
}

REST API fallback:

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~tiktok-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["#tiktokmademebuyit", "#skincaretiktokshop"], "maxItems": 300}'
Step 2: Score Products

Group posts by product name from captions. For each product:

promotion_density = count(unique creators promoting product)
total_reach = sum(playCount for all promoting posts)
engagement_rate = sum(diggCount) / total_reach * 100

trend_score = (promotion_density / 5, max 1) * 0.35
            + (total_reach / 1000000, max 1) * 0.35
            + (engagement_rate > 3 ? 1 : engagement_rate/3) * 0.30

Trend window: 70%+ promotions in last 7 days = PEAKING; spread evenly = SUSTAINED; mostly > 7 days = FADING

Step 3: Edge Cases
  • Product name extraction unreliable: Extract most specific noun phrase from caption alongside shop link
  • Same product different variants: Group by product name similarity; sum reach across variants
  • Saturated trend (> 50 creators): Window may be closing; flag as LATE_STAGE
  • Counterfeit signals: Price far below market (e.g. < $5 for normally $30+ item) → flag

Output Format

# TikTok Shop Trending Products: [CATEGORY]
Posts analyzed: [N] | Unique products: [N] | Date: [DATE]

## Trending Now (Peak Momentum)
| Product | Creators | Total Views | Avg Eng Rate | Stage | Score |
|---------|---------|------------|-------------|-------|-------|

## Sustained Performers
| Product | Creators | Total Views | Stage |
|---------|---------|-----------|-------|

## Saturation Alert
[Products with > 30 creators — difficult to enter profitably]

Troubleshooting

Few products identified: Check bio links of top promoting creators for product page. Trend already peaked: Run every 3-4 days to catch trends early. Suspicious pricing: Flag and verify before sourcing.

Comments

Markdown supported