superaudit-mcp

MCP（Model Context Protocol）サーバー。SuperAudit の実際の無料監査を、MCP 互換の AI エージェントが呼び出せるツールとして公開します。

これにより、外部の開発者は自分のエージェント（Claude や他の MCP クライアント）に 「このウェブサイトを SuperAudit で監査して」 のようなことを依頼できます。SuperAudit チームの誰とも話す必要はありません。ツールは本番の公開エンドポイントを直接呼び出します。

何をするか

公開するツールは 1 つだけです: audit_website。

• 入力:

  • url（必須）: 監査するドメインまたは URL。例: "minegocio.es" または "https://minegocio.es"。

  • raw_json（任意、boolean、デフォルト false）: true の場合、読みやすい要約に加えて、SuperAudit が返す完全な JSON（すべてのモジュール、すべてのスコア、プラン）を返します。

• 内部で行うこと: POST https://superaudit.airpagents.pro/api/quick-audit を { "web": "<url>" } で呼び出します。これは SuperAudit のランディングページが無料スキャンに現在使用しているのと同じ公開エンドポイントです。API キーやトークンは不要です。

• 出力: グローバルスコア（0〜100）、各約27モジュールのスコア（SEO、セキュリティ、法務/RGPD、Core Web Vitals、WCAG アクセシビリティ、生成 AI での検索順位、WordPress/CVE、OWASP Top 10 など）、検出された主な問題、および結果に応じて SuperAudit が推奨する有料プランを含むテキスト要約。

Related MCP server: foglift-mcp

既知の制限（重要）

• 公開エンドポイントには、SuperAudit サーバー上で IP ごとに毎分 10 リクエストの制限があります。これを超えると、ツールはその旨を示すエラーを返します。サービスに過負荷をかけないよう、自動リトライは行いません。

• バックエンドは監査済みの各ドメインを 24 時間キャッシュするため、同じウェブサイトを短期間にもう一度監査すると即座に結果が返ります。

• 「コールド」監査（キャッシュされていないドメイン）は数秒以上かかることがあります。クライアントは試行を失敗と判断するまで最大 90 秒待機します。

• バックエンドは URL が実際の公開ドメインを指していることを検証します（SSRF 対策としてプライベート IP / localhost をブロックします）。ウェブサイトが存在しないかオンラインでない場合、ツールは読みやすいエラーを返し、黙って失敗することはありません。

インストール（外部開発者向け）

要件: Node.js 18 以上。

git clone <este repositorio>   # o simplemente copia esta carpeta
cd superaudit-mcp
npm install
npm run build

これにより dist/index.js が生成されます。これは MCP サーバーのバイナリです（MCP の標準トランスポートである stdio で通信します）。

単体で試す（任意）

npm run build
node dist/index.js

プロセスは stdio で待機したままになります。これは正常で、MCP サーバーはそのように動作します。MCP クライアントから接続するものであり、対話型 CLI として使うものではありません。

MCP クライアントへの接続方法

Claude Code

claude mcp add superaudit -- node "/ruta/completa/a/superaudit-mcp/dist/index.js"

Claude Desktop

Claude Desktop の設定ファイル（claude_desktop_config.json）を編集して、次を追加します:

{
  "mcpServers": {
    "superaudit": {
      "command": "node",
      "args": ["/ruta/completa/a/superaudit-mcp/dist/index.js"]
    }
  }
}

Claude Desktop を再起動します。会話で必要になったときにエージェントが使用できるよう、audit_website ツールが利用可能になります（例: 「minegocio.es を SuperAudit で監査して」）。

その他の MCP クライアント

stdio による MCP サーバーをサポートするクライアントは、node dist/index.js をサーバーコマンドとして起動できます。追加の設定や環境変数は必要ありません。

環境変数（任意）

• SUPERAUDIT_BASE_URL: デフォルトは https://superaudit.airpagents.pro。独自のテスト環境を指定する場合にのみ変更する意味があります。

API キーは不要です。このツールが使用するエンドポイントは、SuperAudit の公開ランディングページが無料スキャンに使用しているものと同じです。

開発

npm install
npm run build   # compila TypeScript → dist/

この初期成果物には自動テストはありません。実際の MCP クライアント（ハンドシェイク initialize + tools/list

• tools/call) を使って本番エンドポイントに対して手動で検証しました。