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

Setup

Connect your PhantomBuster account through the Composio MCP server at https://rube.app/mcp

The agent will prompt you with an authentication link if no active connection exists

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

PhantomBuster Automation

Author

Category

Install