phantombuster
Control PhantomBuster automation agents via API. List agents, launch automations, get output/results, check status, and abort running agents. Use when the user needs to run LinkedIn scraping, Twitter automation, lead generation phantoms, or any PhantomBuster workflow.
PhantomBuster Skill
Control your PhantomBuster automation agents from the command line.
Setup
- Get your API key from Workspace Settings
- Set the environment variable:
export PHANTOMBUSTER_API_KEY=your-api-key-here
Usage
All commands use the bundled pb.py script in this skill's directory.
List Agents
See all your configured PhantomBuster agents.
python3 pb.py list
python3 pb.py list --json # JSON output
Launch an Agent
Start a phantom by ID or name.
python3 pb.py launch <agent-id>
python3 pb.py launch <agent-id> --argument '{"search": "CEO fintech"}'
Get Agent Output
Fetch the results/output from the most recent run.
python3 pb.py output <agent-id>
python3 pb.py output <agent-id> --json # Raw JSON
Check Agent Status
See if an agent is running, finished, or errored.
python3 pb.py status <agent-id>
Abort Running Agent
Stop an agent that's currently running.
python3 pb.py abort <agent-id>
Get Agent Details
Full details about a specific agent.
python3 pb.py get <agent-id>
Fetch Result Data
Download the actual result data (CSV) from an agent's latest run.
python3 pb.py fetch-result <agent-id>
python3 pb.py fetch-result <agent-id> > output.csv
This downloads the result.csv file from the agent's S3 storage, perfect for integrating PhantomBuster data into your workflows.
Example Prompts
- "List my PhantomBuster agents"
- "Launch my LinkedIn Sales Navigator scraper"
- "Get the output from agent 12345"
- "Check if my Twitter follower phantom is still running"
- "Abort the currently running agent"
Common Phantoms
PhantomBuster offers many pre-built automations:
- LinkedIn Sales Navigator Search — Extract leads from searches
- LinkedIn Profile Scraper — Get profile data
- Twitter Follower Collector — Scrape followers
- Instagram Profile Scraper — Get IG profile data
- Google Maps Search Export — Extract business listings
Rate Limits
PhantomBuster has execution time limits based on your plan. The API itself is not heavily rate-limited, but agent execution consumes your plan's minutes.