---
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](https://phantombuster.com) automation agents from the command line.

## Setup

1. Get your API key from [Workspace Settings](https://phantombuster.com/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.

```bash
python3 pb.py list
python3 pb.py list --json  # JSON output
```

### Launch an Agent

Start a phantom by ID or name.

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

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

```bash
python3 pb.py status <agent-id>
```

### Abort Running Agent

Stop an agent that's currently running.

```bash
python3 pb.py abort <agent-id>
```

### Get Agent Details

Full details about a specific agent.

```bash
python3 pb.py get <agent-id>
```

### Fetch Result Data

Download the actual result data (CSV) from an agent's latest run.

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


---
Source attribution: kbarbel640-del
Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/andrewdmwalker/phantombuster/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2026 clawdbot

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: kbarbel640-del
Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/andrewdmwalker/phantombuster/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing, Sales
Roles: Account Executive, Growth Marketer, Influencer Marketer, Marketing Analyst, Sales Development Rep (SDR)
Specialties: API
Tools: Phantombuster
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 6c942c849cf5c2df9c49f821de3a662a23e68ff9aecb5d3875ad7702bbc722be