블로그가 아니라 문서와 저장소가 인용됐습니다

블로그는 꾸준히 냈는데 왜 개발자가 오지 않았을까요

LLM 파이프라인을 구성하는 오픈소스 기반 도구를 만드는 스타트업입니다. 처음부터 글로벌 시장이 주 무대였기 때문에 영어로 마케팅 블로그를 상당히 꾸준히 내고 있었습니다.

유입 자체는 늘었습니다. 그런데 가입으로는 이어지지 않았는데요, 확인해 보니 정작 개발자들은 블로그가 아니라 완전히 다른 곳을 보고 있었습니다.

개발자 질문의 답은 대부분 문서에서 나오고 있었습니다

타깃 질문의 답변에 인용된 출처를 유형별로 하나씩 세어봤습니다. 그랬더니 그동안 가장 많은 인력과 시간을 넣었던 마케팅 블로그가 거의 등장하지 않더라고요.

문서가 아예 검색되지 않는 구조였습니다

문서 사이트가 자바스크립트로만 그려지고 있어서 AI 크롤러가 본문을 읽지 못하고 있었습니다. GPTBot이나 ClaudeBot 같은 크롤러는 구글봇과 달리 자바스크립트를 실행하지 않거든요. 사람 눈에는 멀쩡하게 잘 보이는데 인용은 되지 않는 상태였던 건데요, 이런 경우가 생각보다 흔합니다. 문서를 아무리 잘 써도 읽히지 않으면 없는 것과 같습니다.

마이그레이션 질문에 답할 문서가 없었습니다

‘○○에서 옮기는 방법’ 같은 질문에 대응하는 문서가 하나도 없었습니다. 그런데 다른 도구를 쓰다가 옮기려는 사람은 이미 필요를 확인한 상태라 구매에 가장 가까운 층이거든요. 그 층을 통째로 놓치고 있었던 셈입니다.

문서를 마케팅 자산이 아니라 인용 자산으로 다뤘습니다

그래서 우선순위를 아예 바꿨습니다. 블로그 발행 빈도를 줄이고, 그 인력과 시간을 문서를 다시 만드는 데 넣었습니다. 순서대로 말씀드리겠습니다.

문서를 정적 생성 방식으로 바꿨습니다

문서 사이트를 정적 생성 방식으로 옮겨서 크롤러가 본문을 바로 읽을 수 있게 했습니다. 사실 이 작업 하나만으로 인용될 수 있는 페이지 수가 크게 늘었는데요, 콘텐츠를 한 글자도 새로 쓰지 않고 얻은 결과였습니다.

경쟁 도구에서 옮겨오는 가이드를 만들었습니다

도구별로 옮기는 방법을 코드와 함께 정리했습니다. 개념이 서로 어떻게 대응되는지 표로 보여주고, 코드를 어떻게 바꾸면 되는지 예시를 넣고, 주의해야 할 차이점을 뒤에 붙이는 순서였습니다.

굳이 옮기지 않아도 되는 경우도 적었습니다

지금 구성이 잘 돌아가고 요구사항이 단순하다면 옮길 이유가 없다고 그대로 썼습니다. 개발자 시장에서는 과장이 특히 빠르게 걸러지거든요. 한 번 걸리면 커뮤니티에서 회복하기가 상당히 어렵습니다.

벤치마크를 재현할 수 있는 형태로 공개했습니다

측정 환경과 데이터셋, 실행 코드를 결과와 함께 공개했습니다. 숫자만 있는 벤치마크는 개발자 커뮤니티에서 신뢰받지 못하고 오히려 의심을 사는데요, 직접 돌려볼 수 있어야 근거로 쓰입니다.

깃허브도 문서의 일부로 다뤘습니다

README를 개념 설명부터 시작하도록 다시 쓰고 예제는 별도 저장소로 분리했습니다. 이슈에 답변할 때도 문서 링크를 함께 붙여서 문서와 저장소가 서로를 가리키게 만들었고요. 개발자 입장에서는 이 둘이 원래 하나로 읽힙니다.

영어권 자산은 처음부터 영어로 썼습니다

한국어 콘텐츠를 번역하지 않고 처음부터 영어로 작성했습니다. 번역투 문서는 개발자가 금방 알아보거든요. 그리고 다지역 사이트 구조를 정리해서 언어별 자산을 서로 섞이지 않게 분리했습니다.

가입뿐 아니라 엔터프라이즈 문의까지 따라왔습니다

영어 질문 커버리지가 3%에서 48%로 올랐고, 기술 문서가 인용되는 비율은 5%에서 34%가 됐습니다. 월 가입은 110건에서 290건으로 늘었습니다.

가입한 뒤에 실제로 써보는 비율도 25%에서 39%로 함께 올랐는데요, 문서를 읽고 들어온 사람은 첫 실행까지 도달할 확률이 확실히 높습니다. 이미 어떻게 쓰는지 알고 오니까요. 엔터프라이즈 문의도 3건에서 11건이 됐습니다.

개발자 대상 제품을 만드는 분들께 드리고 싶은 이야기

개발자 시장에서는 문서가 곧 콘텐츠입니다

API 레퍼런스와 깃허브 저장소, 재현 가능한 벤치마크가 마케팅 블로그보다 훨씬 강한 인용 자산입니다. 어느 쪽에 시간을 쓰고 계신지 한번 확인해 보시면 좋겠습니다.

문서가 실제로 읽히는지부터 확인해 보세요

자바스크립트로만 그려지는 문서는 AI 크롤러 눈에 빈 페이지로 보입니다. 크롤러가 읽지 못하면 아무리 정성 들여 쓴 문서라도 인용 자산이 되지 못합니다.

옮겨오려는 사람이 구매에 가장 가깝습니다

다른 도구를 쓰다가 옮기려는 사람은 이미 필요를 확인한 상태입니다. 이 질문에 답하는 문서가 전환율이 가장 높았습니다.

자주 묻는 질문

개발자 대상 GEO는 무엇부터 시작해야 할까요?

문서가 크롤링되고 있는지 확인하는 일이 먼저입니다. 자바스크립트로만 렌더링되는 문서 사이트는 사람에게만 보이고 AI는 읽지 못하거든요. 이 사례에서는 정적 생성으로 바꾸는 작업 하나만으로 인용될 수 있는 페이지가 크게 늘었습니다.

마케팅 블로그는 이제 필요 없는 걸까요?

개발자 질문의 답변에서 인용 비중이 낮은 건 사실입니다. 다만 없애기보다는 우선순위를 뒤로 돌리시는 편이 맞는데요, 이 사례에서도 블로그를 폐지하지 않고 발행 빈도만 줄여서 남는 시간을 문서 정비에 썼습니다.

벤치마크를 공개하면 불리하지 않을까요?

측정 환경과 실행 코드를 함께 공개하시면 오히려 신뢰 자산이 됩니다. 결과 숫자만 있는 벤치마크는 개발자 커뮤니티에서 의심부터 받거든요. 직접 돌려서 확인할 수 있느냐가 인용의 조건이라고 보시면 됩니다.

리드젠랩과 시작하려면 어떻게 하나요?

무료 진단 신청으로 시작합니다. 실제 고객 질문 20개를 주요 AI에 넣어 답변 80개를 분석하고, 현재 노출 상태와 경쟁 구도를 리포트로 드립니다. 이후 필요에 따라 GEO·AEO 대행 또는 컨설팅·내재화 방식을 정하고, 채널별 시작가는 요금 안내에서 확인하실 수 있습니다.

고객사와 체결한 비밀유지계약에 따라 기업명은 가명으로 표기했습니다. 수치와 실행 내용은 실제 프로젝트 측정 데이터입니다.