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
- 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 |
---
*Powered by [Composio](https://composio.dev)*