문서

참조 에이전트, MCP & API

귀하의 웹사이트, REST API 또는 MCP에서 AI SEO 보고서를 실행하고, 모든 유료 플랜에서 하나의 키로 모든 기능을 이용하십시오.

처음이신가요? 개발자 페이지에서는 엔드포인트 레퍼런스에 들어가기 전에 접근 모델을 설명합니다. SEO 보고서 API 개요 읽기

인증

모든 요청은 Bearer 토큰이 필요합니다. API 키는 유료 플랜에서 제공되며, 계정 설정에서 하나를 생성할 수 있습니다. 새 사이트마다 플랜의 크레딧 하나를 사용하며, 이는 매월 첫 날(UTC)에 리셋되고 롤오버되지 않습니다.

Header· http

Authorization: Bearer sr__live_your_api_key

예시 요청

curl· bash

curl -X POST https://seoreport.dev/api/v1/reports \
  -H "Authorization: Bearer sr__live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "example.com"}'

REST API 엔드포인트

기본 URL: https://seoreport.dev

POST/api/v1/reports새 보고서를 만들거나 기존 보고서를 재사용하세요. 대신 사이트를 다시 스캔하려면 "forceRerun": true를 추가하세요.

GET/api/v1/reports/:id보고서 상태 및 섹션을 가져옵니다.

GET/api/v1/reports/:id/result전체 결과 페이로드를 읽습니다.

GET/api/v1/reports/:id/download?format=pdf|md|txt|json렌더링된 보고서를 PDF, Markdown, 텍스트 또는 JSON 형식으로 다운로드하세요.

PUT/api/v1/monitors도메인에 대한 주간 모니터링을 시작합니다; "enabled": false는 일시 중지합니다.

GET/api/v1/monitors이 계정이 모니터링하는 도메인 목록을 표시합니다.

DELETE/api/v1/monitors?url=도메인 모니터링을 중지하고 저장된 결과를 삭제합니다.

예시 응답

response.json· json

{
  "success": true,
  "report": {
    "jobId": "3f6c2a1e-8d4b-4c7a-9e21-5b0d7f4a6c18",
    "status": "completed",
    "targetUrl": "https://example.com"
  },
  "pollAfterMs": 0
}

결과 읽기

report.status 값이 completed이면 결과 엔드포인트가 전체 보고서를 반환합니다. 발견 사항은 report.view.sections 중 키가 full_findings인 항목의 detail.findings에 있습니다. 텍스트 필드는 보고서 언어로 작성됩니다.

result.json· json

{
  "success": true,
  "report": {
    "jobId": "3f6c2a1e-8d4b-4c7a-9e21-5b0d7f4a6c18",
    "status": "completed",
    "targetUrl": "https://www.example.com/",
    "auditedAt": "2026-10-11T09:14:03.000Z",
    "score": { "overall": 72 },
    "view": {
      "sections": [
        {
          "key": "full_findings",
          "state": "ready",
          "detail": {
            "findings": [
              {
                "status": "fail",
                "areaLabel": "URL signals",
                "title": "Canonical tag missing",
                "whyItMatters": "Canonical tags tell search engines which version of a page should appear in results.",
                "fix": "Add a canonical link element or Link HTTP header pointing to the preferred URL for this page."
              }
            ]
          }
        }
      ]
    }
  }
}

report.targetUrl: 실제로 감사한 주소입니다. 같은 도메인 안의 리디렉션은 따라가므로, 보낸 URL과 다를 수 있습니다.
report.auditedAt: 감사가 실행된 시각(ISO 8601 타임스탬프).
report.score.overall: 0~100 사이의 종합 점수.
report.view.sections[].state: 섹션 내용을 사용할 수 있는지 나타냅니다. 상태가 ready가 될 때까지 detail 값은 null입니다.
findings[].status: 발견 사항의 결과: fail, warn, pass, info.
findings[].areaLabel: 발견 사항과 관련된 사이트 영역.
findings[].title: 발견 사항을 한 줄로 요약한 내용.
findings[].whyItMatters: 이 발견 사항이 검색 및 AI 노출에 중요한 이유.
findings[].fix: 변경할 내용. 실패 및 경고 발견 사항에는 값이 있고, 나머지는 비어 있습니다.

결과에는 이보다 많은 필드가 있습니다. 여기 나열된 필드를 기준으로 구현하세요. 나머지는 문서화되지 않았으며 변경될 수 있습니다.

참조 에이전트, MCP & API

인증

예시 요청

REST API 엔드포인트

예시 응답

결과 읽기

에이전트를 MCP URL에 연결하세요