네이버 수집요청 API 연동, 신청 조건과 호출 순서

글이 매일 수십 건씩 올라오는 사이트는 웹마스터도구 화면에서 URL 을 하나씩 넣기 어렵습니다. 수집요청 API 는 글을 발행하거나 지우는 순간 서버가 URL 목록을 네이버에 바로 보내게 해 줍니다.

다만 아무 사이트나 바로 호출할 수는 없습니다. 첫 호출 전에 갖출 신청 조건 4가지와 호출 순서, 응답 코드 처리를 가이드 원문으로 정리했습니다.

가장 자주 걸리는 자리는 소유 확인입니다. https://www.example.com 으로 소유를 확인했는데 https://example.com URL 을 보내면 별개의 사이트로 보고 오류로 처리합니다.

제휴 없이 새 URL 을 서버에서 알리려면 IndexNow 를 씁니다. 서치어드바이저는 IndexNow 를 지원하고, 방법은 「IndexNow API 요청 방법」 편에 자세히 적었습니다.

한 번에 1,000개를 꽉 채워 보내는 방식은 피합니다. 가이드는 한꺼번에 보내면 크롤러 방문이 몰려 사이트 트래픽에 영향을 줄 수 있으니 나눠 보내라고 적었습니다.

발행 이벤트마다 그 글의 URL 만 보내거나, 몇 분 단위로 모아 작은 묶음으로 보내는 구성이 이 권고에 맞습니다.

다시 보내도 되는 응답은 하루 요청량 초과와 서버 에러의 2가지입니다. 나머지는 본문·토큰·사이트 설정을 고치기 전에는 몇 번을 보내도 결과가 같습니다.

하루 요청량 숫자는 가이드에 없고 제휴처마다 따로 정해집니다. 초과 메시지를 받은 뒤의 URL 은 버려지니, 남은 URL 을 큐에 두었다가 다음 날 보냅니다.

예시 ① 업무용 소프트웨어 회사의 도움말 센터(B2B)

제품을 배포할 때마다 도움말 문서 수십 개가 한꺼번에 바뀝니다. 배포 파이프라인 끝에서 바뀐 문서 URL 만 모아 verify 를 거쳐 submit 합니다.

도움말이 help. 하위 도메인에 있다면 그 호스트를 따로 소유 확인해야 합니다. 본 도메인만 소유 확인한 상태로 보내면 별개의 사이트로 보고 오류로 처리합니다.

예시 ② 품절 상품이 자주 바뀌는 쇼핑몰(B2C)

새 상품 페이지는 update 로, 판매를 끝내고 지운 상품 페이지는 delete 로 보냅니다. 같은 URL 이 한 본문에 둘 다 들어가면 delete 가 이깁니다.

옵션·정렬 매개변수가 붙은 URL 은 빼고 대표 URL 하나만 보냅니다. 가이드가 중복 문서를 하나만 요청하라고 적은 자리입니다.

예시 ③ 공고가 매일 올라오는 공공기관 누리집(B2G)

입찰·채용 공고는 게시 직후 검색에 걸려야 쓸모가 있습니다. 게시판 등록 시점에 공고 URL 을 submit 하고, 공고 기간이 끝나 내린 글은 delete 로 보냅니다.

사업마다 유지보수 업체가 바뀔 수 있으니, 토큰은 기관 계정의 웹마스터도구에서 확인하고 업체에는 서버 설정값으로만 넘깁니다.