Playwright Fetch

🚀 Playwright Fetch MCP Server

このプロジェクトは、Playwrightを使用したブラウザ自動化によりウェブコンテンツの取得機能を提供するModel Context Protocolサーバーです。このサーバーを使用すると、LLMがウェブページからJavaScriptでレンダリングされたコンテンツを取得し、HTMLをより使いやすいMarkdown形式に変換することができます。

🚀 クイックスタート

このサーバーを使用することで、LLMがJavaScriptでレンダリングされたウェブページのコンテンツを取得し、Markdown形式に変換することができます。以下の手順に従ってインストールしてください。

✨ 主な機能

• ブラウザ自動化：Playwrightを使用して、完全なJavaScriptサポートでウェブページをレンダリングします。
• コンテンツ抽出：ウェブページから自動的に主要なコンテンツ領域を識別して抽出します。
• Markdown変換：HTMLをクリーンで読みやすいMarkdownに変換します。
• ページネーションサポート：ページネーションを通じて大量のコンテンツを処理します。
• robots.txt準拠：自律的な取得においてrobots.txtの指示に従います。
• プロキシサポート：プロキシサーバーを介してリクエストをルーティングできます。
• Docker対応：Docker Hub と GitHub Container Registry から事前にビルドされたDockerイメージを利用できます。

📦 インストール

1. uvを使用したインストール（推奨）

uv pip install git+https://github.com/ThreatFlux/playwright-fetch.git
# Playwrightブラウザのインストール
uv pip exec playwright install

または、リポジトリをクローンしてインストールすることもできます。

git clone https://github.com/ThreatFlux/playwright-fetch.git
cd playwright-fetch
uv pip install -e .
# Playwrightブラウザのインストール
uv pip exec playwright install

2. Dockerを使用したインストール

Docker HubまたはGitHub Container Registryから事前にビルドされたDockerイメージを使用することができます。

# Docker Hubからの取得
docker pull threatflux/playwright-fetch:latest

# GitHub Container Registryからの取得
docker pull ghcr.io/threatflux/playwright-fetch:latest

または、自分でビルドすることもできます。

docker build -t threatflux/playwright-fetch .

📚 ドキュメント

Claude.app用の設定

Claudeの設定に以下を追加してください。

"mcpServers": {
  "playwright-fetch": {
    "command": "uvx",
    "args": ["mcp-server-playwright-fetch"]
  }
}

"mcpServers": {
  "playwright-fetch": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "threatflux/playwright-fetch"]
  }
}

VS Code用の設定

手動でインストールする場合は、VS Codeのユーザー設定（JSON）ファイルに以下のJSONブロックを追加してください。

{
  "mcp": {
    "servers": {
      "playwright-fetch": {
        "command": "uvx",
        "args": ["mcp-server-playwright-fetch"]
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "playwright-fetch": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "threatflux/playwright-fetch"]
      }
    }
  }
}

コマンドラインオプション

サーバーは以下のコマンドラインオプションをサポートしています。

• --user-agent：カスタムユーザーエージェント文字列
• --ignore-robots-txt：robots.txtの制限を無視する
• --proxy-url：リクエストに使用するプロキシURL
• --headless：ヘッドレスモードでブラウザを実行する（デフォルト: True）
• --wait-until：ナビゲーションが成功したと見なすタイミング（選択肢: "load", "domcontentloaded", "networkidle", "commit", デフォルト: "networkidle"）

💻 使用例

基本的な使用法

# デフォルト設定で実行
uv run mcp-server-playwright-fetch

# カスタムユーザーエージェントとプロキシを使用して実行
uv run mcp-server-playwright-fetch --user-agent="MyCustomAgent/1.0" --proxy-url="http://myproxy:8080"

# デバッグ用に可視ブラウザで実行
uv run mcp-server-playwright-fetch --headless=false

高度な使用法

# MCPインスペクターを使用してサーバーをデバッグする
npx @modelcontextprotocol/inspector uvx mcp-server-playwright-fetch

🔧 技術詳細

この実装は、標準のフェッチMCPサーバーと以下の点で異なります。

1. ブラウザ自動化：Playwrightを使用してJavaScriptが多いページをレンダリングします。
2. コンテンツ抽出：一般的なページ構造から主要なコンテンツを抽出しようとします。
3. 待機オプション：ページの読み込み戦略を設定可能（ロード、DOMコンテンツ、ネットワークアイドルを待つ）
4. 可視ブラウザオプション：デバッグ用に可視ブラウザで実行できます。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。

作者

Wyatt Roersma がClaude Codeの支援を受けて作成しました。

利用可能なツール

• playwright-fetch - Playwrightのブラウザ自動化を使用してURLを取得し、そのコンテンツをMarkdownとして抽出します。
  • url (文字列、必須): 取得するURL
  • max_length (整数、オプション): 返す最大文字数（デフォルト: 5000）
  • start_index (整数、オプション): この文字インデックスからコンテンツを開始する（デフォルト: 0）
  • raw (ブール値、オプション): Markdown変換なしで生のコンテンツを取得する（デフォルト: false）
  • wait_for_js (ブール値、オプション): JavaScriptの実行を待つ（デフォルト: true）

プロンプト

• playwright-fetch
  • Playwrightを使用してURLを取得し、そのコンテンツをMarkdownとして抽出します。
  • 引数:
    • url (文字列、必須): 取得するURL

必要条件

• Python 3.13.2以上
• uv パッケージマネージャー
• Playwrightブラウザのインストール