Apify MCP Server

什么是 Apify MCP Server？

Apify MCP 是 Apify 官方的 Model Context Protocol 服务器：它让 AI 智能体可以搜索 Apify Store，并运行数千个现成的爬虫、抓取器和自动化工具（Actor），从社交媒体、搜索引擎、地图、电商网站以及任何其他网站获取数据。

该服务器开源（MIT），由 Apify 在 apify/apify-mcp-server 仓库中维护（旧的 apify/actors-mcp-server 地址会重定向到这里）。你可以连接托管端点 https://mcp.apify.com（Streamable HTTP + OAuth），也可以通过 stdio 在本地运行 @apify/actors-mcp-server npm 包。Apify 推荐使用托管服务器，它还提供本地版本所没有的输出 schema 推断。

如何使用 Apify MCP Server？

你需要一个 MCP 客户端，通常还需要一个 Apify 账号。API token（在 Apify Console 的 API & Integrations 中获取）只在本地 stdio 或 Bearer token 方式下需要；托管服务器使用 OAuth。MCP 配置器 可以为大多数客户端生成配置。

托管服务器 + OAuth（推荐）：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com"
    }
  }
}

托管服务器，使用 Bearer token 代替 OAuth：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com",
      "headers": {
        "Authorization": "Bearer <APIFY_TOKEN>"
      }
    }
  }
}

本地 stdio，适用于不支持远程服务器的客户端（需要 Node.js）：

{
  "mcpServers": {
    "actors-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

如果使用 Apify CLI，apify mcp install cursor（或其他客户端名称）会自动为你写入配置。

Claude Code

Apify 提供了一个 Claude Code 插件，将 MCP 服务器与 Agent Skills 打包在一起。在 Claude Code 中运行：

/plugin marketplace add apify/apify-claude-code-plugin
/plugin install apify@apify
/reload-plugins

然后运行 /mcp，打开 plugin:apify:apify，选择 Enable，再选择 Authenticate 并登录。在无界面（headless）环境中，请在启动 Claude Code 之前设置 APIFY_TOKEN。

Claude Desktop

打开 Settings > Connectors，选择 Add > Add custom connector，输入名称（例如 Apify）和 URL https://mcp.apify.com，保留自动检测到的设置并选择 Add。它同样适用于 claude.ai。也可以从 connector 目录中安装 Apify。

Cursor

在 Cursor 的 agent 聊天中运行 /add-plugin apify（或从 Cursor Marketplace 安装 Apify）。然后打开 Cursor Settings > Tools & MCPs，在 Apify MCP 服务器上选择 Connect 并登录。

VS Code

打开 Extensions 视图，搜索 @agentPlugins apify，安装来自 Awesome Copilot marketplace 的 apify 条目并确认信任提示。当 VS Code 要求对 MCP 服务器进行认证时，选择 Allow 并登录 Apify。

Codex

在 Codex CLI 中运行 /plugins，打开 Add Marketplace，输入 apify/apify-codex-plugin，然后在 Apify Plugin 标签页中安装 Apify。首次调用需要认证的工具时会打开登录页面。

Apify MCP Server 的主要功能

• 通过加载 Actor 的输入 schema，把任何 Apify Actor 变成 MCP 工具，让模型知道该传哪些参数。
• 动态发现：智能体可以用 search-actors 找到合适的 Actor，再用 call-actor 运行，无需预先配置。
• 预置 apify/rag-web-browser 和 apify/web-fetch 两个 Actor 以及若干辅助工具。
• 可通过 tools URL 参数或 --tools CLI 参数配置工具集（类别、单个工具或特定 Actor）。
• 支持 OAuth 或 Bearer token 认证；少数发现类和文档类工具无需账号即可使用。
• 支持通过 AGI、直接 x402（Base 链上的 USDC）或 Skyfire 进行智能体支付，智能体无需 API token 即可为运行付费。
• 可选的 UI 模式（ui=true）提供交互式 MCP App 组件；遥测可以关闭。

Apify MCP Server 工具

工具按可选择的类别分组：

• actors（默认）：search-actors、fetch-actor-details 和 call-actor 用于查找 Actor、读取其输入 schema、定价和 README，然后运行它。
• docs（默认）：search-apify-docs 和 fetch-apify-docs 把 Apify 文档拉取到上下文中。
• Actor 工具（默认）：apify--rag-web-browser 搜索网页并返回排名靠前结果的内容；apify--web-fetch 抓取一个 URL，并以 Markdown、纯文本、HTML 或链接形式返回。
• runs 和 storage：get-actor-run、get-actor-run-log、abort-actor-run、get-dataset-items、get-key-value-store-record 及相关工具。加载 Actor 工具或 call-actor 时，服务器会自动加入 get-actor-run、get-dataset-items、get-key-value-store-record 和 abort-actor-run。
• tasks、schedules、builds 和 api：管理保存的任务、cron 定时计划和构建，或用 apify-api-search 和只读的 apify-api-read 查询 Apify API。

注意，call-actor 返回的是运行状态和存储 ID，而不是抓取到的数据；智能体随后要用 get-dataset-items 读取结果。

Apify MCP Server 的使用场景

• 网络调研：“查找关于自主 AI 智能体的最新新闻并进行总结。”
• 本地商家线索：“从 Google Maps 抓取布拉格排名前 10 的餐厅及其联系方式。”
• 使用 Google Search Results Scraper 做 SEO 调研：“获取 'apify mcp' 的 Google 第一页结果，并列出排名的域名。”
• 社媒监测：从多个 Facebook 主页提取帖子和评论，或抓取 Instagram 帖子和主页资料进行分析。
• 结果分页：“给我看那次运行的下 10 条结果。”
• 自动化：创建 Actor 任务和定时计划，让爬虫按 cron 周期运行。

Apify MCP Server 与替代方案对比

Firecrawl MCP Server 通过一个 API 提供抓取、爬取和搜索，而 Apify 为智能体提供一个针对特定网站的 Actor 市场（Google Maps、Instagram、Facebook 等）。Playwright MCP Server 和 Puppeteer MCP Server 会一步步驱动本地浏览器；Apify 则在自己的云端执行任务并返回结构化数据集。本页收录的是 Apify 官方服务器。

Apify MCP Server 常见问题排查

• Unauthorized 或 token 无效：在 Apify Console 的 API & Integrations 中检查 token，本地使用时确认已设置 APIFY_TOKEN，或删除并重新添加 connector 以重新走 OAuth 流程。
• 旧的 /sse 地址失效：旧版 SSE 端点已被移除。请使用不带 /sse 后缀的 https://mcp.apify.com。
• Claude Desktop 中看不到工具：检查 connector 设置中 Apify 工具是否被禁用，重启应用，或删除并重新添加 connector。
• 本地服务器无法启动：确认已安装 Node.js（node -v），使用 @apify/actors-mcp-server@latest，并在 macOS 或 Linux 上用 rm -rf ~/.npm/_npx 清理损坏的 npx 缓存。
• 结果很慢或为空：在 Apify Console 中查看运行日志，并用 get-dataset-items 获取数据，因为 call-actor 不会返回数据。