| name | phantombuster |
| description | 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. |
| version | 1.0.0 |
| author | captmarbles |
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
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
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.
