---

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

1. Get your API key from Workspace Settings
2. 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.