Alterlab MCP Server

AlterLab MCP Server

Give Claude, Cursor, and Windsurf the ability to scrape any website, extract structured data, and take screenshots — with automatic anti-bot bypass.

Get Started Free → $1 free balance on signup — up to 5,000 scrapes.

______________________________________________________________________

单线安装

克劳德代码

claude mcp add alterlab -- npx -y alterlab-mcp-server

然后设置API密钥： export ALTERLAB_API_KEY=sk_live_... 或将其添加到 .claude.json （参见 完整设置 在......下面

光标

# Add to .cursor/mcp.json — see full config below

铁匠铺

npx -y @smithery/cli install alterlab-mcp-server --client claude

______________________________________________________________________

为什么选择AlterLab而不是WebFetch或浏览器MCP？

克劳德的内置 WebFetch 工具和开源浏览器MCP服务器在大多数现实世界的网站上都失败了。它们无法绕过Cloudflare、渲染JavaScript SPA或提取结构化数据。

AlterLab将损坏的提取工具替换为 一台MCP服务器 这实际上是有效的：

AlterLab网络抓取是如何工作的？

AlterLab使用多层抓取架构。它会自动选择能够获取每个URL的最便宜的方法：

1. 卷曲 （$0.0002/req）--用于静态页面、RSS提要、公共API的直接HTTP
2. 超文本传输协议 （0.0003美元/需求）——中等保护站点的TLS指纹轮换
3. 隐形 （$0.0005/req）--Cloudflare/DataDome保护站点的浏览器模拟
4. 轻型JS （$0.0007/req）--从服务器渲染的HTML中提取轻量级JS
5. 浏览器 （0.001美元/需求）——用于JavaScript密集型SPA的全无头Chromium

自动模式从第1层开始，仅在被阻止时升级。大多数网站在第1-2层解析，因此 1美元可以让你刮1000到5000次 这取决于你的目标网站。

______________________________________________________________________

安装

在克劳德桌面/克劳德代码中安装

添加到您的Claude配置文件(~/.claude.json 克劳德代码或克劳德桌面设置）：

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

在游标中安装

添加 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

安装在Windsurf中

添加到Windsurf MCP设置(~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

通过Smithery安装

npx -y @smithery/cli install alterlab-mcp-server --client claude

获取API密钥

1. 免费注册 --注册时免费余额1美元
2. 首选 仪表盘→ API密钥 并复制您的密钥
3. 将其粘贴到 ALTERLAB_API_KEY MCP配置中的字段

______________________________________________________________________

工具

alterlab_scrape --删除任何网页

抓取URL并将其内容作为markdown、文本、HTML或JSON返回。通过分层升级自动处理反机器人保护。默认情况下返回markdown——针对LLM上下文窗口进行了优化。

"Scrape https://www.amazon.com/dp/B0BSHF7WHW and summarize the product"

alterlab_extract --提取结构化数据

使用预构建的配置文件或自定义JSON模式从任何网页中提取结构化字段。返回干净的JSON，可用于数据库、电子表格或下游处理。

"Extract the product name, price, and rating from this Amazon page"

提取配置文件：

• 产品 --名称、价格、货币、评级、评论、可用性、图片、描述
• 文章 --标题、作者、出版日期、正文、特色图片
• 招聘信息 --职位、公司、地点、工资、描述、要求
• 常见问题解答 --问答配对
• 食谱 --成分、说明、准备时间、份量
• 事件 --姓名、日期、地点、描述、组织者

alterlab_screenshot --截图任意页面

对任何URL进行全屏截图。直接在对话中返回PNG图像——无需复制URL，也无需下载文件。

"Take a screenshot of our landing page at https://alterlab.io"

alterlab_estimate_cost --报废前进行估算

在运行刮取之前，检查刮取的成本。返回预测的层、每个请求的成本和置信度。

"How much would it cost to scrape linkedin.com?"

alterlab_check_balance --检查您的积分

检查您的账户余额、存款总额和支出总额。不需要参数。

"Check my AlterLab balance"

alterlab_list_sessions --列出存储的会话

列出所有存储的会话以进行身份验证的抓取。会话包含特定域的Cookie，允许您在登录墙后抓取内容。

"List my stored sessions"

alterlab_create_session --创建会话

使用登录浏览器中的Cookie创建新的存储会话。会话被安全地存储，可以在多个抓取请求中重复使用。

"Create an Amazon session with these cookies: session-id=abc123, session-token=xyz789"

alterlab_validate_session --验证会话

检查存储的会话是否仍处于活动状态，其Cookie是否有效。

"Is my Amazon session still valid?"

alterlab_delete_session --删除会话

永久删除已存储的会话及其Cookie。

"Delete session abc-123-def"

______________________________________________________________________

经过身份验证的报废

AlterLab MCP支持抓取需要身份验证的页面。这使AI代理能够访问用户特定的内容，如订单历史、帐户仪表板和仅限会员的定价。

运作原理

1. 创建会话 使用登录浏览器中的Cookie alterlab_create_session
2. 删除经过身份验证的页面 通过传递 session_id 到 alterlab_scrape
3. 管理会话 使用列表、验证和删除工具

示例：查看亚马逊Prime定价

User: "What's my Prime member price for this product?"

Claude: [calls alterlab_list_sessions → finds Amazon session]
Claude: [calls alterlab_scrape with session_id for authenticated pricing]
Claude: "The Prime member price is $24.99 (public price: $34.99)"

内联Cookie与存储会话

• 存储的会话 (session_id)：最适合重复访问同一域。创建一次，跨请求重用。
• 内联Cookie (cookies)：最适合不需要保存会话的一次性身份验证请求。

______________________________________________________________________

你能用AlterLab MCP做什么？

研究与分析

让克劳德实时抓取和分析网站：

• *“从谷歌搜索中删除前5个结果并进行总结”*
• *“从该亚马逊分类页面提取所有产品价格”*
• *“比较这3个竞争对手的定价页面”*

使用真实数据生成代码

让Cursor或Windsurf在构建时获取实时数据：

• *“抓取此API文档页并从中生成TypeScript类型”*
• *“从该网站提取调色板并创建顺风配置”*
• *“截图此设计并在React中重新创建”*

内容和SEO

使用Claude按比例分析内容：

• *“删除这篇博客文章并提出SEO改进建议”*
• *“从此帮助中心提取所有常见问题条目并创建结构化数据集”*
• *“将我们的登录页面与竞争对手的登录页面进行比较，找出差距”*

监控和警报

构建监视网络的代理工作流：

• *“检查此产品是否有现货”*
• *“每天删除此页面，并在价格降至50美元以下时提醒我”*
• *“监控这个招聘板，寻找新的高级工程职位”*

______________________________________________________________________

定价——按需付费网络剪贴

没有订阅。没有每月最低限额。添加余额，并在需要时使用它。

基础报废成本

可选附加组件

1美元=5000次轻微刮擦。 新帐户注册后可获得1美元的免费余额。

______________________________________________________________________

环境变量

______________________________________________________________________

常见问题

如何将网络抓取添加到Claude、Cursor或Windsurf？

安装AlterLab MCP服务器。对于Claude Code，运行 claude mcp add alterlab -- npx -y alterlab-mcp-server 并设置您的 ALTERLAB_API_KEY。对于Claude Desktop、Cursor或Windsurf，请将JSON配置块添加到MCP设置文件中。配置后，您的AI助手可以抓取任何URL，提取结构化数据，并在对话中直接截图。

Claude可以抓取Cloudflare或反机器人保护背后的网站吗？

对。AlterLab自动处理Cloudflare、DataDome、PerimeterX、Akamai和其他反机器人系统。它使用多层方法，从最便宜的方法开始，只有在被阻止时才会升级。你不需要配置任何东西——反机器人旁路是全自动的。

什么是MCP服务器，它如何与Claude一起工作？

MCP（模型上下文协议）是Anthropic的开放标准，用于将AI助手连接到外部工具和数据源。MCP服务器是一个小程序，它公开了Claude、Cursor或Windsurf在对话中可以调用的工具，如网络抓取。AlterLab MCP服务器为您的AI助手提供了5个工具：抓取、提取、截图、估算成本和检查余额。

AlterLab与Firecrawl、ScrapingBee或Apify MCP服务器有何不同？

AlterLab的起价为每次请求0.0002美元，比大多数抓取API便宜5-20倍，因为它只在网站实际需要时使用昂贵的浏览器渲染。智能层升级意味着您为每个网站的需求付费，而不是最高限额。AlterLab还包括内置的结构化数据提取，带有预构建的配置文件（产品、文章、职位发布等），无需额外费用。

我可以从克劳德那里抓取亚马逊、沃尔玛和其他电子商务网站吗？

对。AlterLab负责所有主要的电子商务反机器人保护。使用 alterlab_extract 工具与 extraction_profile: "product" 获取结构化的JSON：产品名称、价格、货币、评级、评论数、可用性和图像——为分析、比较或数据管道做好准备。

Cursor可以抓取文档并从中生成代码吗？

对。Cursor中安装了AlterLab MCP，您可以要求它抓取API文档、库文档或任何参考页面，并从实时内容中生成TypeScript类型、API客户端或组件代码。这比依赖LLM的培训数据更可靠，后者可能已经过时。

AlterLab MCP是否适用于JavaScript密集型网站（React、Angular、Vue）？

对。使用 render_js: true 或设置 mode: "js" 启用完全无头Chromium渲染。AlterLab渲染包括所有JavaScript的完整页面，等待动态内容加载，然后从完全渲染的DOM中提取内容。这适用于React、Angular、Vue、Next.js和任何其他JavaScript框架。

哪种输出格式最适合AI和LLM上下文窗口？

使用markdown（默认）。它保留了文档结构——标题、表格、列表、链接——同时比原始HTML小60-80%。Claude、GPT-4和其他LLM在处理markdown方面明显优于HTML。AlterLab的markdown输出专门针对LLM上下文窗口进行了优化。

是否有利率限制？

免费等级账户有利率限制。添加任何余额都会取消利率限制。MCP服务器包括针对瞬时速率限制错误的指数回退的自动重试（429）。

我可以使用此MCP服务器进行大规模抓取吗？

对。MCP服务器通过对话界面一次处理一个请求，但您可以构建代理工作流，按顺序抓取许多URL。对于批处理，请直接使用AlterLab API或 n8n集成.

______________________________________________________________________

错误处理

MCP服务器返回有用的错误消息，并建议下一步操作：

______________________________________________________________________

代理工作流——抓取网络的人工智能代理

AlterLab MCP可以将任何AI代理转换为具有网络功能的代理。您的代理可以在执行过程中从任何网站获取实时信息，而不是依赖过时的训练数据。

AI代理用例

• 研究代理人 --抓取多个来源，交叉引用事实，生成引用报告
• 数据管道代理 --按计划提取结构化产品/定价/作业数据
• 竞争情报 --监控竞争对手页面，跟踪定价变化，检测新功能
• 内容生成 --用事实而非幻觉来抓取真实数据，以支持LLM输出
• 铅富集 --抓取公司网站，用实时数据丰富CRM记录
• 合规监测 --查看监管页面、服务条款和政策更新

兼容的AI框架和客户端

适用于支持MCP（模型上下文协议）的任何工具：

• 克劳德桌面 / 克劳德代码 --Anthropic的人工智能助手
• 光标 --AI驱动的代码编辑器
• 帆板运动 --Codeium的人工智能集成开发环境
• 克莱恩 --VS代码AI助手
• GitHub Copilot --通过MCP配置
• 自定义代理 --使用MCP SDK的任何框架（Python、TypeScript、Go）
• n8n --通过以下方式实现工作流自动化 n8n节点alterlab

______________________________________________________________________

贡献

git clone https://github.com/RapierCraft/alterlab-mcp-server.git
cd alterlab-mcp-server
npm install
npm run build

支持

• API文档
• 仪表板和API键
• support@alterlab.io

许可证

麻省理工学院