SyteCheck

SyteCheck MCP サーバー

Claude、Cursor、その他の MCP クライアントからウェブサイトを監査し、対応に活用できるテキスト形式で 結果を取得できます。

SyteCheck は、HTML の妥当性、SEO、リンク切れ、アクセシビリティ（axe-core による WCAG 2.2 AA）、パフォーマンス （実際の Lighthouse 実行）、セキュリティヘッダー、レスポンシブレイアウト、AI からの見つけやすさ、 コンテンツの鮮度、ビジュアルデザインに関する AI の批評という 10 の観点からページをスキャンし、スコア付きの 平易なレポートを返します。

無料アカウントでも利用できます。 クレジットカード不要で、試用期間もありません。無料プランでは 3 カテゴリーにわたって月 3 回スキャンできるため、 設定して実際のレポートを確認してから、有料プランにするかを決めるのに十分です。

クイックスタート

1. sytecheck.app でアカウントを作成し、メールアドレスを確認します。
2. 「Account → API keys」でキーを発行します。モデルに既存のスキャン結果を読み取らせるだけで、クォータを消費させたくない場合は、 scans:read のみを選択してください。シークレットは一度だけ表示されます。
3. 以下の設定例のいずれかを使って、サーバーをクライアントに追加します。

Claude Code

claude mcp add sytecheck --env SYTECHECK_API_KEY=sck_your_key_here \
  -- npx -y @ascentws/sytecheck-mcp

Claude Desktop

claude_desktop_config.json を編集します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "sytecheck": {
      "command": "npx",
      "args": ["-y", "@ascentws/sytecheck-mcp"],
      "env": { "SYTECHECK_API_KEY": "sck_your_key_here" }
    }
  }
}

Cursor

プロジェクト内の .cursor/mcp.json、またはグローバル設定に追加します。

{
  "mcpServers": {
    "sytecheck": {
      "command": "npx",
      "args": ["-y", "@ascentws/sytecheck-mcp"],
      "env": { "SYTECHECK_API_KEY": "sck_your_key_here" }
    }
  }
}

Gemini CLI / Antigravity CLI

~/.gemini/settings.json（または Antigravity に相当する設定ファイル）に追加します。

{
  "mcpServers": {
    "sytecheck": {
      "command": "npx",
      "args": ["-y", "@ascentws/sytecheck-mcp"],
      "env": { "SYTECHECK_API_KEY": "sck_your_key_here" }
    }
  }
}

OpenAI Agents SDK

from agents import Agent
from agents.mcp import MCPServerStdio

sytecheck = MCPServerStdio(
    params={
        "command": "npx",
        "args": ["-y", "@ascentws/sytecheck-mcp"],
        "env": {"SYTECHECK_API_KEY": "sck_your_key_here"},
    }
)

agent = Agent(
    name="Site auditor",
    instructions="Audit sites with SyteCheck and explain what to fix.",
    mcp_servers=[sytecheck],
)

次に、_「https://example.com をスキャンして、最初に修正すべき点を教えてください。」_と尋ねてください。

ツール

ツール	機能
run_scan	URL を送信し、レポートができるまで待機します。クォータを消費します。
get_scan_report	スキャン ID の全検出結果を取得します。run_scan が実行中のままになったスキャンを収集する方法です
list_scans	スキャン履歴を新しい順に表示し、絞り込みもできます
get_scan_trends	繰り返しスキャンした URL ごとのスコア履歴を表示します
list_categories	SyteCheck でチェックできる項目と、プランに含まれる内容を表示します
get_account_usage	今月の残りスキャン回数と、クォータのリセット日時を表示します

URL をスキャンして、検出結果を優先順位付きの修正計画にまとめる**scan-and-remediate プロンプト**もあります。

コストについて

run_scan だけがコストを発生させるツールで、実際に費用がかかります。スキャンではブラウザーを起動し、Lighthouse を実行して、ビジョンモデルを呼び出します。読み取り専用ではないものとして設定されているため、実行前にクライアントから確認があり、ツールの説明ではモデルに残りのクォータを先に確認し、変更のないページを再スキャンしないよう指示しています。無料アカウントで利用できるのは月 3 回のスキャンです。エージェントが run_scan を繰り返し実行すると、1 回のターンで使い切ってしまいます。

無人で動作するものにキーを渡す場合は、scans:read キーを発行してください。このキーではスキャンを作成できません。

設定

変数	デフォルト	用途
SYTECHECK_API_KEY	(required)	sck_ API キー
SYTECHECK_API_URL	https://api.sytecheck.app	API ベース URL
SYTECHECK_WAIT_TIMEOUT_MS	60000	run_scan がスキャン ID を返すまで待機する時間
SYTECHECK_POLL_INTERVAL_MS	3000	待機中にステータスを確認する間隔

API のホストは sytecheck.app ではなく、api.sytecheck.app です。後者は ウェブアプリを提供しており、API パスに対して「ページが見つかりません」画面を返します。

API を直接使用する

MCP サーバーは、直接呼び出せる通常の HTTP API を利用する薄いクライアントです。

• docs/API.md — 認証、スキャンの送信、ポーリング、ウェブフックとその署名検証、レート制限、バージョン管理を網羅した開発者向けガイドです。
• public-openapi.json — クライアントの生成に使える OpenAPI 3.1 仕様です。
• examples/ — curl、Python、Node、Java、C# の実行可能なクライアントと、配信署名を検証するウェブフック受信サーバーです。
• インタラクティブドキュメント：Swagger UI · ReDoc

開発

npm install
npm run build
npm test
npm run lint

ローカルの SyteCheck インスタンスを使用して実行するには：

SYTECHECK_API_KEY=sck_… SYTECHECK_API_URL=http://localhost:8000 node dist/index.js

サーバーは標準入力と標準出力を介して JSON-RPC を使用するため、プロトコルメッセージ以外は標準出力に書き込めません。余計な console.log があるとストリームが破損し、クライアントは分かりにくい解析エラーで切断されます。診断情報は標準エラー出力に書き込んでください。

セキュリティ

キーの取り扱い、漏えいしたキーで可能なことと不可能なこと、脆弱性の報告方法については、SECURITY.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。ライセンスの対象はこのコードです。SyteCheck の名称とマークは Ascent Web Solutions の商標であり、サービスの利用には 利用規約 が適用されます。詳細な条件については TRADEMARK.md を参照してください。