Scrappey MCP 服务器

一个用于与 Scrappey.com 的 Web 自动化和抓取功能交互的模型上下文协议 (MCP) 服务器。可以直接在 smithery.ai/server/@pim97/mcp-server-scrappey 试用。

概述

此 MCP 服务器提供了一个 AI 模型和 Scrappey Web 自动化平台之间的桥梁，允许您：

• 创建和管理浏览器会话
• 通过 Scrappey 的基础设施发送 HTTP 请求
• 执行浏览器操作（点击、输入、滚动等）
• 自动处理各种反爬虫保护

设置

1. 从 Scrappey.com 获取您的 Scrappey API 密钥
2. 设置您的环境变量：

SCRAPPEY_API_KEY=your_api_key_here

可用工具

1. 创建会话 (scrappey_create_session)

创建一个新的浏览器会话，该会话会持久保存 cookie 和其他状态。

{
  "proxy": "http://user:pass@ip:port"  // 可选：自定义代理，留空则使用默认代理
}

2. 销毁会话 (scrappey_destroy_session)

正确关闭浏览器会话。

{
  "session": "session_id_here"  // 必需：要销毁的会话 ID
}

3. 发送请求 (scrappey_request)

通过 Scrappey 基础设施发送 HTTP 请求。

{
  "cmd": "request.get",  // 必需：request.get, request.post 等
  "url": "https://example.com",  // 必需：目标 URL
  "session": "session_id_here",  // 必需：要使用的会话 ID
  "postData": "key=value",  // 可选：POST 数据
  "customHeaders": {  // 可选：自定义标头
    "User-Agent": "custom-agent"
  }
}

4. 浏览器操作 (scrappey_browser_action)

执行浏览器自动化操作。

{
  "session": "session_id_here",  // 必需：要使用的会话 ID
  "browserActions": [  // 必需：要执行的操作数组
    {
      "type": "click",  // 操作类型：click, hover, type, scroll, wait
      "cssSelector": ".button",  // 元素的 CSS 选择器
      "text": "Hello",  // 要输入的文本（对于 type 操作）
      "wait": 1000  // 等待时间，单位为毫秒
    }
  ]
}

典型工作流程

1. 创建一个会话：

{
  "name": "scrappey_create_session"
}

2. 将返回的会话 ID 用于后续请求：

{
  "name": "scrappey_request",
  "cmd": "request.get",
  "url": "https://example.com",
  "session": "returned_session_id"
}

3. 如果需要，执行浏览器操作：

{
  "name": "scrappey_browser_action",
  "session": "returned_session_id",
  "browserActions": [
    {
      "type": "click",
      "cssSelector": "#login-button"
    },
    {
      "type": "type",
      "cssSelector": "#username",
      "text": "myuser"
    }
  ]
}

4. 完成后，通过销毁会话进行清理：

{
  "name": "scrappey_destroy_session",
  "session": "returned_session_id"
}

特性

• 会话持久性，用于维护状态
• 自动反爬虫保护处理
• 支持自定义代理
• 浏览器自动化功能
• HTTP 请求方法（GET、POST、PUT、DELETE、PATCH）
• 自定义标头和 cookie 支持

最佳实践

1. 完成会话后始终销毁会话
2. 向同一站点发出多个请求时，重用会话
3. 在操作之间使用适当的等待时间，以获得更像人类的行为
4. 在使用会话之前检查会话是否存在

错误处理

如果出现问题，服务器将返回包含详细信息的错误消息。 常见错误包括：

• 无效的会话 ID
• 网络超时
• 浏览器操作的无效选择器
• 反爬虫保护失败

资源

• 在 Smithery 上试用
• Scrappey 文档
• 获取 Scrappey API 密钥

许可证

MIT 许可证