Google의 Developer Knowledge API 생태계는 2026년 10월 7일 Google 개발자 블로그에서 정식으로 소개됐다. 대체하려는 것은 두 가지 임시방편이다. 에이전트에게 웹페이지를 긁어오게 하는 것, 그리고 모델 학습 데이터에 남아 있는 낡은 문서 기억에 기대는 것이다. 이 API는 Google Cloud, Firebase, Android 등의 공식 문서를 프로그래밍으로 다룰 수 있는 권위 있는 출처로 만들고, Markdown 형식으로 제공하며 의미 검색과 키워드 검색, 문서 청크 분할, 근거 있는 질의응답을 지원한다. 대상 사용자는 분명하다. AI 에이전트, IDE 확장, 자동화 워크플로이다.
같은 API로 들어가는 네 가지 문
Google은 네 가지 접속 방식을 마련했다. 터미널에서 일하는 사람에게는 gcloud CLI가 있고 Cloud Shell에 미리 설치돼 있으며 일반 Google Cloud SDK 환경에서도 쓸 수 있다. answer-query는 터미널에서 근거 있는 답변을 돌려주고, documents search-chunks는 문서 조각을 검색하며, documents describe는 특정 문서를 가져온다. 오류 로그를 그대로 질문에 흘려 넣을 수도 있다. 코딩 어시스턴트용으로는 공식 에이전트 스킬이 있어, 설치하면 어시스턴트가 여러 단계의 검색 절차로 함께 제공되는 MCP 서버를 호출하고, MCP가 없으면 REST API로 물러설 수 있으며 Antigravity, Claude Code, Cursor, GitHub Copilot 등과 호환된다. 운영 시스템을 만드는 팀에게는 C#, Go, Java, Node.js, PHP, Python, Ruby 클라이언트 라이브러리가 있고, 일괄 조회로는 한 번에 최대 20개 문서를 가져올 수 있다. 일단 시험해 보고 싶은 사람에게는 코드 없이 요청을 눌러 볼 수 있는 APIs Explorer가 있다.
가치는 또 하나의 엔드포인트가 아니라 검색 순서에 있다
주목할 설계는 에이전트에게 정해 준 조회 순서다. 먼저 문서 조각을 검색해 어떤 대목이 관련 있는지 가려내고, 필요할 때만 전체 페이지를 가져오며, 처음부터 문서 전체를 컨텍스트에 쏟아붓지 않는다. 검색을 기기 쪽으로 옮기는 EmbeddingGemma 2 같은 노력과 같은 방향이다. 토큰은 덜 쓰고, 맞는 정보에 더 쓰게 하자는 것이다. Google은 인덱스를 자주 갱신해 공식 문서 변경과 에이전트가 그것을 볼 수 있는 시점 사이의 간격을 줄인다고도 강조했다. 낡은 문서에 데어 본 개발자에게는 기능 목록보다 이 한 문장이 더 중요하다.
경계도 분명하다. 대상은 Google 자체 개발자 문서이지 웹 전체 검색이 아니며, 인증은 Google Cloud 애플리케이션 기본 사용자 인증 정보나 API 키를 쓰므로 도입 전에 그 설정부터 정리해야 한다. Google Cloud를 많이 쓰는 팀에게는 문서 확인이 사람의 습관에서 프로그래밍 가능한 단계로 바뀌는 일이고, 그렇지 않은 팀에게는 당분간 남의 생태계에 속한 잘 만든 부품이다.
