Entrar
capt-marbles

phantombuster

by @capt-marbles in AI & LLM
0
0
# Install this skill:
npx skills add capt-marbles/phantombuster

Or install specific skill: npx add-skill https://github.com/capt-marbles/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.

# SKILL.md

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:
    bash 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.

# README.md

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 ~/.clawdbot/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

# Related Skills

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.