cat aiendpoint.md

aiendpoint: AI 에이전트를 위한 /ai 발견 표준

2026-03 ~ 현재 · 설계·구현·표준 문서 저자 (개인 프로젝트)

웹은 사람의 브라우저를 위해 만들어졌다. AI 에이전트는 근본적으로 다른 클라이언트다. 지금 에이전트가 어떤 웹 서비스를 쓰려면 HTML을 통째로 읽어 수만 토큰 속에서 필요한 몇백 토큰을 찾아내야 한다. aiendpoint는 서비스가 GET /ai에 자기 능력을 기계가 읽는 JSON으로 선언하게 해서 이 일을 수백 토큰으로 끝낸다. robots.txt가 크롤러에게 "하지 말 것"을, sitemap.xml이 "어디 있는지"를 알려줬다면, /ai는 에이전트에게 "무엇을 할 수 있는지"를 알려준다.

세 겹으로 이루어진다. 표준 문서(JSON Schema와 IETF Internet-Draft draft-aiendpoint-ai-discovery, 개인 제출, 2026-03 -00, 2026-07 -01), 레퍼런스 구현(MCP 서버, CLI, Express, Fastify, Next.js, Hono 미들웨어, 프레임워크 플러그인), 그리고 등록된 서비스의 /ai 문서를 모아 두는 커뮤니티 레지스트리다. 레지스트리에는 2026년 7월 기준 3,600여 개 서비스가 올라 있고 npm 패키지 @aiendpoint/mcp-server를 설치하면 에이전트가 어떤 사이트든 같은 방식으로 이해한다. 라이선스는 Apache-2.0.

설계 원칙은 한 문장이다. "에이전트가 HTML을 읽지 않고, GET 한 번과 수백 토큰으로, 어떤 서비스가 무엇을 할 수 있는지 안다." 이 문장에 없는 것(사용법 문서, 인증 흐름, 신뢰·서명, 과금)은 코어에 넣지 않고 포인터만 둔다. 외부 기여 제안이 들어왔을 때 이 원칙을 여섯 개의 검토 질문으로 문서화해 저장소에 두었다.

다음 판(-02)에서는 능력별 문서 포인터와 OpenID Connect 인증 유형을 검토 중이다.

스택: Node.js, Fastify 5, TypeScript, Next.js, Supabase(PostgreSQL), Upstash Redis, Vercel, Railway. 모노레포(pnpm + Turborepo).