spa-reader-mcp

spa-reader-mcp

JavaScript SPA ページをレンダリングし、ヘッドレス Chromium を使って Markdown を抽出する MCP サーバーです。

従来のスクレイパーは、コンテンツがクライアント側でレンダリングされるため、SPA では機能しません。このツールは Playwright を起動して JavaScript の実行完了を待った後、Readability + Turndown を使ってクリーンな Markdown を抽出します。

インストール

npx playwright install chromium

Claude Desktop

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

Claude Code

claude mcp add spa-reader -- npx -y spa-reader-mcp

ツール

spa_read

ページをレンダリングし、コンテンツを Markdown として抽出します。

パラメーター	型	デフォルト	説明
url	string	—	読み取る URL（必須）
waitForSelector	string	—	待機する CSS セレクター
waitTimeout	number	30000	タイムアウト（ミリ秒）
includeMetadata	boolean	true	YAML フロントマターを追加
cookies	array	—	認証用 Cookie
headers	object	—	カスタム HTTP ヘッダー

spa_screenshot

JavaScript のレンダリング後に PNG スクリーンショットをキャプチャします。

パラメーター	型	デフォルト	説明
url	string	—	キャプチャする URL（必須）
waitForSelector	string	—	待機する CSS セレクター
waitTimeout	number	30000	タイムアウト（ミリ秒）
width	number	1280	ビューポートの幅
height	number	720	ビューポートの高さ
fullPage	boolean	false	ページ全体をキャプチャ
cookies	array	—	認証用 Cookie
headers	object	—	カスタム HTTP ヘッダー

セキュリティ

• SSRF 保護：プライベート IP とループバック IP をブロックします
• http: と https: スキームのみ許可します
• セレクターインジェクションを防止します
• コンテンツは 100KB までに制限されます

開発

pnpm install && pnpm build
pnpm test

ライセンス

MIT