URL 검사 API 일괄 진단으로 대량 페이지 색인·크롤링 상태 자동화하기
Search Console URL 검사 API로 중요한 페이지의 색인 상태를 정기 점검하는 방법을 정리했습니다. 실제 호출 한도와 실시간 검사와의 차이를 확인하고, 실행 가능한 진단 목록을 만들어 보세요.
구독형 그로스 마케터 · 대표
URL 검사 API 일괄 진단은 중요한 페이지가 Google 색인에서 어떤 상태로 기록되어 있는지 주기적으로 확인하는 방법입니다. 현재 페이지를 실시간으로 검사하거나 색인을 요청하는 기능과는 다릅니다. 처음부터 모든 페이지를 검사하기보다, 중요한 URL을 고르고 상태 변화를 담당자의 작업 목록으로 바꾸는 데 집중하세요.
무엇을 자동화할지 먼저 정하세요
Google의 index.inspect 공식 문서는 이 API가 Google 색인에 있는 버전의 상태를 조회하며, 현재 URL의 실시간 색인 가능 여부를 검사할 수는 없다고 설명합니다. 따라서 배포 직후 바뀐 내용이 응답에 즉시 나타날 것이라고 가정하면 안 됩니다. 조회한 시각과 페이지를 수정한 시각을 함께 기록하고, 과거에 수집된 상태를 오늘의 실시간 장애로 오해하지 않도록 운영 기준을 정하세요.
마케팅 팀의 목표는 API 호출 수를 늘리는 것이 아닙니다. 검색 유입이 중요한 랜딩 페이지나 새로 공개한 글 가운데 점검할 대상을 정하고, 결과를 보고 누가 무엇을 확인할지 정하는 일이 먼저입니다. 이는 실무 운영 제안입니다. 진단 결과가 기대와 다르면 담당자가 원인을 검토하도록 연결하세요. 이 API를 호출했다고 색인이 요청되거나 검색 순위가 개선되는 것은 아닙니다.
전체 목록 대신 우선순위가 있는 목록을 만드세요
가상의 예를 들어 보겠습니다. 콘텐츠와 상품 페이지를 함께 운영하는 팀이라면 새로 공개한 핵심 페이지, 최근 수정한 페이지, 이전 검사에서 확인이 필요했던 페이지로 목록을 나눌 수 있습니다. 각 행에 URL과 담당자, 마지막 검사 시각, 다음 확인 이유를 적으세요. 이 분류는 Google의 필수 규칙이 아니라 팀이 제한된 점검 시간을 배분하기 위한 예시입니다. 실제 사업 목표에 맞게 순서를 바꾸면 됩니다.
같은 URL이 여러 캠페인 목록에 들어 있다면 검사 전에 중복을 제거하는 편이 좋습니다. 이전 실행에서 어디까지 처리했는지도 남겨 두세요. 작업이 중단되었을 때 처음부터 전부 재조회하면 이미 확인한 페이지에 호출을 낭비할 수 있습니다. 목록 크기보다 실제로 검토하고 조치할 수 있는 양을 기준으로 시작하고, 점검 결과가 누적되면 중요도와 변경 빈도에 따라 검사 주기를 조정하세요.
권한과 요청 형식은 작은 범위에서 확인하세요
공식 index.inspect 레퍼런스에서 필수 입력은 검사할 주소인 inspectionUrl과 Search Console 프로퍼티를 지정하는 siteUrl입니다. 검사 주소는 지정한 프로퍼티 범위에 속해야 합니다. 문서에는 URL 접두어 프로퍼티와 도메인 프로퍼티의 표기 차이도 안내되어 있습니다. 운영 전에 실제로 등록한 프로퍼티의 표기와 요청 값을 비교하고, 접근 권한이 있는 인증 주체로 작은 검사 목록부터 확인하세요.
인증 구현은 조직의 계정 관리 방식에 따라 달라지므로, 서비스 계정을 만들면 자동으로 모든 사이트의 권한이 생긴다고 가정하지 마세요. 필요한 인증 범위와 접근 권한은 공식 문서와 조직 설정에서 확인해야 합니다. 마케팅 담당자는 검사 대상과 담당자를 정하고, 개발 담당자는 인증과 응답 처리 방식을 확인하도록 역할을 나누면 좋습니다. 토큰이나 비밀 키는 결과표나 Slack 메시지에 포함하지 마세요.
호출 한도에 맞춰 실행하고 실패를 구분하세요
2026년 10월 9일 확인한 Google Usage Limits 문서에는 URL inspection의 사이트별 한도가 하루 2,000회, 분당 600회로 안내되어 있습니다. 프로젝트 단위 한도도 별도로 적용됩니다. 이 수치는 변경될 수 있으므로 운영 전 공식 문서와 프로젝트의 현재 사용량을 다시 확인하세요. 작업자를 여러 개 늘린다고 같은 사이트에 적용되는 호출 제한을 피할 수 있다고 가정해서는 안 됩니다.
처리하지 못한 URL은 다음 실행으로 넘길 수 있도록 남겨 두고, 성공과 실패를 분리해서 기록하세요. 일시적인 오류를 다시 시도하는 경우에도 호출 한도를 고려해야 합니다. 접근 권한 문제라면 반복 호출하기보다 설정을 먼저 점검하는 편이 낫습니다. 실행 결과에는 대상 수, 성공 수, 실패 수, 남은 항목과 다음 담당자를 적으세요. 팀이 확인할 수 있는 간단한 결과표부터 운영하면 불필요한 기능을 줄일 수 있습니다.
함께 읽으면 좋은 글
우리 팀의 다음 실행 과제 찾기
현재 유입과 전환 흐름을 점검하고 실행 우선순위를 정하고 싶다면 히치하이커 AI와 상담해 보세요.
참고 자료
핵심 요약
중요한 URL부터 선정하고 공식 호출 한도 안에서 색인 상태를 조회하세요. 실시간 검사와 색인 요청을 구분하고, 결과를 담당자가 확인할 작업 목록으로 바꾸는 것이 운영의 핵심입니다.
FAQ
API로 현재 페이지를 실시간 검사할 수 있나요?
이 API는 Google 색인에 있는 버전의 상태를 조회합니다. 공식 문서는 현재 URL의 실시간 색인 가능 여부 검사는 지원하지 않는다고 설명합니다.
검사하면 자동으로 색인이 요청되나요?
상태를 조회하는 작업과 색인을 요청하는 작업은 다릅니다. URL 검사 API를 호출했다고 색인이 요청되거나 검색 노출이 보장되는 것은 아닙니다.
많은 페이지를 어떤 순서로 점검해야 하나요?
핵심 페이지와 최근 변경한 페이지 등 팀의 목적에 맞는 우선순위를 정하세요. 실제 호출 한도 안에서 처리하고 미완료 목록을 다음 실행으로 넘기는 방식을 권합니다.
관련 주제: