使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/apidojo-io/apidojo-skills --skill finding-tiktok-creators-using-trending-sounds开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Finding Tiktok Creators Using Trending Sounds
Inputs
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
startUrls | array | ✅ | [] | TikTok music/sound page URLs |
maxItems | number | Optional | Unlimited | Maximum posts to return |
customMapFunction | string | Optional | — | JavaScript function to transform each output object |
How to Run
Using run_actor.js (recommended)
bash
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}'
# Save as CSV
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}' --output results.csv --format csv
# Save as JSON
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}' --output results.json --format jsonREST API fallback
bash
curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-music-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}'If Apify MCP is available: Use the Apify MCP call_actor tool with actor apidojo~tiktok-music-scraper and the input above.
Scoring & Ranking
Score each creator by:
followers→ normalized 0-1 (cap at 1M), weight 0.35engagement_rate = (likes + comments) / views→ weight 0.35video_views→ normalized 0-1 (cap at 1M), weight 0.30
python
score = 0.35 * min(followers / 1000000, 1.0) + 0.35 * min(engagement_rate / 0.10, 1.0) + 0.30 * min(views / 1000000, 1.0)Classification
| Score | Tier | Label |
|---|---|---|
| ≥ 0.70 | A | PRIME_CREATOR |
| 0.40–0.69 | B | GOOD_FIT |
| < 0.40 | C | LOW_PRIORITY |
Edge Cases
- No music URL: Requires TikTok sound page URL. Tell user to find the sound on TikTok and copy the URL from the "sounds" page.
- Sound removed: If sound was taken down for copyright, URL returns empty. Try alternative sound.
- Trending sound has too many creators: Use maxItems cap and sort by engagement.
- Duplicate creators: Same creator may use the sound multiple times — deduplicate by channel.username.
- Regional sound: Some sounds trend in specific countries — results may reflect that audience.
