문서
IndexNow: 페이지가 변경되면 Bing 및 기타 검색엔진에 알리기
IndexNow 키를 설정하고 키 파일을 게시한 뒤, 새로 추가·수정·삭제된 URL을 Bing, Yandex, Naver 등의 검색엔진에 전송하세요. 모든 응답은 기록됩니다.
IndexNow는 URL이 추가, 변경 또는 삭제되었음을 검색엔진에 알려 주는 개방형 프로토콜입니다. 검색엔진이 해당 URL을 다시 발견할 때까지 기다리지 않고 곧바로 크롤링할 수 있습니다. 한 번 제출하면 참여하는 모든 검색엔진에 공유되며(IndexNow documentation), 여기에는 Bing, Yandex, Naver, Seznam.cz, Yep이 포함됩니다(IndexNow FAQ). Google은 참여하지 않습니다. Google에는 recrawl guidance에 설명된 대로 사이트맵을 최신 상태로 유지하고 URL Inspection을 사용하세요.
키 설정하기
IndexNow는 키로 사이트 소유권을 확인합니다. 키는 제출할 때마다 함께 전송하는 문자열이며, 사이트에 텍스트 파일로도 게시해야 합니다.
- IndexNow API key 아래에서 Generate를 눌러 무작위 32자 키를 만들거나, 8~128자의 영문자, 숫자, 대시로 이루어진 키를 직접 입력합니다. 그런 다음 Save key를 누릅니다.
- Download key file을 누릅니다. 키만 들어 있는
<key>.txt파일이 다운로드됩니다. - 이 파일을 사이트 루트에 업로드하여
https://<your host>/<key>.txt주소로 접근할 수 있게 합니다. Copy URL을 누르면 정확한 주소가 복사됩니다. - Verify key file을 누릅니다. AutoPSEO가 해당 주소를 가져와 본문이 키와 정확히 일치하는지 확인합니다.
제목 옆의 배지에서 현재 상태를 확인할 수 있습니다. 상태는 No key yet, Key saved, not verified, Key file verified, Key file unreachable 중 하나이며, 확인에 실패하면 사유(파일 없음, 내용 불일치, 8초 후 시간 초과)가 함께 표시됩니다. 확인 결과는 7일간 유지되므로, 사이트를 이전하거나 다시 배포한 후에는 다시 확인하세요.
키 파일은 항상 같은 위치에 두어야 합니다. 검색엔진은 사이트 소유 여부를 확인하기 위해 이 파일을 가져오며, 파일이 없거나 내용이 다르면 키가 유효하지 않은 것으로 처리됩니다(아래의 403 응답).
URL 제출하기
Submit URLs to IndexNow에서 소스를 선택합니다.
- Paste URLs: 한 줄에 URL 하나씩 붙여 넣습니다.
- File upload: TXT,
url열이 있는 CSV 또는 사이트맵 XML 파일을 업로드합니다. - From a GSC sitemap 또는 Sitemap URL: 사이트맵에 포함된 모든 URL을 사용하며, 인덱스 파일도 따라가서 처리합니다.
Submit to IndexNow를 누릅니다. 한 번에 최대 10,000개의 URL을 제출할 수 있으며, 이는 프로토콜이 요청당 허용하는 한도입니다. 전송에 앞서 AutoPSEO는 다음 작업을 수행합니다.
- 유효한 URL이 아니거나 속성에 속하지 않는 주소를 제외합니다.
- 스팸으로 간주되어 제한되는 일을 막기 위해, 최근 10분 이내에 이미 제출한 URL을 건너뜁니다.
- 요청 하나에는 호스트 하나만 담을 수 있으므로 나머지 URL을 호스트별로 묶습니다.
결과에는 각 배치와 그 응답, 그리고 건너뛴 URL의 수와 사유가 표시됩니다.
응답 코드의 의미
| 코드 | 라벨 | 의미 |
|---|---|---|
| 200 | OK | 요청이 접수되었고 키는 이미 검증되어 있습니다. |
| 202 | Accepted | 요청이 접수되었으며, 키는 키 파일을 가져와 아직 검증해야 합니다. |
| 400 | Bad request | 요청 형식이 올바르지 않습니다. |
| 403 | Key rejected | 지정된 위치에 키 파일이 없거나 파일 내용이 키와 다릅니다. |
| 422 | Rejected | URL이 해당 호스트에 속하지 않거나 키가 프로토콜 형식에 맞지 않습니다. |
| 429 | Rate limited | 요청이 너무 많아 스팸 가능성이 있는 것으로 처리되었습니다. 잠시 기다린 후 다시 제출하세요. |
| 5xx | Server error | 엔드포인트에서 오류가 발생했습니다. 나중에 다시 시도하세요. |
| - | Failed | 요청이 완료되지 않았습니다. |
200 또는 202는 엔드포인트가 URL을 수신했다는 뜻일 뿐입니다. 검색엔진이 해당 URL을 크롤링하거나 색인했는지는 알려 주지 않으므로, Bing Webmaster Tools 또는 각 검색엔진의 자체 콘솔에서 확인하세요.
제출 기록
Submission history에는 해당 속성에서 전송한 최근 200개 배치가 시간, 호스트, URL 수, 응답과 그 의미와 함께 저장됩니다. 카드에는 Submissions, URLs submitted, Accepted (200 / 202), Rejected or failed의 집계가 표시됩니다. 배치를 열면 그 안에 포함된 모든 URL을 볼 수 있습니다.
제출 시점
페이지를 게시했을 때, 콘텐츠가 의미 있게 바뀌었을 때, 페이지를 삭제하거나 리디렉션했을 때 제출하세요. 변경되지 않은 URL을 다시 제출해도 얻는 것이 없으며 오히려 제한을 받을 수 있습니다. 밀린 URL이 많다면 사이트맵을 한 번만 전송하면 충분합니다.
AutoPSEO의 지원
콘텐츠 엔진이 작성한 글에는 이 페이지를 사용할 필요가 전혀 없습니다. 사이트가 webhook으로 글을 받고 IndexNow 키를 제공하는 경우, AutoPSEO의 ping에 대한 응답에서 해당 키를 알려 줍니다. 그러면 AutoPSEO는 사이트가 수락한 모든 전달 이후에 IndexNow에 알립니다. 이때 사이트가 해당 글에 대해 보고한 모든 언어의 주소(삭제 요청 후에는 더 이상 제공하지 않는 주소)를 사용하며, 전달 실행당 한 번만, 사용자 본인의 호스트에 대해서만 알립니다. 제한되었거나 전달하지 못한 ping은 1시간 후에 다시 시도하며, 이후 최대 하루까지 간격을 두 배씩 늘립니다. 403 또는 422로 거부된 ping은 다시 시도하지 않습니다. 최근 결과는 콘텐츠 페이지에 표시됩니다. AutoPSEO가 대신 호스팅하는 글은 호스팅 렌더러 자체의 키로 제출됩니다. delivery와 hosting을 참고하세요.
관련 문서: Indexing & URL inspection, Bing Webmaster Tools reports.