에이전트용 Markdown 버전이 깨져 있습니다
짧은 답변
페이지가 Accept: text/markdown에 대한 응답이나 <link rel="alternate" type="text/markdown">을 통해 에이전트에 Markdown 버전을 제공하지만, 그 버전은 오류, 빈 본문 또는 HTML 페이지를 반환합니다. 이를 요청한 에이전트는 쓸모 있는 것을 아무것도 받지 못합니다.
의미
페이지가 에이전트에 Markdown을 제공하지만(Accept: text/markdown에 대한 응답 또는 링크된 사본), 돌아오는 것은 오류, 빈 본문 또는 HTML 페이지입니다.
AI 검색에서 중요한 이유
Markdown 링크를 보거나 text/markdown 응답을 받은 에이전트는 이를 신뢰하고 HTML로 되돌아가지 않을 수 있습니다. 깨진 사본은 없는 것보다 나쁩니다. 에이전트가 실패하거나, 오류 페이지를 내 콘텐츠로 읽게 됩니다.
보통 이전이나 재구축 후에 생깁니다. .md 파일이 배포되지 않았거나, 리라이트 규칙이 예전 경로를 가리키거나, 미들웨어가 HTML에 text/markdown 라벨을 붙이는 경우입니다.
수정 방법
- 근거에 있는 URL을 열어 상태 코드,
Content-Type, 본문을 확인합니다. - 사본이 사라졌다면 다시 배포하거나, 그 사본을 가리키는
<link rel="alternate" type="text/markdown">태그와Link헤더를 제거합니다. - 응답이 HTML이거나 비어 있다면, 페이지 텍스트를 Markdown으로
Content-Type: text/markdown과 함께 반환하도록 변환을 고칩니다. - 페이지 리포트에서 "다시 점검"을 실행해 결과를 확인합니다.
예시
curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept 수정 확인 방법
변경한 뒤 리포트에서 "다시 점검"을 누르세요. 무엇이 수정되었고 점수가 어떻게 바뀌었는지 보여 줍니다.