superaudit-mcp

SuperAudit의 실제 무료 감사를 MCP 호환 AI 에이전트가 호출할 수 있는 tool로 노출하는 MCP(Model Context Protocol) 서버입니다.

이를 통해 외부 개발자는 SuperAudit 팀과 상담 없이 자신의 에이전트(Claude 또는 기타 MCP 클라이언트)에게 *"이 웹사이트를 SuperAudit으로 감사해줘"*라고 요청할 수 있습니다 — tool이 공개 프로덕션 엔드포인트를 직접 호출합니다.

기능

단일 tool인 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회 요청 제한이 있습니다. 초과 시 tool은 이를 알리는 오류를 반환합니다 — 서비스에 과부하를 주지 않기 위해 자동 재시도하지 않습니다.

• 백엔드는 감사된 각 도메인을 24시간 동안 캐시하므로, 같은 웹사이트를 짧은 시간 내에 다시 감사하면 즉시 완료됩니다.

• "콜드" 감사(캐시되지 않은 도메인)는 수 초 이상 걸릴 수 있습니다: 클라이언트는 실패로 간주하기 전에 최대 90초까지 대기합니다.

• 백엔드는 URL이 실제 공개 도메인을 가리키는지 검증합니다(SSRF 대책으로 사설 IP/localhost 차단) — 웹사이트가 존재하지 않거나 온라인 상태가 아니면 tool은 조용한 실패 대신 읽기 가능한 오류를 반환합니다.

설치(외부 개발자용)

요구 사항: Node.js 18 이상.

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

이 명령은 MCP 서버 바이너리인 dist/index.js를 생성합니다(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 tool이 대화에서 필요할 때 에이전트가 사용할 수 있게 표시됩니다(예: "SuperAudit으로 minegocio.es를 감사해줘").

기타 MCP 클라이언트

stdio를 통한 MCP 서버를 지원하는 모든 클라이언트는 서버 명령으로 node dist/index.js를 실행할 수 있습니다 — 추가 구성이나 환경 변수가 필요 없습니다.

환경 변수(선택 사항)

• SUPERAUDIT_BASE_URL: 기본값은 https://superaudit.airpagents.pro입니다. 자체 테스트 환경을 가리키려는 경우에만 변경하는 것이 의미가 있습니다.

API 키는 필요 없습니다: 이 tool이 사용하는 엔드포인트는 SuperAudit 공개 랜딩 페이지가 무료 스캔에 사용하는 것과 동일합니다.

개발

npm install
npm run build   # compila TypeScript → dist/

이 초기 배포본에는 자동화된 테스트가 없습니다 — 실제 MCP 클라이언트(핸드셰이크 initialize + tools/list + tools/call)로 프로덕션 엔드포인트에 대해 수동으로 검증했습니다.