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 文件。