turva.dev를 prerender.io에서 이전하기

한동안 turva.dev 홈페이지는 제3자에 의해 렌더링되었습니다. 이 페이지는 Sitejet을 기반으로 구축되었으며, 사용자에게는 JavaScript 앱으로 제공되었고, 에이전트(agent)에게는 prerender.io를 통해 제공되었습니다. prerender.io는 크롤러가 빈 껍데기(empty shell)를 읽지 않도록 완성된 HTML 스냅샷을 반환했습니다. 이 방식은 잘 작동했고 점수도 높게 나왔지만, 일종의 임시방편(workaround)이었습니다. 에이전트 준비성(agent-readiness)을 판매하는 사이트가 에이전트가 읽을 수 있도록 별도의 서비스에 의존해서는 안 됩니다.

오늘 홈페이지는 이미 도메인 전면에 배치되어 있는 Cloudflare Worker로 이동했습니다. 이 Worker는 모든 요청에 대해 엣지(edge)에서 직접 완성된 HTML을 렌더링합니다. 클라이언트 사이드 하이드레이션(client-side hydration) 단계도 없고, prerender를 거치는 단계도 없습니다. 에이전트와 사람 모두 첫 번째 응답에서 실제 콘텐츠를 읽게 됩니다.

Worker가 반환하는 것

Worker는 요청에 따라 결정합니다. HTML을 요청하는 브라우저는 렌더링된 페이지를 받습니다. Accept: text/markdown을 보내는 에이전트는 토큰을 아주 적게 사용하면서 동일한 콘텐츠의 마크다운(markdown) 버전을 받습니다. Accept: application/json을 보내는 에이전트는 비즈니스와 서비스에 대한 구조화된 요약(structured summary)을 받습니다. 클라이언트가 요청한 형식으로 동일한 사실을 제공하는 것입니다.

제거된 요소

Worker에서 prerender.io 분기(branch)가 사라졌습니다. 외부 prerender 서비스로 요청을 보내지 않으며, 기존에 사용하던 토큰도 더 이상 읽지 않습니다. 이제 Sitejet은 소셜 이미지와 같은 정적 자산(static assets)만 제공하며, 이 또한 다음 단계로 Worker로 이동할 예정입니다. 페이지는 하나의 코드베이스로 관리되며, 버전 관리(version control) 하에 있고, github.com/busygoat/turvadev-pretender에서 오픈 소스로 제공됩니다.

결과는 주장이 아닌 측정된 수치입니다

이 변경 사항은 해당 서비스가 클라이언트의 작업을 검증하는 것과 동일한 방식, 즉 변경 전후를 독립적인 스캐너로 검증하여 확인되었습니다. StartupHub는 6개 카테고리 모두 100점을 기록하며 100/100, A+ 등급을 기록했습니다. isitagentready는 Level 5, Agent-Native를 기록했습니다. 홈페이지 마이그레이션으로 인해 점수가 떨어진 부분은 전혀 없었습니다.

한 가지 더 말씀드립니다. 이번 변경 사항은 AI 에이전트(AI agent)와 함께 단 한 번의 세션 내에서 계획 및 배포되었으며, 그 결과는 결과에 이해관계가 없는 두 개의 독립적인 스캐너(scanner)를 통해 검증되었습니다. 이 사이트의 주장은 누구나 재현할 수 있는 측정값입니다. 다음 스캔 결과가 동일하거나 더 높게 나오거나, 그렇지 않거나 둘 중 하나일 것입니다.

서면 연락만 가능합니다. 이메일 info@turva.dev, Signal @turva.19. 첫 답장은 영업일 기준 1일 이내에 드립니다.

원문 게시 위치: https://turva.dev/blog/moving-off-prerender