phantombuster

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.