Agent skill
brightdata-tiktok
Discover TikTok influencers by keyword search using Bright Data API
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/documents/brightdata-tiktok
SKILL.md
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 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?