getAdvantage MCP

API 및 MCP 문서

자체 코드, CI, 또는 AI 편집기 내부에서 세 가지 Advantage 스캔을 실행하세요. Get Found는 AI가 라이브 URL을 어떻게 읽는지 측정합니다. Convert는 처음 방문한 사용자가 가입할지 여부를 측정합니다. Ship Verified는 페이지가 배포했지만 배포하지 말았어야 할 항목을 확인합니다. 모든 결과는 스캔 시점의 관찰 측정값입니다 — 평결, 인증, 또는 보증이 절대 아닙니다.

API는 키 없이 IP당 요율로 무료로 사용해 볼 수 있습니다. API 키는 요율을 플랜 등급으로 올리고 유료 플랜에서는 라이브 모델 출력을 반환합니다. 기계가 읽을 수 있는 사양은 /api/openapi.json에 있습니다.

한 번만 연결하면 되는 이유는? AEO를 수동으로 유지 관리하지 않아도 되기 때문입니다. 임베드 또는 API 호출 하나를 CI에 넣으면 DOM 안전 수정(JSON-LD, meta, FAQ)이 계속 자동 적용됩니다. ChatGPT, Perplexity, Gemini & Claude가 사이트를 읽는 방식을 변경할 때마다 다시 확인하므로, 대상을 쫓지 않아도 점수가 최신 상태로 유지됩니다. 중립적인 도구가 AI 가시성 및 배포 안전성을 지속적으로 감시합니다 — 일회성 감사가 아닌 독립적인 감독입니다. (llms.txt와 robots.txt는 한 번 배치하면 그대로 유지되는 파일입니다.)

인증

/app/api-keys에서 키를 생성하세요(한 번만 표시됨 — 환경 비밀로 저장하고 절대 커밋하지 마세요). 모든 요청에 Bearer 토큰으로 전송하세요:

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com" \
  -H "Authorization: Bearer adv_live_…"

헤더가 없으면 키 없는 무료 등급(IP당 요율, 샘플링된 출력)을 받습니다. 키가 있으면 요율은 플랜을 따르며 유료 플랜은 라이브 모델 출력을 반환합니다. 한도를 초과하면 HTTP 429 및 retry-after 헤더가 반환되고, 잘못된 키는 401를 반환합니다.

요율 제한

제한은 요청 시점에 키당(또는 키 없는 경우 IP당) 관찰됩니다:

• 키 없음: 분당 5회 · 일당 30회, 샘플링된 출력
• Starter: 분당 60회 · 일당 1,000회, 라이브 출력
• Pro: 분당 120회 · 일당 5,000회, 라이브 출력
• Agency: 분당 240회 · 일당 20,000회(공정 사용), 라이브 출력

결합 엔드포인트는 동일한 엔진별 요율로 한 번의 틱으로 계산됩니다(한 번의 호출에 세 번 청구되지 않음).

엔드포인트

GET /api/analyze?url=

Get Found — AI 가독성 스캔(9개 신호)

AI 엔진이 페이지를 얼마나 읽기 쉽게 인식하는지 9개 신호(제목, 메타 설명, 구조화된 데이터, 헤딩, llms.txt, 콘텐츠 대 마크업 비율, Open Graph, canonical, robots)로 점수를 매깁니다. 신호별 분석, 붙여넣기 준비된 수정 사항, 생성된 시작용 llms.txt를 반환합니다.

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET /api/verify-convert?url=

Convert — 전환 준비 상태 + 5초 콜드 리드

처음 방문한 사용자가 앱을 이해하고 가입할지 결정하는 신호를 점수로 매깁니다. 유료 키에서는 에이전트 기반 5초 첫인상 테스트도 실행합니다. 체크, 수정 사항, 벤치마크 백분위수, 공유 가능한 /v 보고서를 반환합니다.

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET /api/verify-safety?url=

Ship Verified — 배포 안전성 체크 + 배지

일반적인 vibe-coded 노출(클라이언트 번들의 비밀, 백엔드 구성, 노출된 파일, 보안 헤더, CORS, 전송, 소스 맵)에 대한 결정론적 체크를 실행합니다. 통과 체크는 해당 특정 문제를 찾지 못했음을 의미합니다 — 앱이 안전하거나 인증되었음을 의미하지 않습니다. 체크, 수정 사항, 벤치마크 백분위수, /v 보고서, "Checked by Advantage" 배지를 반환합니다.

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST /api/v1/scan/combined

Combined — 세 엔진 모두, 한 번의 호출

하나의 URL에 대해 세 엔진을 모두 실행하고 하나의 페이로드를 반환합니다: 세 개의 독립적인 점수 블록(절대 평균화되지 않음), 가장 약한 차원과 가장 큰 다음 단계를 명명하는 교차 요약, 하나의 영구 링크. 단일 요청으로 전체 그림을 얻는 가장 빠른 방법입니다.

curl -X POST "https://getadvantage.app/api/v1/scan/combined" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer adv_live_…" \
  -d '{"url":"https://yourapp.com"}'

MCP 서버 — 편집기 내부에서 스캔

Advantage는 Model Context Protocol 서버이기도 하므로 Claude Code, Cursor, Claude Desktop 또는 Windsurf에 한 번 추가하고 *"getadvantage로 내 앱 스캔"*이라고 입력하기만 하면 됩니다. 원격 Streamable HTTP(현재 공식 원격 전송)를 사용하며 — 설치가 필요 없고 스캔은 당사 서버에서 실행됩니다. 네 가지 도구를 노출합니다: get_found, convert_check, ship_verified, combined_scan. 각 도구는 점수와 가장 큰 붙여넣기 준비된 수정 사항으로 시작하며 보고서 링크를 포함합니다.

추가 방법 (Cursor / Claude Desktop / Claude Code)

MCP 클라이언트 구성에 다음을 넣으세요:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp"
    }
  }
}

API 키 사용 시(더 높은 요율, 라이브 출력), 헤더를 추가하세요:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp",
      "headers": { "Authorization": "Bearer adv_live_…" }
    }
  }
}

또는 Claude Code에서 한 줄로:

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

MCP 서버는 키 없이 키 없는 요율로 무료로 사용해 볼 수 있습니다. 키는 요율을 높이고 HTTP API와 정확히 동일하게 라이브 출력을 반환합니다.

사이트를 추적하고, 기록을 보고, 임베드를 통해 수정 사항을 자동 적용하고 싶으신가요? 계정 만들기 — 또는 앱 하나 무료로 스캔하세요.