본문 바로가기
기술 설정

llms.txt·llms-full.txt 작성법과 예시

목차 9개 항목

llms.txt는 사이트 루트(/llms.txt)에 두는 마크다운 안내문으로, AI에게 “이 사이트가 무엇이고 핵심 정보는 어느 페이지에 있는지”를 짧게 알려 줍니다. llmstxt.org에서 제안된 형식이며(공식 표준은 아닙니다) H1 제목, 인용문 요약, H2 섹션별 링크 목록 순서로 씁니다. 만드는 비용이 낮아 해 둘 만하지만, 구글은 AI 개요에 이런 파일이 필요 없다고 밝히고 있으므로 노출을 직접 올려 주는 장치로 기대해서는 안 됩니다.

llms.txt는 무엇이고 왜 생겼나요?

llms.txt는 AI가 사이트를 빠르게 이해하도록 전문가가 고른 핵심 안내를 한곳에 모은 파일입니다. HTML 페이지는 메뉴·광고·스크립트에 둘러싸여 있어 AI가 핵심만 뽑기 어렵고, AI가 한 번에 읽을 수 있는 분량(컨텍스트)도 한정되어 있기 때문입니다. 2024년 9월 Answer.AI의 제러미 하워드(Jeremy Howard)가 llmstxt.org에 제안했고 2026년 8월 v2로 개정되었습니다.

파일역할
robots.txt어떤 크롤러가 어디에 접근해도 되는지 알림
sitemap.xml검색엔진에 색인할 전체 URL 목록 제공
llms.txtAI에게 사이트 요약과 엄선한 핵심 페이지 안내

채택은 늘고 있습니다. 수천 개 사이트가 게시하고 있고, Mintlify 같은 문서 플랫폼과 Wix, 워드프레스용 Yoast SEO 플러그인이 자동 생성 기능을 제공하며, OpenAI·Anthropic·Google Gemini도 개발자 문서에 llms.txt를 두고 있습니다.

llms.txt 형식 규칙은 무엇인가요?

llms.txt는 순서가 정해진 마크다운 파일이며, 필수 요소는 첫 줄의 H1 제목 하나뿐입니다. 나머지는 선택이지만 아래 순서를 지켜야 프로그램으로도 읽을 수 있습니다.

  1. H1(# 사이트명): 사이트나 브랜드 이름. 유일한 필수 요소입니다.
  2. 인용문(> 요약): 나머지를 이해하는 데 필요한 핵심을 한두 문장으로 씁니다.
  3. 상세 설명: 제목 없이 문단이나 목록으로 주소·연락처 같은 기본 정보를 적습니다.
  4. H2 섹션(## 섹션명): 각 섹션 아래에 - [페이지 이름](URL): 설명 형식의 링크 목록을 둡니다.
  5. Optional 섹션(## Optional): 짧게 읽을 때 건너뛰어도 되는 부차적인 링크를 모읍니다.

v2 개정에서는 /docs/llms.txt처럼 하위 경로에 둔 파일이 그 경로 아래 페이지를 설명한다는 규칙이 정해졌고, 페이지별 마크다운 버전(page.html.md 또는 page.md)을 링크 태그나 HTTP 헤더로 알리는 방법이 추가되었습니다.

한국어 사이트 llms.txt 전체 예시는 어떻게 생겼나요?

아래는 가상의 치과의원을 예로 든 완성본입니다. 상호·주소·연락처와 진료·비용·예약 페이지를 사실 중심으로 안내합니다.

# 하늘숲치과의원

> 서울 ○○구 ○○역 인근의 치과의원으로 임플란트·치아교정·일반 진료를 합니다. 모든 진료는 예약제이며 목요일은 21시까지 진료합니다.

- 대표 원장: 김하늘(치과보철과 전문의)
- 주소: 서울특별시 ○○구 ○○대로 123, 4층
- 전화: 02-000-0000
- 진료시간: 월·화·수·금 09:30~18:30, 목 09:30~21:00, 토 09:30~14:00, 일·공휴일 휴진
- 정보 기준일: 2026-09-28 (비용과 일정은 각 페이지가 최신)

## 진료 안내

- [임플란트](https://www.example.com/treatment/implant): 치료 과정, 기간, 건강보험 적용 조건
- [치아교정](https://www.example.com/treatment/orthodontics): 투명교정과 브래킷 교정 비교, 상담 절차
- [일반 진료](https://www.example.com/treatment/general): 충치·신경 치료, 스케일링

## 비용·예약

- [진료비 안내](https://www.example.com/pricing): 비급여 항목 비용표, 건강보험 적용 항목
- [예약](https://www.example.com/reservation): 예약·변경·취소 방법
- [자주 묻는 질문](https://www.example.com/faq): 통증, 치료 기간, 실손보험 서류

## 병원 정보

- [의료진](https://www.example.com/doctors): 원장 약력과 전문의 자격
- [오시는 길](https://www.example.com/location): 주차, 대중교통, 네이버 지도·카카오맵 링크

## Optional

- [공지사항](https://www.example.com/notice): 휴진일과 진료시간 변경
- [구강 건강 칼럼](https://www.example.com/blog): 원장이 쓴 관리 정보
  • 링크는 https://로 시작하는 절대 URL로 씁니다.
  • “최고의”, “완벽한” 같은 광고 문구 대신 사실을 씁니다. 의료기관이라면 치료 효과 보장이나 다른 의료기관과의 비교를 금지하는 의료법의 광고 규정이 이 파일에도 적용된다고 보고 작성하세요.
  • B2B SaaS라면 제품 기능, 요금제, API·연동 문서, 보안·개인정보, 고객 사례를, 쇼핑몰이라면 대표 카테고리와 배송·교환·반품 정책을 섹션으로 둡니다.

파일 속 상호·주소·전화번호는 구조화 데이터(JSON-LD)와 지도 서비스의 표기와 같아야 AI가 같은 엔티티로 인식합니다.

llms-full.txt는 어떻게 구성하나요?

llms-full.txt는 핵심 페이지의 본문을 마크다운으로 한 파일에 모은 것입니다. llmstxt.org 제안의 필수 요소는 아니며, Mintlify 같은 문서 플랫폼이 “문서 전체를 한 파일로” 제공하면서 퍼진 관례입니다. llms.txt가 목차라면 llms-full.txt는 본문 모음입니다.

# 하늘숲치과의원

> (llms.txt와 같은 요약)

## 임플란트
원문: https://www.example.com/treatment/implant (수정일 2026-09-28)

임플란트 진료는 상담과 CT 촬영, 식립, 치유 기간, 보철물 장착 순서로 진행합니다. 치료 기간은 잇몸뼈 상태에 따라 달라 상담 때 안내합니다.

## 자주 묻는 질문
원문: https://www.example.com/faq

### 진료 예약을 바꿀 수 있나요?
전날 18시까지 전화나 온라인 예약 페이지에서 변경할 수 있습니다.
  • 페이지마다 H2 제목, 원문 URL, 수정일을 적고 메뉴·푸터·배너는 뺍니다.
  • 서비스 설명, 비용, FAQ, 예약·환불 정책처럼 AI가 자주 묻는 내용을 넣고 개인정보와 로그인 영역, 오래된 글은 넣지 않습니다.
  • 페이지를 고칠 때 함께 바뀌도록 CMS에서 자동 생성합니다. 페이지가 많다면 한 파일 대신 페이지별 .md 버전을 두고 llms.txt에서 연결하는 방식이 관리하기 쉽습니다.

llms.txt는 어디에, 어떤 형식으로 배포하나요?

https://도메인/llms.txt와 /llms-full.txt에 두고, HTTP 200과 Content-Type: text/plain; charset=utf-8(또는 text/markdown)로 응답하게 합니다. 리다이렉트, 로그인, 봇 확인 페이지 없이 바로 열려야 하며 robots.txt에서 막혀 있으면 안 됩니다. 서브도메인은 robots.txt처럼 각각 따로 둡니다.

curl -sI https://www.example.com/llms.txt
HTTP/2 200
content-type: text/plain; charset=utf-8

v2는 페이지가 자신을 설명하는 llms.txt와 마크다운 버전을 알리도록 HTML <link>나 HTTP Link 헤더를 쓰는 방법도 제안합니다.

<link rel="describedby" href="/llms.txt">
<link rel="alternate" type="text/markdown" href="/pricing.md">

llms.txt에서 흔한 실수는 무엇인가요?

가장 흔한 실수는 파일이 없는데도 홈페이지 HTML이 200으로 반환되는 경우입니다. 아래 표로 점검하세요.

실수증상해결
HTML 반환(soft 404)SPA·CMS가 /llms.txt 요청에 홈페이지 HTML을 돌려줌정적 파일이나 전용 라우트로 제공하고 Content-Type 확인
너무 긴 파일사이트맵이나 본문 전체를 붙여 넣어 수백 KB가 됨llms.txt는 핵심 링크 위주로 짧게, 본문은 llms-full.txt·.md로
깨진 링크404, 로그인 페이지로 이동, /pricing 같은 상대 경로절대 URL로 쓰고 배포 후 모든 링크가 200인지 확인
형식 오류첫 줄이 H1이 아님, 요약 인용문 없음, 섹션을 H3로 구분# → > → ## 순서로 정리
한글 깨짐한글이 “안”처럼 보임UTF-8로 저장하고 charset=utf-8 지정
페이지와 다른 정보가격·진료시간이 실제 페이지와 다름기준일을 적고 CMS에서 자동 생성

무료 간편 진단으로 바로 확인하면 ‘llms.txt·llms-full.txt 확인’ 단계에서 soft 404 여부와 제목·요약·섹션·링크 형식을 검사합니다. 파일이 크롤러에게 열려 있는지는 AI 크롤러와 robots.txt를 참고하세요.

llms.txt를 만들면 AI 검색 노출이 늘어나나요?

2026년 9월 기준으로 검색 노출이 직접 늘어난다는 근거는 없습니다. 구글은 AI 기능 안내 문서에서 AI 개요와 AI 모드에 나오기 위해 새로운 기계용 파일이나 AI 텍스트 파일이 필요 없다고 밝히고 있고, OpenAI·Anthropic·Perplexity의 크롤러 문서도 llms.txt를 검색·인용에 쓴다고 설명하지 않습니다.

  • 실제로 쓰이는 곳: llmstxt.org에 따르면 가장 활발히 쓰이는 분야는 코딩 에이전트가 API 문서를 찾는 소프트웨어 문서이며, 에이전트가 사이트를 탐색할 때 길잡이가 됩니다.
  • 점검 도구: 크롬 Lighthouse는 에이전트 브라우징 점검에서 llms.txt를 “떠오르는 관례”로 소개하고, 파일이 없으면 해당 없음(N/A)으로 처리합니다.
  • 우선순위: 크롤러 접근, 본문 SSR, 구조화 데이터, 콘텐츠 정비 다음에 할 일입니다. GEO Check 간편 진단도 100점 중 10점만 배정합니다.

그래도 핵심 사실을 한곳에 정리하다 보면 사이트·지도·구조화 데이터의 불일치를 발견하는 부수 효과가 있습니다. 도입 전후 실제 AI 답변이 달라졌는지는 같은 질문으로 비교해야 하며, GEO 정밀 리포트로 엔진별 언급과 인용 출처를 확인할 수 있습니다.

요약

  • /llms.txt를 # 사이트명 → > 요약 → ## 섹션 + [이름](URL): 설명 순서로 작성합니다.
  • 링크는 절대 URL로 쓰고, 광고 문구 대신 기준일이 있는 사실을 적습니다.
  • llms-full.txt는 선택이며, 만든다면 페이지별 원문 URL·수정일과 함께 CMS에서 자동 생성합니다.
  • HTTP 200, text/plain(또는 text/markdown), UTF-8로 응답하고 HTML이 반환되지 않는지 확인합니다.
  • llms.txt는 제안 단계의 보조 수단이므로 크롤러 접근과 콘텐츠 정비를 먼저 합니다.

자주 묻는 질문

llms.txt는 공식 웹 표준인가요?

아니요. 2024년 9월 제러미 하워드가 llmstxt.org에 제안하고 2026년 8월 v2로 개정한 형식이며, IETF나 W3C의 표준은 아닙니다. 크롬 Lighthouse도 llms.txt를 떠오르는 관례로 소개하며 파일이 없으면 해당 없음으로 처리합니다. 다만 게시하는 사이트와 자동 생성 도구가 늘면서 채택은 확대되고 있습니다.

llms.txt가 없으면 AI 검색에서 불이익이 있나요?

공식적으로 확인된 불이익은 없습니다. 구글은 AI 개요와 AI 모드에 별도의 AI 텍스트 파일이 필요 없다고 밝히고 있고, 주요 AI 크롤러 문서도 llms.txt를 검색·인용 기준으로 설명하지 않습니다. 다만 코딩 에이전트와 AI 에이전트가 사이트를 탐색할 때 길잡이로 쓰일 수 있고 만드는 비용이 낮아 두는 편을 권장합니다.

llms.txt와 robots.txt, sitemap.xml은 무엇이 다른가요?

robots.txt는 크롤러의 접근 허용 범위를, sitemap.xml은 검색엔진이 색인할 전체 URL 목록을 알려 줍니다. llms.txt는 AI에게 사이트 요약과 엄선한 핵심 페이지를 안내하는 파일입니다. 서로 대체하지 않으므로 세 파일을 함께 운영하세요.

llms-full.txt도 꼭 만들어야 하나요?

필수는 아닙니다. llms-full.txt는 llmstxt.org 제안의 필수 요소가 아니라 문서 플랫폼들이 퍼뜨린 관례로, 핵심 페이지 본문을 한 파일에 모은 것입니다. 페이지 수가 적고 핵심 정보가 분명한 사이트라면 유용하며, 페이지가 많다면 페이지별 .md 버전을 두고 llms.txt에서 연결하는 방식이 관리하기 쉽습니다.

llms.txt 파일 인코딩과 Content-Type은 어떻게 설정하나요?

파일은 UTF-8로 저장하고 Content-Type: text/plain; charset=utf-8 또는 text/markdown; charset=utf-8로 HTTP 200 응답하게 합니다. charset이 빠지면 한글이 깨질 수 있습니다. 요청했을 때 홈페이지 HTML이 대신 반환된다면 파일이 없는 것과 같으므로 정적 파일이나 전용 라우트로 제공하세요.

이 가이드의 항목, 우리 사이트는 어떨까요?

GEO Check 무료 간편 진단은 AI 크롤러 허용과 방화벽 차단, llms.txt, JSON-LD, 메타·OG, 사이트맵, 전 세계 8개 지역 속도, 구글 검색 노출을 1분 안에 점검합니다.

무료로 진단하기 정밀 리포트 보기