Scrappey MCP 服务器

与 Scrappey.com 的网络自动化和抓取功能交互的 Model Context Protocol (MCP) 服务器。直接在 smithery.ai/server/@pim97/mcp-server-scrappey 上尝试使用。

概述

此 MCP 服务器为 AI 模型与 Scrappey 的网络自动化平台之间架起桥梁，使您能够：

• 创建和管理浏览器会话
• 通过 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. 创建会话：初始化一个新的浏览器会话。
2. 发送请求：通过会话发送 HTTP 请求。
3. 执行操作：在会话中执行浏览器操作，如点击或输入。

功能特性

• 支持创建和销毁浏览器会话
• 通过自定义代理配置网络请求
• 支持自定义 HTTP 头
• 自动处理反机器人保护机制

最佳实践

1. 资源管理：及时销毁不再使用的会话以释放资源。
2. 错误处理：捕获并处理可能出现的异常情况。
3. 安全性：确保 API 密钥的安全，避免泄露。

常见问题

• 如果无法创建会话，请检查 API 密钥是否有效。
• 如果发送请求失败，请验证目标 URL 和网络配置。

资源信息

• 官方文档：Scrappey 文档
• 支持联系方式：support@scrappey.com

许可证

本项目遵循 MIT 许可证，具体内容请参考 LICENSE 文件。