跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 PhantomBuster,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
摘要
在任意 AI 智能体中操作 PhantomBuster 工作区:列出和查看代理(Phantom),启动、排程和停止它们,跟踪运行并读取结果,修改输入和排程,管理线索列表和已存储的线索,查看套餐用量。使用 API 密钥调用 API v2;删除操作和一键停止所有排程在安装时关闭。
试试这样问
PhantomBuster 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → PhantomBuster、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
PhantomBuster + Claude
在任意 AI 智能体中操作 PhantomBuster 工作区:列出和查看代理(Phantom),启动、排程和停止它们,跟踪运行并读取结果,修改输入和排程,管理线索列表和已存储的线索,查看套餐用量。使用 API 密钥调用 API v2;删除操作和一键停止所有排程在安装时关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
PHANTOMBUSTER_API_KEY
步骤 1 — 获取凭证
设置大约需要 2 分钟。你需要一个 PhantomBuster 工作区,里面有要让 AI 运行的 Phantom。
- 在 PhantomBuster 中打开 Workspace settings(https://phantombuster.com/workspace-settings,也可从导航栏菜单进入),进入 API Keys 并添加一个密钥。密钥只显示一次,请复制下来。
- 把它粘贴到
PHANTOMBUSTER_API_KEY。它通过X-Phantombuster-Key请求头发送,对这一个工作区拥有完全访问权限。 - 安装连接器并运行
phantombuster_get_org:它会显示工作区、套餐和时区,并确认密钥有效。
可读取的内容:工作区及其套餐、时区和每日上限;套餐用量(执行时间、邮件、AI、验证码和 SERP 额度以及存储空间,今天和本月的用量,以及下次重置时间);当前正在执行的运行;最近 N 天(最多约 6 个月)按代理和按运行统计的用量 CSV 导出;仪表盘文件夹。你的代理及其脚本、排程、上次结果和已保存的输入,已删除的代理,以及带清单(该脚本的代理可接受的输入字段)的脚本。代理的运行(容器)及其状态、时间和退出码、控制台日志和结果数据。工作区存储中的线索列表及其保存的筛选条件,以及符合某个列表的线索(姓名、LinkedIn 个人资料和公司、职位、所在地、邮箱以及其他已存储字段)。
可写入的操作:立即启动代理(phantombuster_launch_agent)或在接下来 N 分钟内启动(phantombuster_launch_agent_soon),停止正在运行的代理(phantombuster_abort_agent;使用 soft_abort 时 Phantom 会完成当前步骤并保存已获取的数据),修改代理的名称、已保存输入、排程(launch_type、repeated_launch_preset)、时间上限和通知,或从脚本创建新代理(phantombuster_save_agent,保存从不启动运行),创建或修改线索列表,存储或更新单条线索。
启动是真实操作:一次运行会使用在 PhantomBuster 中连接的社交账户执行动作(访问个人资料、发送好友邀请或消息),并消耗套餐的执行时间。启动前,AI 会向你展示代理、输入和数量,等你确认后才执行。每天操作过多可能导致 LinkedIn 账户受限,请遵守 Phantom 建议的每日上限。会话 Cookie 和连接的账户在 PhantomBuster 中设置;不要把 Cookie 粘贴到聊天里。
单次运行的输入:argument 会替换这次运行的已保存输入(加上 save_argument 还会保存下来);bonus_argument 只在这一次运行中把少数字段覆盖到已保存输入上。字段名来自脚本清单(带 with_manifest: "true" 调用 phantombuster_get_agent),例如 spreadsheetUrl 或 numberOfProfiles。
跟踪运行:启动后返回 containerId。随后 AI 大约每分钟调用一次 phantombuster_get_agent_output,通过 from_output_pos 和 prev_container_id 只读取新的日志行,直到状态变为 finished。运行的数据来自 phantombuster_get_container_result;文件也位于 https://phantombuster.s3.amazonaws.com/<orgS3Folder>/<s3Folder>/result.csv(以及 result.json),两个文件夹都可从 phantombuster_get_agent 获得。两个代理可能同名,所以 AI 始终使用代理 ID。
线索列表:列表是针对已存储线索的保存筛选条件,Phantom 存入新线索时会自动更新。筛选条件形如 {"and": [ ... ]},由 {"filter": {"linkedin_job_title": {"entity": "lead", "operator": "contains", "valueToCompare": "CTO"}}} 这样的子句、嵌套的 and / or 或 {"__global_search__": "text"} 组成。线索字段使用 snake_case(linkedin_job_title、location、professional_emails),公司字段使用 camelCase 并带 "entity": "company"(industriesV2、employeeCount)。线索存储相关工具使用 PhantomBuster 的 beta API。
安装时关闭:phantombuster_delete_leads(无法撤销)、phantombuster_delete_lead_list(线索仍保留在存储中)、phantombuster_delete_agent(其历史运行和结果文件将不再显示)和 phantombuster_unschedule_all_agents(紧急停止,把所有代理改为手动启动)。团队需要时由工作区管理员开启。
数据格式:ID 是数字字符串。日期是以毫秒为单位的 Unix 时间戳。运行状态为 starting、running、finished、launch error 或 never launched;exitCode 为 0 且 endType 为 finished 表示成功。用量数值为执行时间的秒数和额度的数量。
分页:phantombuster_list_containers 按从新到旧返回 limit 条运行;更早的运行由 AI 把最后一条的 endedAt 作为 before_ended_at 传入。phantombuster_list_leads_in_list 使用 page_size 和 offset 分页(include_total_count 返回总数)。其他列表一次返回全部内容。PhantomBuster 商店的脚本列表有好几 MB,所以 AI 用 script_ids 进行筛选。
常见错误:401 "API key not found" 表示密钥错误或已被撤销。400 表示参数缺失或错误,或启动参数过大。404 表示未知 ID。套餐执行时间用完或并行运行已过多(maxParallelism)时,启动会失败。
该连接器不连接社交账户,不处理会话 Cookie,不修改 Phantom 代码(脚本只读),也不更改套餐。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
推荐路径:在 claude.ai web 上工作,无需触碰任何配置文件。
- 在 Claude 中打开 Customize → Connectors。
- 点击 +,然后点击 Add custom connector。
- 输入名称(例如
PhantomBuster)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。 - 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。
下面所有工具都会出现在你的聊天中,开始输入提示。
可用工具
| Tool | What it does |
|---|---|
phantombuster_get_org | The workspace (org) the API key belongs to: id, name, plan, time zone, s3Folder (needed to build result file URLs) and the daily limits of… |
phantombuster_get_org_resources | Plan usage of the workspace: execution time, email credits, AI credits, captcha, SERP credits and storage used today and this month, with… |
phantombuster_list_running_containers | Runs (containers) that are executing right now in the workspace, across all agents |
phantombuster_export_agent_usage | CSV export of execution time and resource use per agent over the last N days (at most about 6 months) |
phantombuster_export_container_usage | CSV export of every run (container) over the last N days with its duration and resource use, optionally for one agent only |
phantombuster_list_agent_groups | Folders (agent groups) of the dashboard and the order of the agents inside them |
phantombuster_list_agents | All agents (Phantoms set up in the workspace) with id, name, script, launch type and schedule, last run end type and exit code, running… |
phantombuster_get_agent | One agent with its full settings: script, saved argument (input), schedule (launchType, repeatedLaunchTimes), notifications, limits… |
phantombuster_get_agent_output | Status and console output of the most recent run of an agent: containerId, status (starting, running, finished, launch error, never… |
phantombuster_list_deleted_agents | Agents that were deleted from the workspace, with their former ids and names |
phantombuster_list_containers | Runs (containers) of one agent, newest first: id, status, launch type, start and end time, exit code and end type |
phantombuster_get_container | One run (container): status, launch and end time, exit code, end type and retry number; optionally its output and result object |
phantombuster_get_container_output | Console output (log) of one run of an agent, as JSON or as plain text |
phantombuster_get_container_result | The result object of one run: the data the Phantom produced (often a JSON string of rows, or links to the result CSV and JSON files) |
phantombuster_list_scripts | Scripts (Phantom code) the workspace owns: id, name, default branch and dates |
phantombuster_get_script | One script by id: name, org, branches and manifest (the argument fields an agent of this script accepts) |
phantombuster_list_lead_lists | Leads lists of the workspace storage (beta API): id, name, description, the saved filter that defines the list, tags and dates |
phantombuster_get_lead_list | One leads list of the workspace storage by id: name, description, tags and the saved filter |
phantombuster_list_leads_in_list | Leads that match a leads list (beta API), page by page: name, LinkedIn profile and company, job title, location, emails and the rest of the… |
phantombuster_launch_agent | Starts a run of an agent now (adds it to the launch queue) and returns the containerId of the new run |
phantombuster_launch_agent_soon | Schedules one run of an agent within the next N minutes (a one-time delayed launch) |
phantombuster_abort_agent | Stops the running run(s) of an agent. soft_abort lets the Phantom finish its current step and save what it has |
phantombuster_save_agent | Updates an agent's settings (with agent_id) or creates a new agent from a script (without agent_id, with script_id): name, saved argument… |
phantombuster_save_lead_list | Creates a leads list (without list_id) or replaces the filter, name and description of one (with list_id) |
phantombuster_save_lead | Stores one lead in the workspace storage (beta API), or updates the lead with the same LinkedIn profile URL |
phantombuster_delete_leads | Deletes leads from the workspace storage by id |
phantombuster_delete_lead_list | Deletes a leads list (the saved filter; the leads stay in storage) |
phantombuster_delete_agent | Deletes an agent with its schedule; its past runs and result files are no longer shown |
phantombuster_unschedule_all_agents | Emergency stop: turns off the automatic launch of every agent in the workspace (all become manual) |
示例提示
- “过去 24 小时里我的哪些 Phantom 运行过?有没有以错误结束的?”
- “用我给你的搜索 URL 启动我的 Sales Navigator Search Export 代理,最多 100 个个人资料。先给我看输入内容。”
- “本月我们套餐里还剩多少执行时间和邮件额度?”
- “创建一个线索列表,包含所有职位里含 CTO 且位于德国的已存储线索。”
- “把我的 LinkedIn Profile Scraper 改成每天运行一次,并告诉我下次什么时候运行。”
FAQ
Claude Code 和 Claude Desktop 一样工作吗? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
下一步
这份指南对你有帮助吗?