Developer Resources

Hermes by inlevel9 API · OpenAPI · MCP

에이전트와 개발자가 Hermes의 공개 검색 준비도 진단을 발견하고 안전하게 연동하는 데 필요한 공식 문서입니다.

Hermes Scan API

Hermes by inlevel9는 공개 웹사이트의 검색 준비도 진단을 시작하고 진행 상태를 확인하는 HTTP API를 제공합니다. POST /api/scans에 JSON 형식으로 url을 보내면 요청이 검증된 뒤 202 Accepted와 scanId를 반환합니다. GET /api/scans/{scanId}는 현재 단계, 진행률, 완료 시 결과 페이지 경로를 반환합니다. 무료 API는 인증 키 없이 사용할 수 있지만 IP와 도메인 조합을 기준으로 요청량을 제한하며, 과도한 요청에는 429를 응답합니다.

대상은 HTTPS 또는 HTTP로 접근 가능한 공개 도메인이어야 합니다. localhost, 사설 IP, 링크 로컬 주소, 사용자 이름이나 비밀번호가 포함된 URL은 보안상 거부합니다. 요청 본문은 8KB를 넘을 수 없고 URL은 2,048자 이하이어야 합니다. 진단은 비동기로 진행되므로 202 응답을 받은 뒤 상태 API를 합리적인 간격으로 조회해야 합니다.

curl -X POST https://hermes.inlevel9.com/api/scans \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

OpenAPI 및 인증

기계가 읽을 수 있는 OpenAPI 3.1 문서는 /openapi.json에 있습니다. 현재 문서화된 공개 진단 API에는 API 키나 OAuth가 필요하지 않습니다. 로그인과 결제가 필요한 주문·보고서 기능은 브라우저 제품 흐름을 위한 기능이며 공개 개발자 API로 약속하지 않으므로 OpenAPI 문서에서 제외합니다. 호환성을 위해 응답 필드를 임의로 추정하지 말고 OpenAPI 스키마와 실제 HTTP 상태 코드를 기준으로 처리하세요.

curl https://hermes.inlevel9.com/api/scans/{scanId}

Hermes MCP server

MCP를 지원하는 에이전트는 https://hermes.inlevel9.com/.well-known/mcp 또는 같은 서버의 /mcp를 Streamable HTTP endpoint로 연결할 수 있습니다. 서버는 현재 MCP 2026-07-28 프로토콜을 기본으로 제공하고 2025년형 Streamable HTTP 클라이언트와도 호환됩니다. server/discover 또는 기존 initialize 요청으로 서버 정보와 capabilities를 확인한 뒤 tools/list를 호출하세요.

MCP 도구는 이미 공개 보고서가 존재하는 웹사이트의 검색 준비도 결과를 읽는 용도에 적합합니다. 새 진단처럼 오래 걸리고 외부 상태를 만드는 작업은 REST Scan API나 Hermes 웹 화면에서 시작하는 것이 안전합니다. 도구 결과가 없다고 응답하면 POST /api/scans로 진단을 요청하고 완료된 결과 페이지를 확인하세요.

웹훅과 지원 범위

현재 제3자 개발자를 위한 공개 웹훅은 제공하지 않습니다. 결제사 콜백과 내부 주문 경로는 공개 통합 지점이 아니며 호출해서는 안 됩니다. API 변경, 대량 사용, 상업적 재배포, 보안 제보 또는 별도 연동이 필요하면 contact@inlevel9.com으로 제품명 Hermes, 사용 목적, 예상 요청량과 재현 가능한 예시를 보내 주세요.