mcp

FourA MCP 是 FourA 网页抓取 API 的 MCP 服务器，为 AI 智能体提供可靠的网页访问能力。用户给智能体一个公开 URL，FourA 返回内容，无论页面需要快速 HTTP 请求、代理轮换还是完整浏览器会话。

用途 该服务器用于让 AI 智能体抓取公开网页内容，覆盖产品信息提取、文章清理、价格监控、端点检查和批量 URL 抓取等场景。它通过 MCP 协议接入 Claude Desktop、Claude Code、Cursor、Windsurf、VS Code 或任何 MCP 客户端。

主要能力 提供四个工具：foura_auto 为默认智能抓取，输入 URL 即返回内容，自动选择抓取方式并处理常见拦截；foura_single 执行单次快速 HTTP 请求，适用于静态页面、JSON API 和服务端渲染 HTML；foura_proxy 通过轮换代理发送请求并在失败时自动重试，适用于直连被拦截或需要特定出口国家的目标；foura_browser 启动真实浏览器会话，执行 JavaScript、完成 DOM 渲染并返回 Cookie，适用于单页应用、懒加载内容或需要真实浏览器通过的反爬挑战。 所有工具标记为 readOnlyHint: true 和 openWorldHint: true。每个响应包含人类可读文本 content 和符合输出 schema 的结构化 JSON 对象 structuredContent。结果中报告 credits（本次调用消耗的积分，失败也计费）、request_id（调用标识）和 exitClass（premium 或 standard）。 内置六个提示词工作流，在 MCP 客户端的 /prompts 下显示，编排一个或多个工具而无需用户逐步说明。

使用方式 需要 FourA API 密钥，格式为 pk_live_...，在 foura.ai/dashboard/#api-keys 创建或查看。本地 stdio 模式推荐用于 Claude Desktop，配置示例：claude mcp add foura -- npx -y @fouradata/mcp（需先在环境变量中设置 FOURA_API_KEY）。npx 命令首次启动时下载包并作为 MCP 客户端的子进程运行，无需全局安装。同一份 JSON 配置适用于不同 MCP 客户端，仅配置文件位置不同。Claude Desktop 需完全退出（macOS 上 Cmd+Q）后再编辑配置文件，否则应用退出时会用内存中的配置覆盖修改。 托管模式使用 Streamable HTTP 端点，客户端需支持该传输方式；Claude Desktop 可使用上述 stdio 配置，也可通过 mcp-remote 桥接托管端点。stdio 模式使用 FOURA_API_KEY，托管端点使用 Authorization: Bearer pk_live_... 请求头。一个密钥认证全部四个工具。

适用场景与限制 适用于需要从公开网页获取内容的 AI 智能体工作流。私有目标被拒绝，对私有或保留地址的请求在 MCP 层被阻止，仅转发公共互联网主机。速率限制由 FourA API 按服务执行，涉及并发数和每分钟请求数。使用时应仅访问已获授权访问的公开内容，并遵守目标网站条款和适用法律。

其他细节 foura_single 和 foura_proxy 支持选择浏览器配置文件（browser、os、version、profile），完整目录公开在 api.foura.ai/api/profiles，无需密钥。foura_proxy 返回成功代理的编码 ID，可传给 foura_single.proxy 或 foura_browser.proxy 复用同一出口。默认情况下完整响应体内联返回；传入 offload_large: true 时，50 KB 及以上的响应以 resource_link 返回，资源保留一小时，仅创建该资源的 API 密钥可读回。错误响应携带结构化信封，包含 code、message 等字段，便于智能体实现重试逻辑。