Lionscraper MCP + CLI + HTTP API Bridge

🚀 LionScraper MCP + CLI + HTTP API 橋接工具

LionScraper 是一款瀏覽器擴展程序，可從網頁中收集列表、文章、鏈接、圖像等內容。本倉庫提供了三種方式，用於在您的工具和該擴展程序之間建立連接：

• MCP (lionscraper-mcp)：連接 AI 應用程序（例如 Cursor），使模型能夠通過標準輸入輸出調用網頁抓取工具。
• CLI (lionscraper)：在與擴展程序相同的本地 HTTP/WebSocket 端口上，通過終端運行 守護進程、抓取、ping 測試 等操作。
• HTTP API：當守護進程運行時，腳本或任何 HTTP 客戶端可以通過 迴環 JSON HTTP（例如 /v1/...）調用相同的功能，無需使用 MCP 或 CLI 前端。

實際的抓取邏輯在擴展程序中運行；這些包僅用於連接和轉發。

• 官網：lionscraper.com
• npm：lionscraper 包
• PyPI：lionscraper 項目

🚀 快速開始

開始前的準備

1. 瀏覽器：Chrome 或 Edge（需與擴展程序支持的瀏覽器一致）。
2. LionScraper 擴展程序：從應用商店安裝並啟用。
   • Chrome：Chrome 網上應用店 — LionScraper
   • Microsoft Edge：Edge 擴展 — LionScraper
3. 運行環境（可選擇其中一種或兩種實現方式）：
   • Node.js 18+，用於 npm 包 — Node.js
   • Python 3.10+，用於 PyPI 包 — Python
4. 對於 MCP：支持 MCP 的 AI 應用程序（例如 Cursor、Trae）。
5. 對於 HTTP API：與 CLI 使用相同的瀏覽器、擴展程序和守護進程；具體路徑和示例請參閱包的 README 文件。

無 Chrome/Edge 時的 HTTP 備用方案：如果在標準路徑下未檢測到瀏覽器，且擴展程序未連接，MCP 仍可啟動；ping 測試在 http_fetch 模式下成功，scrape* 操作使用最小的服務器端 HTTP GET 請求（不執行 JS）。如果安裝了瀏覽器但擴展程序未連接，仍可進行擴展程序連接流程。Node 自動啟動路徑可修復 Unix 系統中 lionscraper.js 解析時無前導 / 的問題（例如 Glama/Docker）。Python 包使用 aiohttp 與守護進程進行出站 HTTP/WebSocket 通信。

兩種實現方式

您可以選擇安裝其中一個或兩個包；它們是獨立的包，但具有相同的 CLI 命令名稱。

安裝方法

npm 安裝

該包已在 npm 上發佈，包名為 lionscraper。

npm install -g lionscraper

如果不進行全局安裝，MCP 可以使用 npx；具體的 npx JSON 示例請參閱 在您的 AI 應用中添加 MCP。

pip 安裝

該包已在 PyPI 上發佈，包名為 lionscraper。

pip install -U lionscraper

建議使用 虛擬環境，如果您不想安裝到系統解釋器中，也可以使用 pip install -U --user lionscraper。

通用命令

在執行 pip install -U lionscraper 後，如果 lionscraper-mcp 不在您的 PATH 中，可以使用 python -m lionscraper 並 不添加額外參數 來啟動 MCP 標準輸入輸出（具體請參閱 packages/python/README.md）。

PORT（默認值為 13808）必須與擴展程序的 橋接端口 一致。

CLI 快速入門

lionscraper daemon
lionscraper ping
lionscraper scrape -u https://www.example.com

完整的標誌、多 URL 支持、分頁以及 HTTP API 的詳細信息，請參閱 packages/node/README.md 或 packages/python/README.md。

在您的 AI 應用中添加 MCP

以下示例假設 lionscraper-mcp 已在您的 PATH 中（通過 npm 或 pip 安裝）。在 MCP JSON 中，每個 env 值都是字符串。

最小配置（PORT 默認值為 13808；必須與擴展程序的橋接端口一致）

{
  "mcpServers": {
    "lionscraper": {
      "command": "lionscraper-mcp"
    }
  }
}

完整 env 示例（可省略不需要的鍵）

{
  "mcpServers": {
    "lionscraper": {
      "command": "lionscraper-mcp",
      "env": {
        "PORT": "13808",
        "TIMEOUT": "120000",
        "LANG": "en-US",
        "TOKEN": "",
        "DAEMON": ""
      }
    }
  }
}

npx（無需全局安裝）

此方法需要 Node.js；首次運行時可能會下載該包。npm 包名 為 lionscraper，可執行文件為 lionscraper-mcp。使用 command npx，並在 args 中傳遞 lionscraper 和 lionscraper-mcp（在 -y 之後）。

最小配置（npx）

{
  "mcpServers": {
    "lionscraper": {
      "command": "npx",
      "args": ["-y", "lionscraper", "lionscraper-mcp"]
    }
  }
}

完整 env 示例（npx）

{
  "mcpServers": {
    "lionscraper": {
      "command": "npx",
      "args": ["-y", "lionscraper", "lionscraper-mcp"],
      "env": {
        "PORT": "13808",
        "TIMEOUT": "120000",
        "LANG": "en-US",
        "TOKEN": "",
        "DAEMON": ""
      }
    }
  }
}

如果需要指定版本，可以在 args 中使用 "lionscraper@1.0.1" 代替 "lionscraper"。

• PORT：HTTP + WebSocket 監聽端口；默認值為 13808；必須與擴展程序的 橋接端口 一致。
• TIMEOUT：等待前一個實例釋放端口的毫秒數；默認值為 120000；0 表示強制快速接管。
• LANG：工具描述和標準錯誤輸出的語言（en-US、zh-CN 或 POSIX 格式）。
• TOKEN：與守護進程共享的 Bearer 令牌；空值表示無需身份驗證。
• DAEMON：僅當值為 0 時，禁用從輕量級 MCP 自動啟動 lionscraper daemon。

修改配置後，請重啟 MCP 或宿主應用程序。

Python：通過 python -m 使用 MCP

{
  "mcpServers": {
    "lionscraper": {
      "command": "python",
      "args": ["-m", "lionscraper"]
    }
  }
}

請使用安裝該包時使用的 python（在某些系統中可能為 python3）。

匹配瀏覽器擴展程序中的端口

1. 打開 LionScraper 設置 / 選項。
2. 將 橋接端口 設置為與 PORT 相同的值（例如 13808）。
3. 如果需要，可以使用 重新連接、重新加載擴展程序或重啟瀏覽器。

💻 日常使用

1. 確保擴展程序 已啟用，並根據需要打開目標頁面。
2. 使用自然語言進行操作（例如檢查連接、抓取列表 / 文章 / 電子郵件 / 電話號碼 / 鏈接 / 圖像）。
3. 如果出現 “未連接” 或超時提示，請重試連接檢查，並確保 PORT 匹配。

📚 常見問題解答

擴展程序未連接或抓取失敗怎麼辦？

• 擴展程序是否已啟用？
• AI 應用程序中的 PORT 是否與擴展程序的 橋接端口 完全一致？
• 通常每臺機器一個橋接器就足夠了；重複的 MCP 配置可能會導致衝突。

在客戶端看到 MCP 工具是否意味著一切正常？

不一定。工具僅證明 AI → 橋接器 的連接正常；擴展程序還必須在同一端口上註冊。

📄 MCP 註冊表和目錄

官方 MCP 註冊表條目（均使用 server.json）：

發佈大綱（安裝官方 CLI，請參閱 快速入門）：

1. 在每個 server.json 指定的版本下發布 npm / PyPI 包。
2. 在 packages/node 目錄中：執行 mcp-publisher login github，然後執行 mcp-publisher publish。
3. 在 packages/python 目錄中：執行 mcp-publisher publish（複用登錄信息）。

第三方列表（例如 Glama）有其自己的規則；Smithery 默認針對公共 HTTPS/流式設置，而非本地標準輸入輸出 + npm/pip。

🌐 第三方目錄（Glama）

本項目已在 Glama 上列出（例如 Glama 上的 LionScraper）。如果頁面顯示 無法安裝 或 未找到許可證，常見的解決方法包括：添加根目錄下的 LICENSE 文件（本倉庫包含 LICENSE），添加包含維護者 GitHub 用戶名 的 glama.json 文件（glama.json — 如果認領失敗，請編輯 maintainers），在 Glama 上 認領 服務器，並根據需要完成 Glama 的 Docker / 發佈 流程；官方安裝方式仍然是 npm install -g lionscraper 和 pip install -U lionscraper。另請參閱 評分 / 檢查清單頁面。

📄 許可證

本項目採用 MIT 許可證（與 npm 和 PyPI 包相同）。