superaudit-mcp

Сервер MCP (Model Context Protocol), который предоставляет реальный и бесплатный аудит SuperAudit как инструмент (tool), который может вызывать любой ИИ-агент, совместимый с MCP.

Благодаря этому внешний разработчик может попросить своего собственного агента (Claude или другой MCP-клиент) сделать что-то вроде "проведи аудит этого сайта с помощью SuperAudit", не общаясь ни с кем из команды SuperAudit — инструмент напрямую вызывает публичный production-эндпоинт.

Что делает

Предоставляет единственный инструмент: audit_website.

• Входные данные:

  • url (обязательно): домен или URL для аудита, напр. "minegocio.es" или "https://minegocio.es".

  • raw_json (необязательно, boolean, по умолчанию false): если true, помимо читаемого резюме возвращает полный JSON в том виде, в котором его отдаёт SuperAudit (все модули, все оценки, планы).

• Что делает внутри: вызывает POST https://superaudit.airpagents.pro/api/quick-audit с { "web": "<url>" } — тот же публичный эндпоинт, который сегодня использует лендинг SuperAudit для бесплатного сканирования. Не требует никаких ключей или токенов.

• Выходные данные: текстовое резюме с общим баллом (0-100), оценкой каждого из ~27 модулей (SEO, безопасность, юридические вопросы/GDPR, Core Web Vitals, доступность WCAG, позиционирование в генеративном ИИ, WordPress/CVE, OWASP Top 10 и т.д.), основными обнаруженными проблемами и платным планом, который SuperAudit рекомендует по результату.

Related MCP server: foglift-mcp

Известные ограничения (важно)

• Публичный эндпоинт имеет лимит 10 запросов в минуту на IP на сервере SuperAudit. При превышении инструмент возвращает ошибку с указанием причины — он не повторяет попытки автоматически, чтобы не перегружать сервис.

• Бэкенд кэширует каждый проверенный домен в течение 24 часов, поэтому повторный аудит того же сайта в ближайшее время происходит мгновенно.

• «Холодный» аудит (домен не в кэше) может занять несколько секунд: клиент ждёт до 90 секунд, прежде чем считать попытку неудачной.

• Бэкенд проверяет, что URL указывает на реальный публичный домен (блокирует частные IP/localhost как меру против SSRF) — если сайт не существует или не в сети, инструмент возвращает понятную ошибку, а не тихий сбой.

Установка (для внешнего разработчика)

Требования: Node.js 18 или выше.

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

Это создаёт dist/index.js — бинарный файл MCP-сервера (общается через stdio, стандартный транспорт MCP).

Проверить отдельно (необязательно)

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-клиент

Любой клиент, поддерживающий MCP-серверы через stdio, может запустить 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) против production-эндпоинта.