개발자

INLEVEL9 Letter 개발자 안내

최종 업데이트: 2026-08-23

INLEVEL9 Letter는 공개 콘텐츠를 기계가 읽을 수 있는 형태로 함께 제공합니다. 별도 API 키나 신청 절차는 없습니다. 아래 공개 표면은 모두 인증 없이 공개 콘텐츠만 다룹니다.

인증이 필요한 API는 공개하지 않습니다. 멤버십 전용 본문은 어떤 경로로도 나가지 않으며, 잠긴 호는 웹에서 비로그인 방문자가 보는 범위까지만 제공됩니다.

INLEVEL9 Letter OpenAPI 3.1

공개 읽기 API는 OpenAPI 3.1 JSON으로 설명합니다. 각 작업은 고유한 operationId, 설명, 타입이 지정된 매개변수와 응답 스키마를 갖습니다. 운영자·구독자·결제·발송 API는 의도적으로 포함하지 않습니다.

OpenAPI 명세: https://letter.inlevel9.com/openapi.json

curl "https://letter.inlevel9.com/api/search?q=AI&locale=en&limit=5"

구조화된 JSON 오류

공개 API 오류는 application/problem+json으로 답하고, 모든 응답에 안정적인 code, 사람이 읽는 message, 에이전트가 바로 실행할 수 있는 resolution을 넣습니다. 존재하지 않는 /api/* 경로도 HTML 오류 페이지 대신 같은 형식을 사용합니다.

{
  "code": "invalid_locale",
  "message": "locale must be one of ko, en, zh-CN.",
  "resolution": "Choose a locale listed in the OpenAPI parameter schema."
}

마크다운 콘텐츠 협상 (INLEVEL9 Letter)

공개 페이지 아무 URL에나 Accept: text/markdown을 보내면 HTML 대신 마크다운을 받습니다. sitemap에 있는 페이지는 전부 해당합니다 — 개별 호, 세 판의 홈, 아카이브, 주제·분류 목록, 소개·연락처·개발자·개인정보·약관 페이지. 응답에는 Content-Type: text/markdown; charset=utf-8과 Vary: Accept가 붙습니다. 개별 호는 정본 URL·발행일·호수를 담은 YAML frontmatter와 함께 옵니다. HTML과 마크다운을 모두 거절하는 Accept에는 406으로 답합니다.

curl -H "Accept: text/markdown" https://letter.inlevel9.com/

INLEVEL9 Letter MCP 서버

Model Context Protocol 2026-07-28 서버를 Streamable HTTP로 제공합니다. 최신 클라이언트는 server/discover와 요청별 _meta를 사용하며, 기존 initialize 기반 클라이언트도 지원합니다. Claude·ChatGPT 등 MCP를 지원하는 클라이언트에 아래 URL을 등록하면 이 뉴스레터를 도구로 호출할 수 있습니다. 인증은 없습니다.

디스커버리 문서	https://letter.inlevel9.com/api/mcp-manifest
엔드포인트 (Streamable HTTP)	https://letter.inlevel9.com/.well-known/mcp

curl -X POST "https://letter.inlevel9.com/.well-known/mcp" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  --data '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

제공하는 도구

`search_issues`	Full-text search across published INLEVEL9 Letter issues. Use when you need to find whether this newsletter has covered a specific company, technology, policy, or event.
`get_issue`	Return one issue as Markdown with its canonical URL, publication date, and issue number. Issues older than the free window return their public excerpt only.
`list_recent_issues`	The newest published issues, most recent first. Use to see what this newsletter covered lately.

INLEVEL9 Letter RSS 피드

언어별 전체 피드입니다. 새 호가 발행되면 바로 반영됩니다.

https://letter.inlevel9.com/rss.xml — 한국어
https://letter.inlevel9.com/en/rss.xml — 영어
https://letter.inlevel9.com/zh-cn/rss.xml — 중국어 간체

INLEVEL9 Letter 채팅 웹훅

Slack·Discord·Teams·Google Chat·Mattermost·두레이의 수신 웹훅 URL을 등록하면 새 호가 발행될 때마다 해당 채널로 제목·요약·링크가 갑니다. 봇 설치나 권한 승인이 필요 없습니다.

웹훅 등록하기

에이전트용 안내 파일

이 사이트를 언제 쓰고 언제 쓰지 말아야 하는지, 어떻게 인용해야 하는지를 적어 둔 파일입니다.

/llms.txt — 사이트 구조와 용도별 진입점 (llmstxt.org 규격)
/llms-full.txt — 언제 쓰고 언제 쓰지 말 것인가, 인용 규칙, 도구 계약
/sitemap-index.xml — 색인 가능한 전체 URL
/robots.txt — 크롤러 정책 (AI 크롤러 포함)

문의

연동 중 막히는 부분이 있으면 contact@inlevel9.com 으로 알려 주세요. 연락처