🔍 Prysm MCP Server

🔍 Prysm MCP サーバー

Prysm MCP（Model Context Protocol）サーバーを使うと、Claude などの AI アシスタントが、高い精度と柔軟性でウェブコンテンツをスクレイピングできます。

✨ 特長

• 🎯 複数のスクレイピングモード：集中型（速度重視）、バランス型（デフォルト）、詳細型（徹底的）のモードから選択できます
• 🧠 コンテンツ分析：URL を分析して、最適なスクレイピング方法を判断します
• 📄 フォーマットの柔軟性：結果を Markdown、HTML、JSON 形式にできます
• 🖼️ 画像対応：画像を抽出したり、ダウンロードしたりできます
• 🔍 スマートスクロール：シングルページアプリケーションのスクロール動作を設定できます
• 📱 レスポンシブ対応：さまざまなウェブサイトのレイアウトや構成に適応します
• 💾 ファイル出力：整形した結果を任意のディレクトリに保存できます

🚀 クイックスタート

インストール

# Recommended: Install the LLM-optimized version
npm install -g @pinkpixel/prysm-mcp

# Or install the standard version
npm install -g prysm-mcp

# Or clone and build
git clone https://github.com/pinkpixel-dev/prysm-mcp.git
cd prysm-mcp
npm install
npm run build

統合ガイド

MCP 対応の主要なアプリケーション向けに、詳細な統合ガイドを用意しています。

• Cursor 統合ガイド
• Claude Desktop 統合ガイド
• Windsurf 統合ガイド
• Cline 統合ガイド
• Roo Code 統合ガイド
• Open WebUI 統合ガイド

使用方法

Prysm MCP サーバーは、複数の方法でセットアップできます。

mcp.json による設定

上記のガイドに従って、適切な場所に mcp.json ファイルを作成します。

{
  "mcpServers": {
    "prysm-scraper": {
      "description": "Prysm web scraper with custom output directories",
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/prysm-mcp"
      ],
      "env": {
        "PRYSM_OUTPUT_DIR": "${workspaceFolder}/scrape_results",
        "PRYSM_IMAGE_OUTPUT_DIR": "${workspaceFolder}/scrape_results/images"
      }
    }
  }
}

🛠️ ツール

サーバーでは、次のツールを利用できます。

scrapeFocused

速度を重視した高速なウェブスクレイピングです（スクロール回数を抑え、メインコンテンツのみを取得します）。

Please scrape https://example.com using the focused mode

利用可能なパラメーター：

• url（必須）：スクレイピングする URL
• maxScrolls（任意）：スクロールを試行する最大回数（デフォルト：5）
• scrollDelay（任意）：スクロール間の待機時間（ミリ秒、デフォルト：1000）
• scrapeImages（任意）：結果に画像を含めるかどうか
• downloadImages（任意）：画像をローカルにダウンロードするかどうか
• maxImages（任意）：抽出する画像の最大数
• output（任意）：ダウンロードした画像の出力ディレクトリ

scrapeBalanced

十分な範囲をカバーしつつ、速度も適度に保つバランス型のウェブスクレイピングです。

Please scrape https://example.com using the balanced mode

利用可能なパラメーター：

• scrapeFocused と同じですが、デフォルト値は異なります
• maxScrolls のデフォルト：10
• scrollDelay のデフォルト：2000
• スクレイピング全体の時間を制限する timeout パラメーターが追加されます（デフォルト：30000ms）

scrapeDeep

最大限の情報を抽出するウェブスクレイピングです（時間はかかりますが、徹底的に取得します）。

Please scrape https://example.com using the deep mode with maximum scrolls

利用可能なパラメーター：

• scrapeFocused と同じですが、デフォルト値は異なります
• maxScrolls のデフォルト：20
• scrollDelay のデフォルト：3000
• maxImages のデフォルト：100

formatResult

スクレイピングしたデータを、Markdown、HTML、JSON などの構造化形式に整形します。

Format the scraped data as markdown

利用可能なパラメーター：

• data（必須）：整形するスクレイピング済みデータ
• format（必須）：出力形式。「markdown」、「html」、または「json」
• includeImages（任意）：出力に画像を含めるかどうか（デフォルト：true）
• output（任意）：整形した結果を保存するファイルパス

出力パスを指定すると、整形した結果をファイルに保存することもできます。

Format the scraped data as markdown and save it to "my-results/output.md"

⚙️ 設定

出力ディレクトリ

デフォルトでは、書式を整えた結果を保存する際、ファイルは ~/prysm-mcp/output/ に保存されます。次の2つの方法でカスタマイズできます。

1. 環境変数：環境変数を設定して、任意のディレクトリを指定します。

# Linux/macOS
export PRYSM_OUTPUT_DIR="/path/to/custom/directory"
export PRYSM_IMAGE_OUTPUT_DIR="/path/to/custom/image/directory"

# Windows (Command Prompt)
set PRYSM_OUTPUT_DIR=C:\path\to\custom\directory
set PRYSM_IMAGE_OUTPUT_DIR=C:\path\to\custom\image\directory

# Windows (PowerShell)
$env:PRYSM_OUTPUT_DIR="C:\path\to\custom\directory"
$env:PRYSM_IMAGE_OUTPUT_DIR="C:\path\to\custom\image\directory"

2. ツールパラメーター：ツールの呼び出し時に出力パスを直接指定します。

# For general results
Format the scraped data as markdown and save it to "/absolute/path/to/file.md"

# For image downloads when scraping
Please scrape https://example.com and download images to "/absolute/path/to/images"

3. MCP の設定：MCP の設定ファイル（例：.cursor/mcp.json）で、これらの環境変数を設定できます。

{
  "mcpServers": {
    "prysm-scraper": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/prysm-mcp"],
      "env": {
        "PRYSM_OUTPUT_DIR": "${workspaceFolder}/scrape_results",
        "PRYSM_IMAGE_OUTPUT_DIR": "${workspaceFolder}/scrape_results/images"
      }
    }
  }
}

PRYSM_IMAGE_OUTPUT_DIR が指定されていない場合は、PRYSM_OUTPUT_DIR 内に images という名前のサブフォルダーがデフォルトで使用されます。

相対パスまたはファイル名のみを指定した場合は、設定済みの出力ディレクトリを基準に保存されます。

パスの処理ルール

formatResult ツールは、次の方法でパスを処理します。

• 絶対パス：指定されたとおりに使用されます（/home/user/file.md）
• 相対パス：設定済みの出力ディレクトリを基準に保存されます（subfolder/file.md）
• ファイル名のみ：設定済みの出力ディレクトリに保存されます（output.md）
• ディレクトリパス：パスがディレクトリを指している場合、コンテンツとタイムスタンプに基づいてファイル名が自動生成されます

🏗️ 開発

# Install dependencies
npm install

# Build the project
npm run build

# Run the server locally
node bin/prysm-mcp

# Debug MCP communication
DEBUG=mcp:* node bin/prysm-mcp

# Set custom output directories
PRYSM_OUTPUT_DIR=./my-output PRYSM_IMAGE_OUTPUT_DIR=./my-output/images node bin/prysm-mcp

npx での実行

インストールせずに、npx でサーバーを直接実行できます。

# Run with default settings
npx @pinkpixel/prysm-mcp

# Run with custom output directories
PRYSM_OUTPUT_DIR=./my-output PRYSM_IMAGE_OUTPUT_DIR=./my-output/images npx @pinkpixel/prysm-mcp

📋 ライセンス

MIT

🙏 クレジット

Pink Pixel によって開発されました。

Model Context Protocol と Puppeteer を利用しています。