PhantomBuster Automation
Scannednpx machina-cli add skill ComposioHQ/awesome-claude-skills/phantombuster-automation --openclawPhantomBuster 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 |
Powered by Composio
Source
git clone https://github.com/ComposioHQ/awesome-claude-skills/blob/master/composio-skills/phantombuster-automation/SKILL.mdView on GitHub Overview
Automate cloud-based data extraction and lead generation with PhantomBuster agents and scripts. This skill orchestrates resources via the Composio MCP, enabling agent/script management, usage monitoring, container tracking, and captcha solving.
How This Skill Works
Connect your PhantomBuster account through the Composio MCP server at https://rube.app/mcp. Once authenticated, PHANTOMBUSTER_* tools are available for execution, letting you fetch agents or scripts, monitor organization resources and quotas, retrieve containers, export usage, and solve hCaptcha challenges as part of scraping workflows.
When to Use It
- Inventory all agents in your account or organization to understand your automation footprint.
- List all scripts to manage assets without pulling full code bodies.
- Monitor organization resources and quotas to plan automation capacity.
- Retrieve containers for a specific agent to review run history and status.
- Export an agent usage CSV for reporting and governance.
Quick Start
- Step 1: Connect your PhantomBuster account through the Composio MCP server at `https://rube.app/mcp`
- Step 2: The agent will prompt you with an authentication link if no active connection exists
- Step 3: Once connected, all `PHANTOMBUSTER_*` tools become available for execution
Best Practices
- Authenticate the PhantomBuster API key before calling any tools.
- Resolve agent IDs first (via PHANTOMBUSTER_GET_AGENTS_FETCH_ALL) before fetching containers.
- Prefer metadata fetch for scripts (PHANTOMBUSTER_GET_SCRIPTS_FETCH_ALL) since code bodies are not included.
- Ensure you target the correct organization when using org-wide resource tools.
- Use hCaptcha solving only when required and in compliance with platform terms.
Example Use Cases
- Audit all PhantomBuster agents in your organization to map automation workflows.
- Catalog all scripts available in your account for centralized asset management.
- Monitor and compare resource usage across the organization to cap costs.
- Inspect run history by pulling containers for a given agent to diagnose failures.
- Export a usage report CSV to share with stakeholders and for audits.
