API Catalog
API Catalog는 RFC 9727의 linkset 형식으로 당신의 API를 나열하고, 각 API의 설명, 문서와 상태 엔드포인트를 가리킵니다.
중요한 이유
당신의 제품을 한 번도 본 적 없는 에이전트가 마케팅 사이트를 읽지 않고도 API가 있다는 사실을 알게 되는 경로입니다.
통과 기준
/.well-known/api-catalog가 최소 하나의 항목을 담은 application/linkset+json을 반환해야 합니다.
검사가 보낸 모든 요청이 기록됩니다 — URL, 메서드, 응답 상태, 관련 헤더와 본문 미리보기 — 그리고 결과에서 해당 검사 아래에 표시됩니다.
구현 방법
Publish an API catalog for automated API discovery (RFC 9727)
/.well-known/api-catalog가 최소 하나의 항목을 담은 application/linkset+json을 반환해야 합니다.
단계별 구현 프롬프트는 Pro 플랜에 포함됩니다.
요금제 보기사이트 스캔하기
이 검사가 당신의 도메인에서 통과하는지, 나머지 21개는 어떤지 확인하세요.
관련 검사
OAuth 검색
/.well-known/oauth-authorization-server 또는 /.well-known/openid-configuration이 사용 가능한 메타데이터를 노출해야 합니다.
OAuth Protected Resource
/.well-known/oauth-protected-resource가 resource와 authorization_servers를 선언해야 합니다.
Auth.md
/auth.md가 존재하고, Markdown H1에서 auth.md를 언급해야 합니다.
MCP Server Card
/.well-known/mcp/server-card.json이 serverInfo.name으로 서버를 설명해야 합니다.
A2A Agent Card
/.well-known/agent-card.json이 name, version과 지원 인터페이스를 선언해야 합니다.
Agent Skills
/.well-known/agent-skills/index.json이 최소 하나의 스킬을 나열해야 합니다.
WebMCP
페이지 코드가 navigator.modelContext를 통해 브라우저 측 도구를 등록해야 합니다.
ARD 매니페스트
/.well-known/ai-catalog.json이 specVersion, host와 최소 하나의 항목을 선언해야 합니다.