PhantomBuster - OpenClaw Skill

Control PhantomBuster automation agents via API. List agents, launch automations, get output/results, check status, and abort running agents.

Features

• 🚀 Launch Agents - Start PhantomBuster automations programmatically
• 📊 Get Results - Fetch output data from completed runs
• 📋 List Agents - View all your configured phantoms
• 🔍 Check Status - Monitor running agents
• ⛔ Abort Agents - Stop running automations
• 📥 Fetch Data - Download result CSV files

Quick Start

1. Get Your API Key

Get your API key from PhantomBuster Workspace Settings

2. Set Environment Variable

export PHANTOMBUSTER_API_KEY=your-api-key-here
# Or add to ~/.env
echo "PHANTOMBUSTER_API_KEY=your-api-key" >> ~/.env

3. Installation

# Via ClawHub (once published)
clawdhub install phantombuster

# Via GitHub
git clone https://github.com/capt-marbles/phantombuster ~/.openclaw/skills/phantombuster

4. Usage

# List all agents
python3 pb.py list

# Launch an agent
python3 pb.py launch <agent-id>

# Get agent output
python3 pb.py output <agent-id>

# Check status
python3 pb.py status <agent-id>

# Download results
python3 pb.py fetch-result <agent-id> > output.csv

Common Use Cases

LinkedIn Prospecting

# Launch LinkedIn Sales Navigator scraper
python3 pb.py launch linkedin-scraper --argument '{"search": "CEO fintech"}'

# Get the results
python3 pb.py fetch-result linkedin-scraper > leads.csv

Twitter Automation

# Launch Twitter follower collector
python3 pb.py launch twitter-followers

# Check progress
python3 pb.py status twitter-followers

Lead Generation

# Launch multiple agents
python3 pb.py launch google-maps-scraper
python3 pb.py launch instagram-scraper

# Monitor all running agents
python3 pb.py list --json | jq '.[] | select(.status=="running")'

Supported Phantoms

PhantomBuster offers 100+ pre-built automations:

LinkedIn

• Sales Navigator Search Export
• Profile Scraper
• Company Employee Extractor
• Post Commenters Extractor

Twitter/X

• Follower Collector
• Profile Scraper
• Tweet Collector

Instagram

• Profile Scraper
• Hashtag Collector
• Following Collector

Business

• Google Maps Search Export
• Yellow Pages Scraper
• Crunchbase Scraper

Perfect For

• 🎯 Sales Prospecting - Build lead lists from LinkedIn, Twitter, etc.
• 📊 Market Research - Collect data from social networks
• 🔍 Competitive Analysis - Monitor competitor activity
• 📧 Lead Enrichment - Gather contact information
• 🤖 Workflow Automation - Integrate with CRM systems

API Commands

Command	Description
list	List all agents
launch <id>	Launch an agent
output <id>	Get agent output
status <id>	Check agent status
abort <id>	Stop running agent
get <id>	Get agent details
fetch-result <id>	Download result CSV

Requirements

• Python 3.6+
• PhantomBuster account with API key
• Active PhantomBuster agents configured

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.

Documentation

See SKILL.md for complete documentation.

License

MIT

Author

captmarbles