[Python] 티스토리 글 자동 색인 도구 만들기

구글 색인이 느리거나 누락되는 상황을 자동화로 개선할 수 없을까 고민하다가, Python으로 간단한 도구를 만들어봤습니다.
현재는 PyPI에 배포되어 누구나 사용할 수 있도록 공개되어 있습니다.
이 글에서는 해당 자동화 도구의 사용법과 설치 방법을 정리해드릴게요.

---

✅ 이 도구는 어떤 기능을 하나요?

• 티스토리 블로그의 sitemap.xml을 분석하여 글 목록을 수집합니다.
• 최근에 작성/수정된 글부터 순서대로 확인합니다.
• Google Indexing API를 통해 색인되지 않은 글만 자동으로 요청합니다.
• 이미 색인된 글은 건너뜁니다.

---

📦 설치 방법

이 도구는 PyPI에 tistory-indexer라는 이름으로 배포되어 있습니다.
Python 3.11 이상에서 설치 가능합니다:

pip install tistory-indexer

---

⚙️ 사전 준비 사항

1. Google Cloud Console에 접속해 프로젝트를 생성합니다.
2. API 및 서비스 > 라이브러리에서 아래 API를 활성화합니다
   1.  Indexing API
   2. Google Search Console API
3. 사용자 인증 정보 > OAuth 클라이언트 ID를 생성합니다.
   1. 애플리케이션 유형: 데스크톱 앱
   2. JSON 형식의 키 파일을 다운로드 (예: oauth_credentials.json)
4. Google Search Console에서 블로그가 등록되어 있어야 하며, OAuth 클라이언트에 사용된 Google 계정을 Search Console 대상 > 테스트 사용자에 등록해야 합니다.

---

🧪 사용 예시

다음은 Python 코드로 색인 요청을 실행하는 예시입니다.

from tistory_indexer import TistoryIndexer

indexer = TistoryIndexer(
    tistory_blog_url="https://your-blog.tistory.com", # 자신의 티스토리 블로그 주소
    oauth_credentials_path="oauth_credentials.json" # 같은 경로에 위치한 json 파일
)

indexer.run(pages=5)  # 가장 최근 수정된 글 중 최대 5개 색인 요청

pages=5는 최근 5개 글을 대상으로 요청하겠다는 의미입니다.
너무 많은 요청은 피하고, Google의 하루 요청 제한(200개)을 고려해 주세요.

---

📋 옵션 설명

옵션	설명
tistory_blog_url	자신의 티스토리 블로그 주소
oauth_credentials_path	Google OAuth 인증 키(JSON) 파일 경로

---

⚠️ 사용 시 주의사항

이 도구는 Google API를 자동으로 사용하는 오픈소스입니다.
색인 요청 실패, API 제한, 예기치 않은 결과 등은 사용자 책임 하에 처리되어야 하며, 개발자는 이에 대해 책임지지 않습니다.

---

필요하셨던 기능이라면 직접 사용해보시고, 개선 아이디어나 피드백도 언제든지 환영합니다!
전체 코드는 GitHub에 공개되어 있으며, PyPI를 통해 설치 가능합니다.

• PyPI: https://pypi.org/project/tistory-indexer
• GitHub: https://github.com/ouohoon/tistory-indexer