Agent skill
brightdata-instagram
Discover Instagram 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-instagram
SKILL.md
Bright Data Instagram Scraper
Discover Instagram influencers using Bright Data's web scraping API.
When to Use
Use this skill when you need to:
- Find Instagram influencers in a specific niche
- Discover content creators for collaboration
- Search Instagram profiles by keyword
- Get influencer profile photos for portrait generation
How to Use
Step 1: Trigger the Scrape
$CLAUDE_CONFIG_DIR/skills/brightdata-instagram/scripts/trigger-scrape.sh "search_keyword"
Parameters:
search_keyword: The keyword to search for (e.g., "fitness", "photography")
Returns: A snapshot_id used to fetch results
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-instagram/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-instagram/scripts/get-snapshot.sh "snapshot_id"
Parameters:
snapshot_id: The ID returned from trigger-scrape.sh
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-instagram/scripts/get-snapshot.sh "abc123xyz"
Output file: /tmp/data/instagram_[timestamp].json
Output Data Structure
Each profile in the results includes:
| Field | Description |
|---|---|
username |
Instagram username |
url |
Direct link to the profile |
followers |
Number of followers |
biography |
Profile bio/description |
profile_pic_url |
URL to profile picture |
posts |
Array of recent posts with images |
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
- Profile photos can be downloaded for portrait generation
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?