노트

llms.txt

프런트엔드#ai · 연결된 개념 3개

쉽게 말하면

llms.txt는 처음 온 손님에게 건네는 '여기부터 읽어 보세요' 안내 쪽지 같은 파일이에요. 광고와 메뉴가 섞인 HTML 대신, AI 에이전트가 바로 읽을 원문 링크를 한곳에 추려 둬요.

비유가 깨지는 곳 공식 표준이 아니라 제안이에요. 구글 검색은 이 파일을 쓰지 않고, 둔 사이트 대부분은 한 번도 요청받지 못했어요. 검색 노출용이 아니라 에이전트가 원문을 바로 읽게 돕는 장치예요.

llms.txt는 웹사이트 루트(/llms.txt)에 두는 마크다운 파일로, LLM(Large Language Model) 기반 에이전트에게 "이 사이트가 무엇이고 어떤 콘텐츠를 어디서 읽으면 되는지"를 알려 준다. 2024년 9월 제러미 하워드(Jeremy Howard)가 제안했다. HTML 페이지는 내비게이션·광고·스크립트가 섞여 있어 LLM이 읽기에 번거롭고 컨텍스트 윈도우(Context Window)를 낭비하므로, 바로 읽을 수 있는 깔끔한 원문 목록을 한곳에 모아 두자는 취지다.

형식

# 사이트 이름
 
> 한 문단짜리 요약
 
부가 설명(선택)
 
## 문서
 
- [시작하기](https://example.com/start.md): 한 줄 설명
- [API 레퍼런스](https://example.com/api.md)
 
## Optional
 
- [변경 기록](https://example.com/changelog.md)
  • H1(사이트 이름)만 필수다. 그 아래 인용문 요약, 자유 설명, H2로 나눈 링크 목록이 순서대로 온다
  • 링크 목록의 각 항목은 [이름](URL)에 선택적으로 : 설명을 붙인다
  • ## Optional 절은 컨텍스트가 모자랄 때 건너뛰어도 되는 보조 자료다
  • 사이트 루트뿐 아니라 /docs/llms.txt처럼 하위 경로에 둘 수도 있다
  • 함께 제안된 관례로, 각 페이지의 마크다운판을 같은 URL에 .md를 붙이거나(page.html.md) 확장자를 바꿔(page.md) 제공한다

llms-full.txt는 제안 문서에는 없는 관례로, 링크 목록 대신 사이트 문서 전체를 한 텍스트 파일로 이어 붙인 것이다. 에이전트가 여러 번 요청하지 않고 한 번에 읽게 하려는 것으로, Anthropic의 Claude 문서처럼 개발자 문서 사이트에서 볼 수 있다.

robots.txt·sitemap과의 차이

  • robots.txt: 크롤러에게 어디를 가도 되는지 알려 주는 접근 규칙이다
  • sitemap.xml: 색인할 모든 페이지 목록이다. 대개 LLM 컨텍스트에 다 넣기엔 너무 크다
  • llms.txt: 에이전트가 필요할 때 읽을 추린 원문 목록이다. 학습용 크롤링이 아니라 추론 시점에 쓰는 것을 염두에 뒀다

한계 (2026 기준)

  • 공식 표준이 아니라 제안이다
  • 구글은 AI 검색 기능을 포함한 구글 검색에 나오려고 AI용 텍스트 파일이나 마크다운을 새로 만들 필요가 없고, 구글 검색은 그런 파일을 쓰지 않는다고 밝혔다. 만들어도 순위에 득도 실도 없다
  • Ahrefs가 2026년 5월 서버 로그로 13만여 도메인을 조사한 결과, llms.txt를 둔 사이트의 97%는 그 파일이 한 번도 요청되지 않았다. 요청 대부분은 SEO(Search Engine Optimization) 점검 도구 같은 AI가 아닌 봇이었다

그러니 검색 노출 효과를 기대할 파일은 아니다. 사용자가 에이전트에게 "이 문서를 읽고 답해 줘"라고 시켰을 때 에이전트가 HTML을 파싱하지 않고 원문을 바로 읽게 돕는 장치로 보는 것이 정확하다. 이미 마크다운 원문을 서빙하고 있다면 비용이 거의 들지 않는다. 에이전트가 자료를 찾아 쓰는 방식은 RAG (검색 증강 생성), 메타데이터로 검색 엔진에 페이지를 설명하는 쪽은 generateMetadata에서 다룬다.

출처: The /llms.txt file Jeremy Howard(2024) · Google 검색 Central: AI 최적화 가이드 · We Analyzed 137K Sites: 97% of llms.txt Files Never Get Read Ahrefs(2026)

참고: Claude 문서의 llms-full.txt

연결된 개념

이 노트를 가리키는 문서

뜻이 가까운 노트

  • LLM 사용 습관

    LLM이 어떻게 만들어지는지 알고, 컨텍스트를 깨끗하게 관리하고, 모델과 도구를 골라 쓰고, 답은 초안으로 보고 검증하는 습관.

  • AI·머신러닝·딥러닝·LLM의 관계

    AI ⊃ 머신러닝 ⊃ 딥러닝 ⊃ LLM. 규칙을 직접 짜는 대신 데이터에서 패턴을 배우는 방법들이 겹겹이 포함 관계를 이룬다.

  • 브라우저 안에서 도는 RAG 구현기

    서버·요금 없이 방문자 브라우저에서 EmbeddingGemma 2로 찾고 Gemma 4로 답하는 RAG를 이 사이트에 넣은 사례. 프론트엔드 개발자가 알아야 할 개념을 구현 순서대로 짚는다.

  • 텍스트 임베딩

    문장을 뜻이 담긴 고정 길이 숫자 벡터로 바꾸는 것. 뜻이 비슷한 문장일수록 벡터가 가까워서, 겹치는 단어가 없어도 찾을 수 있다.

  • 멀티모달

    텍스트·이미지·음성·영상처럼 형태가 다른 데이터(모달리티)를 한 모델이 함께 받거나 만드는 것. 사진을 보여 주고 질문하는 LLM이 대표적인 예다.

보기 옵션