For Agents & Developers
WISP Content API
WISP 사이트의 내용을 AI 에이전트와 프로그램이 읽기 쉬운 형태로 제공하는 읽기 전용 API입니다. 인증이 필요 없고, 모든 요청은 GET 입니다.
info
이 API는 정적 파일로 제공되며, 응답은 사이트를 마지막으로 배포한 시점의 내용입니다. 각 앱(voice-lock, drover 등)의 서버 API는 앱 전용이라 공개하지 않습니다.
엔드포인트
| 경로 | 형식 | 내용 |
|---|---|---|
/llms.txt | text/plain | 사이트 개요와 전체 페이지 목록. 에이전트가 처음 읽기에 좋은 출발점입니다. |
/{page}.md | text/markdown | 각 페이지 본문의 Markdown 사본. 예: /project-drover.md, 홈은 /index.md |
/sitemap.xml | application/xml | 전체 페이지 목록과 최종 수정일 |
/api/status.json | application/json | 상태 확인. {"status": "ok"} |
/api/openapi.json | OpenAPI 3.1 JSON | 이 API의 기계 판독용 명세 |
/.well-known/api-catalog | application/linkset+json | API 카탈로그 (RFC 9727) |
사용 예
- 사이트 전체 파악:
curl https://www.j2w2.org/llms.txt - 특정 프로젝트 읽기:
curl https://www.j2w2.org/project-voicelock.md - API 찾기:
curl https://www.j2w2.org/.well-known/api-catalog
이용 조건
- 검색, AI 답변을 위한 참조·인용, AI 모델 학습 모두 허용합니다(robots.txt의 Content-Signal:
ai-train=yes, search=yes, ai-input=yes). - 과도한 반복 요청은 삼가 주세요. 내용은 배포할 때만 바뀌므로 캐시해 두고 써도 됩니다.
- 문의: [email protected]