REST API + MCP 서버

개발자와 AI 에이전트를 위한
SEO 리포트 API

REST로 보고서를 생성하고 상태를 폴링하며, 팀이 웹사이트에서 보는 것과 동일한 저장된 보고서 객체를 읽습니다. 같은 API 키로 MCP를 지원하는 모든 에이전트를 연결할 수 있습니다.

접근 모델

무료 계정 + API 키

API 접근은 계정 연동됩니다. 무료 계정을 만들고 API 키를 발급받아 점수 미리보기를 시작하세요. 평가 경로에는 카드가 필요 없습니다.

하나의 보고서 객체

웹사이트 세션, API 호출, 그리고 에이전트 세션은 동일한 저장된 보고서 상태에서 읽습니다.

직관적인 흐름

보고서를 생성하고, 상태를 폴링한 뒤, 동일한 객체에서 미리보기 또는 전체 결과를 읽습니다.

가격 보기

사용 가능한 엔드포인트

POST/api/v1/reports/preview

파트너 및 제품 출시 흐름을 위한 점수 미리보기 생성.

POST/api/v1/reports

새 보고서를 생성하거나 이미 존재하는 보고서를 재사용하십시오.

GET/api/v1/reports/:id

최신 보고서 상태 및 섹션을 가져옵니다.

GET/api/v1/reports/:id/result

보고서가 잠금 해제되면 전체 결과를 읽습니다.

GET/api/v1/reports/:id/download?format=json

프로그램형 통합을 위해 보고서 페이로드를 JSON 형식으로 내보내기.

공식 TypeScript 클라이언트

제로-구성 인증, 무료 등급 준비, 출시 플랫폼 준비.

출시 플랫폼 통합 보기 문서 보기

명령줄

터미널에서 보고서를 실행하세요. 전역 설치 한 번으로 즉시 미리보기.

Bash

npm install -g @seoreport/client

API 키 받기

MCP 서버 — 같은 API, 같은 키

MCP를 지원하는 클라이언트를 https://seoreport.dev/mcp 로 연결하고, REST에서 쓰는 것과 같은 Bearer API 키로 인증하세요. 연결 시 리포트와 계정 도구가 자동으로 제공되므로, 에이전트가 별도의 연결 코드 없이 감사를 실행하고 결과를 읽을 수 있습니다.

MCP 클라이언트 설정JSON

{
  "mcpServers": {
    "seoreport": {
      "url": "https://seoreport.dev/mcp",
      "headers": {
        "Authorization": "Bearer sr__live_your_api_key"
      }
    }
  }
}

create_report

URL에 대한 보고서를 시작하고 작업 ID를 받습니다.

get_report_status

보고서가 준비될 때까지 작업을 폴링합니다.

get_report

완료된 보고서의 점수와 발견 사항을 읽습니다.

list_reports

계정의 보고서 목록을 가져옵니다.

get_report_download

JSON, Markdown, 텍스트, PDF 다운로드 URL을 받습니다.

get_usage

남은 크레딧과 현재 청구 기간을 확인합니다.

결제, 해지, 계정 삭제는 직접 실행되지 않고 브라우저 확인 URL을 반환합니다. 에이전트는 시작할 수 있지만, 완료는 사람만 할 수 있습니다.

에이전트 설정 가이드 전체 API 레퍼런스

예시 응답JSON

{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

빌드 준비 완료?

무료 API 키를 받고 SEO 리포트를 제품에 통합하세요.

보고서 시작 API 키 받기

개발자와 AI 에이전트를 위한SEO 리포트 API