Lionscraper Mcp

LionScraper MCP + CLI + HTTP API ブリッジ

简体中文

• ウェブサイト： lionscraper.com
• npm： パッケージ lionscraper
• PyPI： プロジェクト lionscraper

これは何ですか？

LionScraper は、ウェブページからリスト、記事、リンク、画像などを収集できるブラウザー拡張機能です。このリポジトリでは、お使いのツールと拡張機能をつなぐブリッジを、次の3つの方法で提供します。

• MCP（lionscraper-mcp）：AI アプリ（例：Cursor）を接続し、モデルが stdio 経由でスクレイピングツールを呼び出せるようにします。
• CLI（lionscraper）：拡張機能と同じローカル HTTP/WebSocket ポートを使って、ターミナルから daemon、scrape、ping などを実行します。
• HTTP API：daemon の実行中は、スクリプトや任意の HTTP クライアントから、同じ機能をループバック JSON HTTP（例：/v1/...）経由で呼び出せます。MCP や CLI のフロントエンドは必要ありません。

実際のスクレイピング処理は拡張機能で実行されます。これらのパッケージは接続して処理を中継します。

はじめる前に

1. ブラウザー：Chrome または Edge（拡張機能の対応状況に従ってください）。
2. LionScraper 拡張機能：ストアからインストールして有効にします。
   • Chrome： Chrome Web Store — LionScraper
   • Microsoft Edge： Edge Add-ons — LionScraper
3. ランタイム（どちらか一方、または両方の実装を選択してください）：
   • npm パッケージ用の Node.js 18+ — Node.js
   • PyPI パッケージ用の Python 3.10+ — Python
4. MCP を使う場合：MCP に対応した AI アプリ（例：Cursor、Trae）。
5. HTTP API を使う場合：CLI と同じブラウザー、拡張機能、daemon が必要です。パスと使用例については、パッケージの README を参照してください。

Chrome/Edge を使わない場合の HTTP フォールバック：標準パスにどちらのブラウザーも検出されず、拡張機能も接続されていない場合でも、MCP は起動します。ping は http_fetch モードで成功し、scrape* は最小限のサーバー側 HTTP GET を使用します（JS は実行しません）。ブラウザーがインストール済みで拡張機能が接続されていない場合は、引き続き拡張機能の接続フローが表示されます。Node の自動起動パスでは、lionscraper.js が先頭に / のない状態で解決される Unix 環境（例：Glama/Docker）における問題を修正しています。Python パッケージは、daemon への送信 HTTP/WebSocket 通信に aiohttp を使用します。

2つの実装

	Node.js（npm）	Python（pip）
レジストリ	io.github.dowant/lionscraper-node	io.github.dowant/lionscraper-python
ドキュメント（EN）	packages/node/README.md	packages/python/README.md
ドキュメント（ZH）	packages/node/README_cn.md	packages/python/README_cn.md

一方または両方をインストールしてください。別々のパッケージですが、同じ CLI コマンド名を使用します。

インストール（npm）

npm で lionscraper として公開されています。

npm install -g lionscraper

グローバルにインストールせずに、MCP で npx を使うこともできます。AI アプリに MCP を追加するの npx JSON の例を参照してください。

インストール（pip）

PyPI で lionscraper として公開されています。

pip install -U lionscraper

仮想環境の使用をおすすめします。システムのインタープリターにインストールしたくない場合は、pip install -U --user lionscraper を使用してください。

コマンド（両パッケージ）

コマンド	役割
lionscraper-mcp	AI アプリ向けの軽量な MCP サーバー（stdio）
lionscraper	CLI：daemon、stop、scrape、ping、…（同じポートで HTTP API も提供します）

pip install -U lionscraper の後、lionscraper-mcp が PATH にない場合は、MCP stdio 用に追加の引数を指定せず python -m lionscraper を使用してください（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 には -y の後に lionscraper、続けて lionscraper-mcp を渡してください。

最小構成（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" の代わりに、たとえば "[email protected]" を使用してください。

• PORT：HTTP と WebSocket の待ち受けポート。デフォルトは 13808。拡張機能の ブリッジポート と一致させる必要があります。
• TIMEOUT：前のインスタンスがポートを解放するまで待機する時間（ミリ秒）。デフォルトは 120000。0 を指定すると、すぐに引き継ぎます。
• LANG：ツールの説明と stderr の言語（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 が一致していることを確認してください。

FAQ

拡張機能が接続されない、またはスクレイピングに失敗する場合

• 拡張機能は有効になっていますか？
• AI アプリの PORT は拡張機能の ブリッジポート と正確に一致していますか？
• 通常、1 台のマシンにブリッジは 1 つあれば十分です。MCP 設定が重複すると競合することがあります。

クライアントに MCP ツールが表示されていれば、すべて正常に動作していますか？

必ずしもそうではありません。ツールが確認できるのは AI → ブリッジ までです。拡張機能も同じポートに登録されている必要があります。

MCP レジストリとディレクトリ

公式 MCP レジストリのエントリー（どちらも server.json を使用）：

パス	レジストリ名	パッケージ
packages/node/server.json	io.github.dowant/lionscraper-node	npm: lionscraper（package.json 内の mcpName）
packages/python/server.json	io.github.dowant/lionscraper-python	PyPI: lionscraper（英語版 README.md 内の mcp-name コメント）

公開の概要（公式 CLI をインストールしてください。詳細はクイックスタートを参照してください）：

1. 各 server.json に記載されたバージョンを npm / PyPI に公開します。
2. packages/node で、mcp-publisher login github を実行し、続けて mcp-publisher publish を実行します。
3. packages/python で、mcp-publisher publish を実行します（ログイン状態は引き継がれます）。

サードパーティの掲載先（例：Glama）には、それぞれ独自のルールがあります。Smithery は、デフォルトではローカル stdio と npm/pip のセットアップではなく、パブリック HTTPS／ストリーミング構成を対象としています。

サードパーティのディレクトリ（Glama）

このプロジェクトは Glama に掲載されています（例：Glama 上の LionScraper）。ページにインストールできませんまたはライセンスが見つかりませんと表示される場合は、通常、次の方法で解決できます。ルートに LICENSE を追加します（このリポジトリには LICENSE が含まれています）。組織所有のリポジトリでは、メンテナーの GitHub ユーザー名を記載した glama.json を追加します（glama.json—申し立てに失敗する場合は maintainers を編集してください）。Glama でサーバーの所有権を申請します。また、Glama のインストールとセキュリティ／品質チェックが必要な場合は、任意で Glama の Docker／リリースの手順を完了してください。公式のインストール方法は、引き続き npm install -g lionscraper と pip install -U lionscraper です。スコア／チェックリストのページも参照してください。

ライセンス

MIT（npm および PyPI パッケージと同じです）。