PhantomBuster Automation

# PhantomBuster Automation

Automate cloud-based data extraction and lead generation -- manage agents and scripts, monitor organization resources and usage, track container execution, and solve captcha challenges -- all orchestrated through the Composio MCP integration.

**Toolkit docs:** [composio.dev/toolkits/phantombuster](https://composio.dev/toolkits/phantombuster)

---

## Setup

1. Connect your PhantomBuster account through the Composio MCP server at `https://rube.app/mcp`
2. The agent will prompt you with an authentication link if no active connection exists
3. Once connected, all `PHANTOMBUSTER_*` tools become available for execution

---

## Core Workflows

### 1. List All Agents
Fetch every agent associated with your account or organization to inventory automation workflows.

**Tool:** `PHANTOMBUSTER_GET_AGENTS_FETCH_ALL`

```
No parameters required -- returns all agents with IDs and metadata.
Authenticate your API key first.
```

Use agent IDs from this response when fetching containers or monitoring specific automations.

---

### 2. List All Scripts
Retrieve all scripts available under your account (without code bodies) for script management.

**Tool:** `PHANTOMBUSTER_GET_SCRIPTS_FETCH_ALL`

```
No parameters required -- returns script metadata without source code.
```

---

### 3. Monitor Organization Resources & Quotas
Check your organization's current resource usage and quota limits to plan automation capacity.

**Tool:** `PHANTOMBUSTER_GET_ORGS_FETCH_RESOURCES`

```
No parameters required -- returns resource allocation and current usage metrics.
```

---

### 4. Retrieve Agent Containers
Fetch all execution containers for a specific agent to monitor run history and status.

**Tool:** `PHANTOMBUSTER_GET_CONTAINERS_FETCH_ALL`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agentId` | string | Yes | Agent ID from `PHANTOMBUSTER_GET_AGENTS_FETCH_ALL` |

---

### 5. Export Agent Usage Report
Download a CSV report of all agents' run statistics for your organization.

**Tool:** `PHANTOMBUSTER_GET_ORGS_EXPORT_AGENT_USAGE`

```
Returns a downloadable CSV with comprehensive agent execution statistics.
```

---

### 6. Solve hCaptcha Challenges
Obtain a valid hCaptcha token for automated form submissions or scraping flows that require captcha solving.

**Tool:** `PHANTOMBUSTER_POST_HCAPTCHA`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `siteKey` | string | Yes | Public site key of the hCaptcha widget |
| `pageUrl` | string | Yes | Full URL of the page with the captcha |
| `proxy` | string | No | Proxy URL (e.g., `http://user:pass@host:port`) |
| `userAgent` | string | No | Custom User-Agent string to simulate |

---

## Known Pitfalls

| Pitfall | Details |
|---------|---------|
| **Agent ID required for containers** | `PHANTOMBUSTER_GET_CONTAINERS_FETCH_ALL` requires a valid `agentId` -- always resolve it first via `PHANTOMBUSTER_GET_AGENTS_FETCH_ALL` |
| **API key authentication** | All PhantomBuster tools require a valid API key connection -- verify authentication before calling any tools |
| **Script bodies not included** | `PHANTOMBUSTER_GET_SCRIPTS_FETCH_ALL` returns metadata only, not source code |
| **Organization scope** | Resource and usage tools operate at the organization level tied to your API key -- ensure the correct org is targeted |
| **Branch operations** | `PHANTOMBUSTER_GET_BRANCHES_FETCH_ALL` and `PHANTOMBUSTER_GET_BRANCHES_DIFF` are for advanced script versioning -- use them to assess staging vs. release changes before deployment |

---

## Quick Reference

| Tool Slug | Purpose |
|-----------|---------|
| `PHANTOMBUSTER_GET_AGENTS_FETCH_ALL` | List all agents in your account |
| `PHANTOMBUSTER_GET_SCRIPTS_FETCH_ALL` | List all scripts (metadata only) |
| `PHANTOMBUSTER_GET_ORGS_FETCH_RESOURCES` | Check organization resource usage and quotas |
| `PHANTOMBUSTER_GET_CONTAINERS_FETCH_ALL` | Get all containers for a specific agent |
| `PHANTOMBUSTER_GET_ORGS_EXPORT_AGENT_USAGE` | Export agent usage as CSV |
| `PHANTOMBUSTER_POST_HCAPTCHA` | Solve hCaptcha challenges for automation |
| `PHANTOMBUSTER_GET_ORGS_FETCH` | Fetch organization details |
| `PHANTOMBUSTER_GET_ORGS_FETCH_AGENT_GROUPS` | Get agent groups and ordering |
| `PHANTOMBUSTER_GET_BRANCHES_FETCH_ALL` | List all script branches |
| `PHANTOMBUSTER_GET_BRANCHES_DIFF` | Compare staging vs. release branches |

---

*Powered by [Composio](https://composio.dev)*