Web Validator MCP by DigestSEO

DigestSEO の Web Validator

HTML と CSS の検証、テクニカル SEO とアクセシビリティのチェック、JSON-LD 構文の検証、リンク切れのチェック、レスポンシブスクリーンショットに対応する MCP サーバーです。オープンソース SEO ツール群 DigestSEO の一部です。

• 製品：digestseo.com/validator-mcp
• エンジニアリング事例：DigestSEO MCP Suite — AI visibility, Search Console, web validation, and trend intelligence
• ドキュメント：この README
• サポート：digestseo.com/support
• プライバシー：digestseo.com/privacy

適切な接続方法を選ぶ

このリポジトリには、意図的に分離された 2 つの MCP 接続方法があります。

接続方法	トランスポート	最適な用途	アクセスと副作用
ローカル npm サーバー	stdio	Claude Desktop、Cursor、その他のローカル MCP クライアント	ユーザーが選択したワークスペースファイルの読み取り、検証先およびリンク先へのアクセス、スクリーンショットファイルの書き込みが可能です。
ホスト型アプリ	Streamable HTTP	ChatGPT およびリモート MCP クライアント	認証済みの公開 HTML ページを 1 つ取得し、範囲を限定したサイトマップ優先のサイト監査を実行するか、提供されたマークアップを処理できます。ローカルファイルへのアクセス、認証、リンクの再帰的なクロール、ページ JavaScript の実行、スクリーンショットの作成はできません。

ローカルインストール：

npx -y mcp-web-validator

ホスト型エンドポイント：

https://web-validator-mcp.digestseo.com/mcp

要件

• Node.js 22.12.0 以降
• stdio に対応した MCP クライアント、またはホスト型エンドポイント用の Streamable HTTP に対応したクライアント

検証、SEO、スキーマ、リンク、レポートの各ツールは、インストール時にブラウザーをダウンロードしません。ローカルの screenshot.capture ツールは、初回使用時に Puppeteer のキャッシュへ固定バージョンのヘッドレスブラウザーをインストールし、以降のスクリーンショットではそのブラウザーを再利用します。キャッシュ場所をカスタマイズする必要がある場合は、PUPPETEER_CACHE_DIR を設定してください。

ツール

npm パッケージでは、次の正確なランタイムツール名を公開しています。

ツール	用途	ネットワークまたはファイルシステムの動作
html.local	ローカルの HTML または XHTML ファイルを検証します。	選択したファイルを読み込み、そのマークアップを外部の W3C Nu HTML Checker（validator.w3.org/nu/）に送信します。.xhtml パスでは application/xhtml+xml の解析セマンティクスを使用します。
html.url	公開 URL から返されたマークアップを検証します。	URL をフェッチし、返されたマークアップを外部の Nu checker に送信します。
css.local	ローカルの CSS ファイルを検証します。	選択したファイルを読み込み、その CSS を外部の W3C Jigsaw CSS Validator に送信します。
seo.metadata	タイトル、説明、canonical タグ、robots noindex ディレクティブ、見出し、viewport メタデータ、画像の alt 属性、Open Graph メタデータを監査します。	提供された HTML をローカルで処理します。
links.broken	提供された HTML から抽出したリンクを確認します。	条件を満たす公開リンクに対し、件数を制限した HTTP リクエストを送信します。
schema.markup	JSON-LD ブロックを解析し、JSON 構文エラーを報告します。	提供された HTML をローカルで処理します。
report.validation	HTML/XHTML、任意の CSS、SEO、JSON-LD、件数を制限したリンク確認をまとめた Markdown レポートを作成します。	選択したファイルを読み込み、バリデーターに接続し、マークアップ内で見つかった条件を満たす公開リンクを確認します。.xhtml 入力では、Nu 検証に XHTML 解析セマンティクスを使用します。
screenshot.capture	デスクトップ、タブレット、モバイル、またはカスタムのビューポートのスクリーンショットをキャプチャします。	選択したローカルファイルまたは条件を満たす公開 URL を開き、選択した出力ディレクトリに PNG ファイルを書き込みます。一致する既存ファイルは置き換えられる場合があります。

ホステッドアプリのツール

ホステッドアプリでは、8 つのツールを利用できます。

ツール	目的
audit_public_webpage	許可された公開 HTML ページを 1 つ取得し、HTML、SEO／アクセシビリティシグナル、JSON-LD 構文を組み合わせて監査します。リンクチェックは任意です。
audit_public_site	最大 8 件の、許可された同一オリジンの公開ページを対象に、サイトマップを優先する範囲限定の監査を実行します。robots.txt を尊重し、ページのカバレッジと重複を除いた検出結果を簡潔に返します。サイト全体のリンクチェックは実行しません。
validate_html	会話内ですでに提供された生の HTML マークアップを検証します。
validate_css	Worker 内で提供された CSS を解析し、構文エラーを検出します。
audit_seo_metadata	提供された HTML を対象に、対象範囲内のページ内 SEO、robots noindex、アクセシビリティシグナルを監査します。
validate_schema_markup	提供された HTML 内の JSON-LD ブロックを確認し、JSON 構文エラーを検出します。
check_broken_links	提供された HTML から抽出した、許可された公開リンクを最大 20 件チェックします。
generate_validation_report	提供されたマークアップに対するチェックをまとめます。base_url は相対リンクの解決に使用されますが、ページは取得しません。

audit_public_webpage は検証済みのリダイレクトを最大 3 回たどり、サイズ上限内の text/html レスポンスを受け付け、最終 URL を記録します。追加のページのクロール、JavaScript の実行、認証、リンク先のスタイルシートやアセットの取得は行いません。audit_public_site は、まず最終的な公開オリジンを固定し、その後、サイズ上限内の robots.txt と、同一オリジンの XML Sitemap、RSS 2.0、Atom 1.0、プレーンテキストのサイトマップ表現を読み込んでから、1 回の呼び出しで対象となるサイトマップページを最大 8 件監査します。robots の検出では、robots プロトコルの定義に従い、異なるオーソリティにまたがる検証済みの公開リダイレクトを最大 5 回たどる場合があります。取得したルールと相対 Sitemap ディレクティブは、引き続き監査対象のオーソリティに対して解釈されます。サイトマップのエントリと監査対象ページは同一オリジンに限定され、プライベート／予約済みの宛先、認証情報、カスタムポート、サービス自身へのフェッチ、HTTPS から HTTP へのリダイレクトによるダウングレードは拒否されます。このツールは HTML リンクや外部のサイトマップをたどりません。対象となるページがまだ残っているとレスポンスに表示された場合は、page_offset を使用してください。取得した HTML は、validate_html およびレポートツールと同じ外部の Nu HTML Checker である https://html5.validator.nu/ に送信されます。CSS の解析、SEO 分析、JSON-LD の解析は DigestSEO Worker 内で実行されます。任意のリンクチェックでは、対象となる公開 HTTP(S) URL に対して上限付きの HEAD リクエストを行い、必要に応じてサイズ上限内の GET リクエストに切り替えます。リンクのリダイレクトは報告されますが、たどりません。サイトツールは、意図的にサイト全体のリンクチェックを行いません。ホステッドアプリは、ツールへの入力、取得した HTML、結果を保持しません。

プライバシーポリシー

所有している、または確認する権限のあるファイル、マークアップ、公開ウェブページのみを検証してください。公開ページの URL には機密性の高いクエリ値が含まれる場合があるため、送信前にトークンや個人を特定できる情報を削除してください。パスワード、API キー、アクセストークン、決済情報、健康情報、非公開のソースコード、その他の機密性の高い個人データは送信しないでください。

ローカルサーバーは、MCP クライアントと同じオペレーティングシステム権限で動作します。ファイルアクセス、外部への検証リクエスト、リンクチェック、スクリーンショットの作成を承認する前に、ツールへの入力を確認してください。ホステッドアプリは、ローカルファイルシステムにアクセスできません。

データの取り扱いについては、公開されているプライバシーポリシーを、脆弱性を非公開で報告する方法についてはSECURITY.mdを参照してください。

ローカルクライアントの設定

Claude Desktop

claude_desktop_config.json にサーバーを追加します。

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

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

設定を保存した後、Claude Desktop を再起動してください。

Cursor および互換クライアント

コマンド／stdio の MCP サーバーを作成します：

npx -y mcp-web-validator

このリポジトリには、Cursor Marketplace 用のプラグインマニフェストも含まれています。 プラグインの公開後、Cursor の Marketplace から Web Validator by DigestSEO をインストールするか、Cursor のプラグイン UI からリポジトリを追加してください。このプラグインには同じローカル stdio サーバーが含まれており、API キーや環境変数は必要ありません。

OpenAI Codex

Codex CLI では、公開済みのローカル stdio パッケージを直接追加できます：

codex mcp add mcp-web-validator -- npx -y mcp-web-validator

または、既存のホスト型 Streamable HTTP サーフェスを追加することもできます：

codex mcp add mcp-web-validator-hosted --url https://web-validator-mcp.digestseo.com/mcp

どちらの構成も、次のコマンドで確認できます：

codex mcp list

ローカルパッケージには、ワークスペースファイルの検証とレスポンシブなスクリーンショットのキャプチャ機能が含まれています。ホスト型サーフェスはリモート専用のため、ローカルファイルへのアクセスやスクリーンショットの作成はできません。

Gemini CLI

Gemini CLI はローカル stdio MCP サーバーに対応しています。次のコマンドで公開済みパッケージを追加します：

gemini mcp add mcp-web-validator npx -y mcp-web-validator

これにより、サーバー定義が Gemini CLI の MCP 構成に書き込まれます。Web Validator では API キーや環境変数は必要ありません。

GitHub Copilot CLI

次のコマンドで公開済みのローカル stdio サーバーを追加します：

copilot mcp add mcp-web-validator -- npx -y mcp-web-validator

Copilot CLI をこのリポジトリのクローン内で起動した場合、チェックイン済みのルート .mcp.json も検出できます。このファイルでは、すでに mcp-web-validator が npx -y mcp-web-validator を参照しています。

Kiro

これにより、ワークスペースファイルとスクリーンショットの機能を維持したまま、ローカル stdio パッケージがインストールされます。Node.js 22.12.0 以上が必要です。

開発

リポジトリをクローンし、ロックされた依存関係をインストールします：

git clone https://github.com/AKzar1el/mcp-web-validator.git
cd mcp-web-validator
npm ci

ローカルの品質チェックを実行します：

npm run check
npm test
npm run build
npm pack --dry-run

ローカル stdio サーバーを実行します：

npm start

ホスト型 Worker を個別に検証します：

cd chatgpt-plugin
npm ci
npm run check
npm test
npm run deploy:dry-run

コントリビューションに関する要件は、CONTRIBUTING.md を参照してください。デプロイとマーケットプレイスのレビューに関する注意事項は、chatgpt-plugin/SUBMISSION.md に記載されています。 エージェントを利用したインストールについては、llms-install.md を参照してください。

エコシステム

ライセンス

MIT License のもとでライセンスされています。