AI 답변의 기준 · 공식 문서
LangChain llms.txt 구조와 개발 문서 적용 기준
API 레퍼런스와 튜토리얼이 있는 개발 문서라면 도움이 됩니다. 제안 문서는 llms.txt 가 가장 많이 쓰이는 곳을 코딩 에이전트가 API 문서를 찾는 소프트웨어 문서로 적었습니다. 다만 구글 검색은 llms.txt 를 쓰지 않으므로, 검색 노출과는 별개인 코딩 도구용 안내로 둡니다.
개발 문서는 사람만 읽지 않습니다. 고객 개발자가 코딩 도구에 「이 API 로 결제 붙여 줘」라고 하면, 도구가 문서를 찾아 읽고 코드를 씁니다.
llms.txt 는 그런 도구에 문서 목록을 건네는 파일입니다. 이 편은 공개 개발 문서 사이트 4곳의 파일을 직접 받아 구조를 보고, 우리 문서에 둘지 판단하는 기준을 원문으로 정리했습니다.
발견 01
제안 문서는 llms.txt 가 가장 많이 쓰이는 곳으로 소프트웨어 문서와 코딩 에이전트를 적었습니다
llms.txt files are used most heavily for software documentation, where coding agents follow them to find API references and tutorials.
llms.txt 는 소프트웨어 문서에서 가장 많이 쓰이고, 코딩 에이전트가 이 파일을 따라가 API 레퍼런스와 튜토리얼을 찾는다.
| 문서 | 원문 |
|---|---|
| 제안 문서: 쓰이는 상황 | Agents now use websites constantly: a coding agent fetches a library’s documentation to get an API call right, and a chat assistant with search reads pages to answer questions about a product.이제 에이전트는 웹사이트를 늘 쓴다. 코딩 에이전트는 API 호출을 맞게 쓰려고 라이브러리 문서를 가져오고, 검색하는 채팅 도우미는 제품 질문에 답하려고 페이지를 읽는다. |
| 제안 문서: 왜 필요한가 | Context windows, while larger than they were, are still too small for most websites in their entirety, and every wasted token costs time and money.맥락 창은 예전보다 커졌지만 대부분의 웹사이트를 통째로 담기에는 여전히 작고, 낭비한 토큰마다 시간과 비용이 든다. |
| 제안 문서: 쓰는 방식 | Agents are expected to view or search llms.txt to find the information they need, then follow the relevant links. The file itself stays small enough to fit in context. The detail lives behind the links, and is fetched only when needed.에이전트는 llms.txt 를 보거나 검색해 필요한 정보를 찾고 관련 링크를 따라간다. 파일은 맥락에 들어갈 만큼 작게 두고, 자세한 내용은 링크 뒤에 두어 필요할 때만 가져온다. |
| 제안 문서: 쓰는 곳 | The AI labs themselves publish llms.txt files for their own developer docs: OpenAI, Anthropic, and Gemini.AI 연구소들도 자기 개발자 문서에 llms.txt 를 낸다. OpenAI, Anthropic, Gemini 다. |
| 구글 검색 | It's completely fine if you decide to create and maintain LLMS.txt files (or other similar files) for other services or systems that use these files. Doing so will neither harm nor help your site's visibility or rankings in Google Search, as Google Search ignores them.이런 파일을 쓰는 다른 서비스나 시스템을 위해 LLMS.txt(또는 비슷한 파일)를 만들고 관리해도 전혀 문제없다. 구글 검색은 이 파일을 무시하므로, 구글 검색에서의 사이트 노출이나 순위에 해도 도움도 되지 않는다. |
| 크롬 Lighthouse | Without this file, agents may spend more time crawling the site to understand its high-level structure and primary content.이 파일이 없으면 에이전트가 사이트의 큰 구조와 주요 콘텐츠를 파악하려고 크롤링에 시간을 더 쓸 수 있다. |
발견 02
개발 문서 4곳의 llms.txt 는 모두 H1 으로 시작했고, 목록을 묶는 방식은 서로 달랐습니다
수집일 2026-10-25. 색이 든 막대는 하위 색인 파일로 나눈 곳입니다.
| 문서 사이트 | H1 | 요약 인용문 | H2 묶음 | 목록 링크 | .md 링크 | 하위 색인(.txt) | 파일 크기 | 묶는 방식 |
|---|---|---|---|---|---|---|---|---|
| LangChain 문서 | # Docs by LangChain | 있음 | OpenAPI Specs, Indexes | 17개 | 0개 | 14개 | 3.1KB | 제품 묶음마다 하위 색인 파일(.txt)로 나누고, OpenAPI 명세를 따로 묶음 |
| LangGraph(파이썬) 옛 문서 URL | # Docs by LangChain: LangGraph (Python) | 있음 | LangGraph (Python) | 43개 | 43개 | 0개 | 3.9KB | 옛 호스트에 남은 파일이 새 문서 사이트의 .md 페이지를 가리킴 |
| Chainlit 문서 | # Chainlit | 없음 | Optional | 124개 | 123개 | 0개 | 9.1KB | 한 목록에 .md 페이지를 나열, 끝에 Optional 묶음, 앞쪽에 프로젝트 상태 안내 |
| MCP(Model Context Protocol) 문서 | # Model Context Protocol | 없음 | 없음 | 362개 | 362개 | 0개 | 49.1KB | H2 없이 사양 버전 경로가 든 .md 페이지를 한 목록에 나열 |
LangChain 은 맨 위 파일을 짧게 두고 제품 묶음마다 하위 색인으로 나눴습니다. 제안 문서가 말한 「맥락에 들어갈 만큼 작은 파일」에 가까운 방식입니다.
MCP 문서는 한 파일에 링크를 길게 나열했습니다. 에이전트가 한 번에 다 읽기는 어렵지만, 목록을 검색해 필요한 페이지만 고를 수 있습니다.
Chainlit 문서는 목록 앞쪽에 프로젝트 상태를 적었습니다(원문: Chainlit is archived and no longer actively maintained.). 코딩 도구가 코드를 쓰기 전에 읽는 자리라, 지원 상태 같은 정보를 두기 좋습니다.
발견 03
문서 페이지마다 llms.txt 로 돌아가는 안내를 두었습니다
| 장치 | 제안 문서 | 관찰한 문서 사이트 |
|---|---|---|
| 페이지의 마크다운 판 | 같은 URL 에 .md 를 붙인 판을 둔다 | LangChain·Chainlit·MCP 문서 모두 페이지 URL 뒤 .md 로 text/markdown 을 돌려줌 |
| 마크다운 판 첫머리 | 없음 | 세 사이트 모두 .md 첫 줄에 같은 인용 블록. 「Fetch the complete documentation index at: https://docs.langchain.com/llms.txt」 「Use this file to discover all available pages before exploring further.」 |
| HTML 페이지의 링크 표시 | rel="alternate" type="text/markdown" 와 rel="describedby" | LangChain 문서 HTML 에 rel="alternate" type="text/markdown" 링크, 응답 헤더 Link 에 rel="llms-txt" |
To help clients find these files, we recommend using standard link relations: rel="alternate" type="text/markdown" points to the markdown version of a page, and rel="describedby" points to the llms.txt file that covers it.
이 파일들을 찾기 쉽게 표준 링크 관계를 권한다. rel="alternate" type="text/markdown" 은 페이지의 마크다운 판을, rel="describedby" 는 그 페이지를 다루는 llms.txt 를 가리킨다.
코딩 도구는 검색으로 문서 페이지 하나에 먼저 닿기도 합니다. 그 페이지 첫머리에서 전체 목록(llms.txt)으로 돌아가는 길을 두면, 도구가 나머지 문서도 찾아갑니다.
링크 이름은 제안 문서 권장(describedby)과 다를 수 있으니, 우리 문서는 권장 이름을 쓰고 HTML 링크와 응답 헤더 가운데 관리하기 쉬운 쪽에 둡니다.
발견 04
API 문서에 llms.txt 를 둘지는 5가지 기준으로 판단합니다
| 판단 기준 | 「예」라면 | 원문 |
|---|---|---|
| API 레퍼런스·튜토리얼이 있는가 | 코딩 에이전트가 따라갈 목록이 생깁니다 | llms.txt files are used most heavily for software documentation, where coding agents follow them to find API references and tutorials.llms.txt 는 소프트웨어 문서에서 가장 많이 쓰이고, 코딩 에이전트가 이 파일을 따라가 API 레퍼런스와 튜토리얼을 찾는다. |
| 고객 개발자가 코딩 도구로 문서를 읽는가 | 에이전트가 HTML 대신 짧은 목록부터 읽습니다 | Agents now use websites constantly: a coding agent fetches a library’s documentation to get an API call right, and a chat assistant with search reads pages to answer questions about a product.이제 에이전트는 웹사이트를 늘 쓴다. 코딩 에이전트는 API 호출을 맞게 쓰려고 라이브러리 문서를 가져오고, 검색하는 채팅 도우미는 제품 질문에 답하려고 페이지를 읽는다. |
| 페이지마다 .md 판을 낼 수 있는가 | 목록의 링크가 깨끗한 본문으로 이어집니다 | We furthermore propose that pages with information that agents might need provide a clean markdown version of those pages at the same URL as the original page, either with .md appended (page.html.md) or with the extension replaced by .md (page.md).에이전트에게 필요할 정보가 있는 페이지는 원래 페이지와 같은 URL 에 .md 를 붙이거나(page.html.md) 확장자를 .md 로 바꾼(page.md) 깨끗한 마크다운 판을 함께 두기를 제안한다. |
| 제품·버전별로 문서가 나뉘는가 | 하위 경로마다 llms.txt 를 두고 가장 가까운 파일을 쓰게 합니다 | A file covers the URLs under its path, and where more than one file applies, agents should use the most specific one.파일은 자기 경로 아래 URL 을 다루고, 여러 파일이 해당하면 에이전트는 가장 구체적인 파일을 쓴다. |
| 구글 검색 노출이 목적인가 | 목적이 다릅니다. 구글 검색은 llms.txt 를 쓰지 않아 색인 작업을 따로 합니다 | It's completely fine if you decide to create and maintain LLMS.txt files (or other similar files) for other services or systems that use these files. Doing so will neither harm nor help your site's visibility or rankings in Google Search, as Google Search ignores them.이런 파일을 쓰는 다른 서비스나 시스템을 위해 LLMS.txt(또는 비슷한 파일)를 만들고 관리해도 전혀 문제없다. 구글 검색은 이 파일을 무시하므로, 구글 검색에서의 사이트 노출이나 순위에 해도 도움도 되지 않는다. |
예시 ① 결제 API 를 파는 회사의 개발자 문서(B2B)
가맹점 개발자가 코딩 도구로 결제 연동 코드를 씁니다. 문서 루트에 llms.txt 를 두고 「시작하기」「API 레퍼런스」「웹훅」「오류 코드」 묶음으로 .md 링크를 나눕니다.
API 버전이 둘이면 /v1/llms.txt, /v2/llms.txt 처럼 경로마다 두어 도구가 맞는 버전을 고르게 합니다.
예시 ② 스마트홈 기기를 파는 회사의 연동 문서(B2C)
본업은 소비자 판매지만, 기기를 다른 앱에 붙이려는 개발자용 연동 문서가 따로 있습니다. 이 문서만 /developers/llms.txt 로 두고, 상품 페이지는 지금처럼 검색 색인 작업을 합니다.
구매 고객용 도움말과 개발자 문서를 한 파일에 섞지 않으면 도구가 엉뚱한 페이지를 읽을 일이 줄어듭니다.
예시 ③ 공공데이터 오픈 API 를 안내하는 기관 누리집(B2G)
민간 개발자가 공공데이터 API 로 서비스를 만듭니다. 활용 신청 절차, 요청 변수, 응답 예시를 .md 판으로 내고 llms.txt 에 묶으면 도구가 같은 순서로 따라갑니다.
인증키처럼 공개하면 안 되는 값은 문서 본문에도 llms.txt 에도 넣지 않고, 발급 방법 페이지만 링크합니다.
그럼 개발 문서에 llms.txt 는 어떻게 두나요?
- 문서 페이지마다 같은 URL 에 .md 판을 낼 수 있는지 봅니다. 이것이 llms.txt 목록이 가리킬 본문입니다.
- 문서 루트에 llms.txt 를 두고 H1(제품 이름), 한 줄 요약, H2 묶음별 .md 링크 순서로 씁니다. 링크가 수백 개면 묶음마다 하위 색인으로 나눕니다.
- 제품·버전별 경로가 있으면 그 경로마다 llms.txt 를 따로 둡니다.
- 각 .md 판 첫머리나 HTML 링크·응답 헤더로 llms.txt 의 위치를 알립니다.
- 지원 종료·버전 변경 같은 상태는 목록 앞쪽에 한 줄로 적어 둡니다.
- llms.txt 만 주고 코딩 도구에 우리 API 질문을 해 봅니다. 제안 문서가 권하는 점검 방법입니다.
조사 방법
- llmstxt.org (Jeremy Howard) 「The /llms.txt file, v2」 (문서 수정일 2026-08-10) · 최종 확인일 2026-10-25 · https://llmstxt.org/
- Google Search Central 「Optimizing your website for generative AI features on Google Search」 (문서 수정일 2026-07-10) · 최종 확인일 2026-10-18 · https://developers.google.com/search/docs/fundamentals/ai-optimization-guide
- Chrome for Developers · Lighthouse 「llms.txt (Agentic browsing audits)」 (문서 수정일 2026-05-05) · 최종 확인일 2026-10-18 · https://developer.chrome.com/docs/lighthouse/agentic-browsing/llms-txt
- LangChain 문서 「llms.txt」 · 최종 확인일 2026-10-25 · https://docs.langchain.com/llms.txt
- LangGraph(파이썬) 옛 문서 URL 「llms.txt」 · 최종 확인일 2026-10-25 · https://langchain-ai.github.io/langgraph/llms.txt
- Chainlit 문서 「llms.txt」 · 최종 확인일 2026-10-25 · https://docs.chainlit.io/llms.txt
- MCP(Model Context Protocol) 문서 「llms.txt」 · 최종 확인일 2026-10-25 · https://modelcontextprotocol.io/llms.txt
- 문서 사이트 4곳은 이 편의 질문과 함께 검색되는 공개 개발 문서 가운데 robots.txt 로 경로 허용을 확인한 곳입니다. 다른 문서 한 곳은 robots.txt 요청이 다른 페이지로 이동해 규칙을 확인하지 못해 받지 않았습니다.
- 목록 링크 수는 줄 맨 앞이 「- [이름](URL)」인 줄을 셌고, .md·.txt 는 링크 URL 끝으로 갈랐습니다. H2 묶음은 줄 맨 앞이 「## 」인 줄입니다.
- 페이지 쪽 장치는 사이트마다 문서 페이지 하나(.md 판 포함)를 받아 확인했습니다. 사이트 전체에 같은 장치가 있는지는 페이지를 더 받아 확인할 일입니다.
- 판단 기준 5가지는 제안 문서와 구글 문서가 적은 쓰임을 문서 사이트 운영 단위로 묶은 것입니다. 묶는 방식은 편집 판단입니다.
- 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
- 원문은 영어판(hl=en)이고, 도구 이름은 같은 문서 한국어판(hl=ko) 표기를 따랐습니다.