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.

phantombuster