블로그 · 크롤링·색인
IndexNow로 네이버·빙에 새 글을 알리는 방법과 응답 코드
키 파일 위치, 단건·다건 요청 형식, 200·202·403·422·429 응답 의미, Google을 따로 처리하는 이유를 정리했습니다.
- 작성
- OSKIT 팀 (어포메이션)
- 수정
- 3분 분량
요약
- IndexNow 한 곳에 보내면 Bing·네이버·Yandex 등 참여 엔진이 URL을 공유합니다.
- 한 번에 최대 10,000개 URL을 보낼 수 있고, 200 응답은 접수 확인입니다.
- Google은 참여하지 않아 사이트맵 제출과 URL 검사로 따로 관리합니다.
IndexNow는 한 번 보내면 여러 엔진이 공유합니다
IndexNow는 새로 만들거나 바뀐 URL을 검색엔진에 바로 알리는 프로토콜입니다. 참여 엔진 한 곳에 보내면 나머지 참여 엔진이 같은 URL을 공유합니다[1]. 매일 글을 발행하는 사이트는 크롤러가 다시 올 때까지 기다리지 않고 발행 직후 알릴 수 있습니다.
공식 목록(searchengines.json)에 있는 참여 엔진은 다음과 같습니다[2].
| 엔진 | 엔드포인트 | 비고 |
|---|---|---|
| Bing | https://www.bing.com/indexnow | Copilot 답변의 검색 기반 |
| 네이버 | https://searchadvisor.naver.com/indexnow | 국내 검색 |
| Yandex | https://yandex.com/indexnow | 러시아·CIS |
| Seznam | https://search.seznam.cz/indexnow | 체코 |
| Yep | https://indexnow.yep.com/indexnow | |
| 공용 | https://api.indexnow.org/indexnow | 어느 곳으로 보내도 공유 |
Google은 참여하지 않습니다. Google은 사이트맵 제출과 내부 링크로 수집을 돕고, 색인 상태는 URL 검사로 확인합니다.
네이버가 IndexNow를 지원한다는 사실은 2023년 보도로 알려졌고, 지금은 공식 목록에도 있습니다[3][2]. 서치어드바이저 화면의 「웹페이지 수집 요청」은 API가 없어 사람이 직접 눌러야 하지만, IndexNow는 발행 시스템에서 자동으로 보낼 수 있습니다.
준비: 키 파일 1개
키는 8~128자로 영문 대소문자, 숫자, 하이픈만 씁니다. 사이트 루트에 /{key}.txt 파일을 두고 파일 내용으로 같은 키를 적습니다[1]. 검색엔진은 이 파일을 열어 요청을 보낸 쪽이 사이트 주인인지 확인합니다.
https://example.com/8f2a1c9e4b7d4e21a0c3.txt
내용: 8f2a1c9e4b7d4e21a0c3키 파일을 루트가 아닌 경로에 두려면 요청에 keyLocation을 넣습니다. 이 경우 그 경로 아래 URL만 보낼 수 있습니다.
요청 형식
단건
GET https://api.indexnow.org/indexnow?url=https%3A%2F%2Fexample.com%2Fblog%2Fnew-post&key=8f2a1c9e4b7d4e21a0c3다건 (최대 10,000개)
POST https://api.indexnow.org/indexnow
Content-Type: application/json; charset=utf-8
{
"host": "example.com",
"key": "8f2a1c9e4b7d4e21a0c3",
"urlList": [
"https://example.com/blog/new-post",
"https://example.com/ja/blog/new-post"
]
}다국어 사이트는 언어별 URL을 모두 넣습니다. 한국어 글만 보내고 일본어·영어 글을 빼면 해당 언어 페이지는 다음 크롤까지 기다립니다.
응답 코드
| 코드 | 의미 | 할 일 |
|---|---|---|
| 200 | 접수 | 기록만 합니다. 색인 보장 아님 |
| 202 | 접수, 키 검증 대기 | 키 파일이 열리는지 확인합니다 |
| 400 | 형식 오류 | JSON·URL 인코딩을 확인합니다 |
| 403 | 키 불일치 | 키 파일 내용과 요청 키를 비교합니다 |
| 422 | 호스트 불일치 | urlList의 도메인이 host와 같은지 확인합니다 |
| 429 | 요청 과다 | 묶어서 보내고 간격을 둡니다 |
200 은 「받았다」는 뜻입니다[1]. 색인 여부와 시점은 엔진이 정합니다. 그래서 IndexNow 전송 기록과 실제 색인 확인은 따로 관리합니다.
보내는 시점
- 새 글 발행 직후
- 기존 글 수정 직후(제목·본문·가격 변경)
- 페이지 삭제 후(404·410 이 된 URL도 보냅니다)
- 사이트 이전 후 새 URL 전체
같은 URL을 하루에 여러 번 보내는 것은 피합니다. 수정이 잦은 날은 하루 끝에 한 번에 묶어 보냅니다.
OSKIT 에서는
Post Engine은 글을 발행한 직후, Site Engine은 배포가 끝난 직후 바뀐 URL 목록을 IndexNow로 보냅니다. 응답 코드와 시각은 고객 포털의 Signal Engine 화면에 날짜별로 남습니다. 403·422 가 나오면 담당자에게 알림이 갑니다.
점검 목록
- 01
https://도메인/{key}.txt가 200 으로 열리는지 확인합니다. - 02발행 로그에 IndexNow 응답 코드가 남는지 확인합니다.
- 03다국어 URL이 모두 urlList에 들어가는지 확인합니다.
- 04Google은 사이트맵 제출과 URL 검사로 따로 확인합니다.
- 05네이버 서치어드바이저에 사이트 등록과 사이트맵·RSS 제출이 끝났는지 확인합니다.
이 글이 답하는 질문
IndexNow를 쓰면 바로 색인되나요?
아닙니다. 200 응답은 URL을 받았다는 뜻입니다. 색인 여부와 시점은 각 검색엔진이 정합니다.
네이버는 IndexNow와 서치어드바이저 수집 요청 중 무엇을 써야 하나요?
IndexNow는 자동 전송이 가능하고, 서치어드바이저 수집 요청은 화면에서 사람이 합니다. 발행 때마다 IndexNow를 보내고, 중요한 페이지는 화면 요청을 추가합니다.
Google 에도 IndexNow를 보내면 되나요?
Google은 IndexNow 참여 엔진 목록에 없습니다. 사이트맵 제출과 내부 링크로 수집을 돕습니다.
출처
- [1]IndexNow — Documentationhttps://www.indexnow.org/documentation
- [2]IndexNow — searchengines.jsonhttps://www.indexnow.org/searchengines.json
- [3]Search Engine Land — Naver now supports IndexNowhttps://searchengineland.com/naver-korean-search-engine-now-supports-indexnow-429880