cnkang/nginx-markdown-for-agents

nginx-markdown-for-agents은(는) 무엇을 하나요?

셀프 호스팅 가능한 NGINX 모듈로, HTTP 콘텐츠 협상(Accept: text/markdown)을 통해 AI 에이전트에 마크다운을 제공하며, Rust 변환기로 구동됩니다.

개요

이 모듈을 사용하면 웹사이트의 HTML 콘텐츠를 AI 에이전트가 선호하는 마크다운 형식으로 자동 변환하여 제공할 수 있습니다. 에이전트가 Accept: text/markdown 헤더로 요청하면, 모듈이 HTML을 깔끔한 마크다운으로 변환하여 반환합니다.

작동 방식

1. NGINX가 요청을 수신합니다.
2. Accept 헤더를 확인합니다.
3. text/markdown이 포함된 경우, HTML 응답을 마크다운으로 변환합니다.
4. 변환된 마크다운을 에이전트에 반환합니다.

빠른 시작

# NGINX 설정 예시
load_module modules/ngx_http_markdown_module.so;

server {
    listen 80;
    server_name example.com;

    location / {
        markdown on;
        proxy_pass http://backend;
    }
}

설치

1. 릴리스 페이지에서 모듈을 다운로드합니다.
2. NGINX의 load_module 지시어로 로드합니다.
3. 원하는 location 블록에서 markdown on;을 활성화합니다.

설정 옵션

지시어	기본값	설명
markdown	off	마크다운 변환 활성화/비활성화
markdown_cache_ttl	60s	변환된 마크다운의 캐시 TTL

환경 변수

• MARKDOWN_CACHE_SIZE: 캐시 최대 크기 (기본값: 1000)

호환성

• NGINX 1.20 이상
• Linux x86_64, aarch64
• AI 에이전트: Claude Code, Cursor, Codex 등

라이선스

MIT