🚀 Scrappey MCP 服务器
Scrappey MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，用于实现与 Scrappey.com 的网络自动化和抓取功能的交互。您可以直接在 smithery.ai/server/@pim97/mcp-server-scrappey 上进行试用。
🚀 快速开始
此 MCP 服务器为 AI 模型与 Scrappey 的网络自动化平台之间架起桥梁，使您能够创建和管理浏览器会话、通过 Scrappey 的基础设施发送 HTTP 请求、执行浏览器操作（点击、输入、滚动等），还能自动处理各种反机器人保护。
✨ 主要特性
- 支持创建和销毁浏览器会话
- 通过自定义代理配置网络请求
- 支持自定义 HTTP 头
- 自动处理反机器人保护机制
📦 安装指南
- 在 Scrappey.com 获取您的 Scrappey API 密钥。
- 配置环境变量：
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 // 等待时间，以毫秒为单位
}
]
}
高级用法
以下是使用这些工具的典型步骤：
- 创建会话：初始化一个新的浏览器会话。
- 发送请求：通过会话发送 HTTP 请求。
- 执行操作：在会话中执行浏览器操作，如点击或输入。
📚 详细文档
最佳实践
- 资源管理：及时销毁不再使用的会话以释放资源。
- 错误处理：捕获并处理可能出现的异常情况。
- 安全性：确保 API 密钥的安全，避免泄露。
常见问题
- 如果无法创建会话，请检查 API 密钥是否有效。
- 如果发送请求失败，请验证目标 URL 和网络配置。
资源信息
- 官方文档：Scrappey 文档
- 支持联系方式：support@scrappey.com
📄 许可证
本项目遵循 MIT 许可证，具体内容请参考 LICENSE 文件。