← Back to list

brightdata-tiktok
by vm0-ai
⭐ 4🍴 1📅 Jan 24, 2026
SKILL.md
name: brightdata-tiktok description: Discover TikTok influencers by keyword search using Bright Data API
Bright Data TikTok Scraper
Discover TikTok influencers using Bright Data's web scraping API.
When to Use
Use this skill when you need to:
- Find TikTok influencers in a specific niche
- Discover content creators for collaboration
- Search TikTok profiles by keyword
How to Use
Step 1: Trigger the Scrape
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/trigger-scrape.sh "search_keyword"
Parameters:
search_keyword: The keyword to search for (e.g., "fitness trainer", "cooking")
Returns: A snapshot_id used to fetch results
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/trigger-scrape.sh "fitness trainer"
# Output: snapshot_id=abc123xyz
Step 2: Wait for Scraping
Bright Data needs approximately 2-3 minutes to complete the scrape. Wait before fetching results.
Step 3: Fetch Results
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/get-snapshot.sh "snapshot_id"
Parameters:
snapshot_id: The ID returned from trigger-scrape.sh
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/get-snapshot.sh "abc123xyz"
Output file: /tmp/data/tiktok_[timestamp].json
Output Data Structure
Each profile in the results includes:
| Field | Description |
|---|---|
profile_id | Unique TikTok profile ID |
profile_username | TikTok username (e.g., @username) |
profile_url | Direct link to the profile |
profile_followers | Number of followers |
description | Profile/video description |
url | Video URL |
Environment Variables
BRIGHTDATA_API_KEY: Required. Your Bright Data API key.
Guidelines
- Start with broad keywords, then narrow down if needed
- The API returns up to 5 profiles per search by default
- If the snapshot is not ready, wait and retry
- Always check for errors in the API response
Error Handling
| Error | Cause | Solution |
|---|---|---|
| "running" status | Snapshot still being prepared | Wait 1-2 minutes and retry |
| 401 error | Invalid API key | Verify BRIGHTDATA_API_KEY is set correctly |
| Empty results | No matches found | Try a different or broader keyword |
Score
Total Score
50/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
○LICENSE
ライセンスが設定されている
0/10
○説明文
100文字以上の説明がある
0/10
○人気
GitHub Stars 100以上
0/15
○最近の活動
3ヶ月以内に更新がある
0/10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
○タグ
1つ以上のタグが設定されている
0/5
Reviews
💬
Reviews coming soon