포스트

구글 SEO의 치트키: Google Indexing API 자동화로 검색 노출 시간 단축하기 (Feat. Python)

구글 SEO의 치트키: Google Indexing API 자동화로 검색 노출 시간 단축하기 (Feat. Python)

Search Engine Optimization

“글을 발행했는데 왜 구글에 안 뜨지?” 블로그를 운영하는 분들이라면 누구나 한 번쯤 겪는 고민입니다. 구글 봇(Google Bot)이 내 사이트를 크롤링해갈 때까지 기다리는 것은 너무나 수동적이고, 때로는 며칠이 걸리기도 합니다.

오늘은 이 답답한 시간을 획기적으로 줄여줄 수 있는 Google Indexing API 자동화 방법을 소개합니다. Python 기반의 오픈소스 도구인 google-search-console-indexer를 활용하면, 터미널 명령어 한 번으로 구글에게 “내 글 좀 빨리 가져가!”라고 직접 요청을 보낼 수 있습니다.

1. Google Indexing API란?

Google Indexing API는 웹사이트 소유자가 페이지의 추가나 삭제를 구글에 즉시 알릴 수 있는 도구입니다. 원래는 채용 정보(JobPosting)나 라이브 스트리밍(BroadcastEvent)처럼 시의성이 중요한 콘텐츠를 위해 만들어졌지만, 현재는 일반 웹페이지의 빠른 색인(Indexing) 을 위해서도 널리 사용되고 있습니다.

이 API를 사용하면 구글 서치 콘솔(GSC)에서 일일이 ‘색인 생성 요청’ 버튼을 누르는 수고를 덜 수 있습니다.

2. 핵심 준비물: 구글 서비스 계정 (Service Account)

API를 사용하려면 ‘열쇠’가 필요합니다. 구글 클라우드 플랫폼(GCP)에서 서비스 계정을 만들고 JSON 키를 발급받아야 합니다. 과정이 조금 복잡해 보일 수 있지만, 아래 가이드를 따라 차근차근 진행하면 누구나 할 수 있습니다.

[필수 설정 단계]

  1. Google Cloud Console에서 프로젝트 생성
  2. Web Search Indexing API 사용 설정
  3. 서비스 계정 생성 및 JSON 키 다운로드 (service_account.json)
  4. ★중요★ 서비스 계정 이메일(~@appspot.gserviceaccount.com)을 구글 서치 콘솔의 ‘사용자 및 권한’에 추가 (소유자 권한)

상세한 이미지와 함께 단계별 설명이 필요하다면, 아래 링크를 반드시 참조하여 설정을 완료해 주세요.

참고 가이드: Google Indexing API 서비스 계정 생성 및 GSC 연동 완벽 가이드

3. 도구 소개: google-search-console-indexer

복잡한 코딩 없이, 설정 파일만으로 인덱싱을 자동화해주는 고마운 오픈소스입니다.

이 도구는 우리가 발급받은 JSON 키를 사용하여 구글 API와 통신하고, 지정된 URL들을 대신 제출해줍니다.

4. 설치 및 사용 방법

이제 실제로 도구를 설치하고 실행해 보겠습니다. 컴퓨터에 Python이 설치되어 있어야 합니다.

Coding Setup

4-1. 프로젝트 다운로드

터미널(맥/리눅스)이나 명령 프롬프트(윈도우)를 열고 다음 명령어를 입력합니다.

1
2
3
git clone [https://github.com/wakenhole/google-search-console-indexer.git](https://github.com/wakenhole/google-search-console-indexer.git)
cd google-search-console-indexer
pip install -r requirements.txt

4-2. JSON 키 파일 배치

앞서 2번 단계에서 다운로드한 JSON 키 파일의 이름을 service_account.json으로 변경한 뒤, 방금 다운로드한 google-search-console-indexer 폴더 안에 넣어줍니다.

4-3. 타겟 URL 설정

target_urls.txt (또는 urls.txt) 파일을 열어 색인을 요청하고 싶은 내 블로그 주소를 입력합니다. 한 줄에 주소 하나씩 입력하면 됩니다.

1
2
[https://myblog.com/new-post-1/](https://myblog.com/new-post-1/)
[https://myblog.com/new-post-2/](https://myblog.com/new-post-2/)

4-4. 실행하기

모든 준비가 끝났습니다. 아래 명령어로 스크립트를 실행합니다.

1
python main.py

실행 화면에서 [200] OK 메시지가 뜬다면 성공입니다! 구글에게 “이 페이지 좀 봐줘”라고 성공적으로 전달된 것입니다.

5. 마치며: SEO는 속도전이다

이제 글을 발행하자마자 터미널을 열고 명령어 한 줄만 입력하세요. 며칠을 기다려야 했던 검색 노출이 단 몇 시간, 빠르면 몇 분 안에도 이루어질 수 있습니다.

주의사항:

  • API에는 일일 사용량 제한(Quota)이 있습니다. 무분별한 요청은 피해주세요.
  • service_account.json 파일은 보안상 매우 중요하므로 절대 외부에 노출되지 않도록 주의하세요.

여러분의 양질의 콘텐츠가 더 많은 사람들에게 닿기를 바랍니다.


References:

  1. Google Indexing API 설정 가이드 (pocodingwer 블로그)
  2. google-search-console-indexer GitHub 저장소

이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.

© wakenhole. 일부 권리 보유

Powered by Jekyll with Chirpy theme