Hacker News • 30일 전

Accept 헤더로 AI 에이전트에 마크다운 제공하기

IMP

6/10

핵심 요약

웹사이트가 HTTP 콘텐츠 협상(Accept: text/markdown)을 지원하면 AI 에이전트가 내비게이션·스크립트·레이아웃 마크업을 건너뛰고 본문만 직접 읽을 수 있습니다. 이는 토큰 절약, 검색(RAG) 품질 향상, 지연시간 단축으로 이어집니다. Nginx, Cloudflare, Next.js 등 다양한 플랫폼별 설정 가이드도 제공됩니다.

번역된 본문

콘텐츠 협상 Accept: text/markdown을 통해 AI 에이전트에게 마크다운 제공하기. 당신의 사이트에는 이미 콘텐츠가 있습니다. 마크다운 변환본을 제공하면 에이전트 AI 클라이언트가 내비게이션·스크립트·레이아웃 마크업을 건너뛰고 콘텐츠를 직접 읽을 수 있습니다.

빠른 시작: URL 테스트하기. 이 페이지 공유하기(X, LinkedIn, Bluesky, Reddit, Mastodon에서 공유, 새 탭에서 열림), 기타…, 링크 복사.

01 — 토큰: 바이트 수가 극히 일부입니다. 마크다운은 내비게이션, 스타일, 스크립트, 레이아웃 래퍼를 제거합니다. 에이전트는 DOM이 아닌 당신의 글에 컨텍스트를 소비하게 됩니다.

02 — 검색(Retrieval): 더 높은 신호 대 잡음비. 광고, 관련 콘텐츠 사이드바, 모달 오버레이가 없어 RAG 파이프라인이 임베딩해야 할 텍스트가 오염되지 않습니다.

03 — 지연시간(Latency): 더 빠른 첫 토큰. 가져오고, 파싱하고, 컨텍스트 창에 채워 넣을 내용이 줄어 모델이 더 빨리 사고를 시작합니다.

URL 입력 후 실행 확인, 결과 공유, 스코어카드 이미지 다운로드/복사.

URL Accept 협상 직접 실행해 보기.

빠른 시작: 가장 작은 동작 설정. 세 단계, 서버 하나, 응답 두 개.

가이드:

기본기와 정확성: Vary 헤더, q-값(q-values), 406 응답, 캐싱, 그리고 Cloudflare 제로 설정(Zero-config) 바로가기.
레시피: 복사-붙여넣기 설정. Nginx, Caddy, WordPress, Discourse, Laravel, Rails, Cloudflare Workers, Next.js, Astro, Apache, SvelteKit, Nuxt/Nitro, Express, Go, Django.
현황: AI 에이전트 지원 매트릭스. 어떤 AI 에이전트가 탐색(browse) 또는 fetch 도구로 URL에 접근할 때 Accept: text/markdown을 전송하는지.
참고자료: 표준과 출처. RFC 9110, RFC 7763, text/markdown 미디어 타입 및 관련 규격.

원문 보기

원문 보기 (영어)

Serve Markdown to AI agents with content negotiation Accept: text/markdown Your site already has the content. Serving a Markdown variant lets agent AI clients skip nav/scripts/layout markup and read the content directly. Quick start Test a URL Share this page Share on X (opens in new tab) Share on LinkedIn (opens in new tab) Share on Bluesky (opens in new tab) Share on Reddit (opens in new tab) Share on Mastodon (opens in new tab) Other… Copy link 01 — Tokens A fraction of the bytes. Markdown drops nav, styles, scripts, and layout wrappers. Agents spend context on your prose, not your DOM. 02 — Retrieval Higher signal-to-noise. No ads, related-content rails, or modal overlays muddying the text a RAG pipeline has to embed. 03 — Latency Faster first token. Less to fetch, less to parse, less to stuff into the context window before the model starts thinking. URL Run check Share results Download scorecard image Copy scorecard image Other… URL Accept Negotiate Run this yourself Quick start The smallest working setup Three steps. One server, two responses. Guides Fundamentals & correctness Vary , q-values, 406 , caching, and the Cloudflare zero-config shortcut. Recipes Copy-paste configs Nginx, Caddy, WordPress, Discourse, Laravel, Rails, Cloudflare Workers, Next.js, Astro, Apache, SvelteKit, Nuxt/Nitro, Express, Go, Django. Status AI agent support matrix Which AI agents send Accept: text/markdown when their browse or fetch tools hit a URL. Reference Standards & sources RFC 9110, RFC 7763, the text/markdown media type, and adjacent specs.

AI 에이전트 마크다운 콘텐츠 협상 RAG 웹 개발