mcp-server-scrappey

🚀 Scrappey MCP 服务器

Scrappey MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，用于实现与 Scrappey.com 的网络自动化和抓取功能的交互。您可以直接在 smithery.ai/server/@pim97/mcp-server-scrappey 上进行试用。

🚀 快速开始

此 MCP 服务器为 AI 模型与 Scrappey 的网络自动化平台之间架起桥梁，使您能够创建和管理浏览器会话、通过 Scrappey 的基础设施发送 HTTP 请求、执行浏览器操作（点击、输入、滚动等），还能自动处理各种反机器人保护。

✨ 主要特性

• 支持创建和销毁浏览器会话
• 通过自定义代理配置网络请求
• 支持自定义 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. 执行操作：在会话中执行浏览器操作，如点击或输入。

📚 详细文档

最佳实践

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

常见问题

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

资源信息

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

📄 许可证

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