SKILL.md

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.

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

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

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

Summary

SKILL.md

PhantomBuster Automation

Setup

Core Workflows

1. List All Agents

2. List All Scripts

3. Monitor Organization Resources & Quotas

4. Retrieve Agent Containers

5. Export Agent Usage Report

6. Solve hCaptcha Challenges

Known Pitfalls

Quick Reference

Related skills