-
SEO 메타 태그를 데이터베이스로 전환해 배포 없이 즉시 반영
동적 서비스의 메타데이터 관리는 늘 난제다. 내가 이번에 진행한 건 기존의 하드코딩된 SEO 메타 태그를 데이터베이스 기반으로 전환하는 파일럿 작업이다. 정적 사이트 생성(SSG) 프레임워크인 Astro 환경에서 런타임 데이터를 활용해 메타 정보를 관리하는 방식으로 전환했으니, 그 과정과 배운 점들을 정리해본다.
읽기 → -
SEO 크롤링 DB 부하를 인메모리 캐시로 줄인 과정
SEO 메타데이터나 사이트맵 같은 정적에 가까운 데이터들을 매번 DB에서 조회하는 게 병목이 되고 있었다. 특히 검색 엔진 크롤러나 사용자 요청이 몰릴 때 DB 압력이 심해지더라. 그래서 SEO 관련 DB 모듈에 인메모리 캐시를 덧붙이기로 했다.
읽기 → -
CMS SEO 백필 스크립트를 안전한 마이그레이션으로 만드는 법
CMS의 사이트 메타정보 중 SEO 필드가 누락되어 있어서, 이를 한 번에 채워주는 백필 스크립트를 작성했다. 언뜻 간단해 보이는 작업이지만, 1회성 데이터 마이그레이션이라는 특성 때문에 설계 단계부터 신경 써야 할 게 많았다.
읽기 → -
SEO 메타 정보를 DB에서 동적으로 관리하는 구조로 전환
SEO 메타 정보를 데이터베이스에서 동적으로 가져오는 헬퍼 함수를 Python과 JavaScript로 각각 구현했다. 정적인 메타 정보 관리에서 벗어나 확장성 있는 구조로 개선하는 작업이었다.
읽기 → -
블로그 nginx에서 리다이렉트 롤백과 RSS CORS 문제 해결
blog 도메인의 nginx 설정을 정리하는 과정에서, 앞서 준비했던 301 리다이렉트를 되돌리고 동시에 RSS 피드의 CORS 문제를 해결했다. 겉보기 단순한 설정 변경이지만, 그 뒤에는 의사결정의 변화와 우선순위 조정이 있었다.
읽기 → -
블로그 서브도메인 통합과 301 리다이렉트로 URL 단절 방지
개인 블로그의 정보 아키텍처를 정리하면서 6개의 포스트를 blog.hedvion 도메인에서 www/insights 경로로 옮겼다. 이 과정에서 nginx 설정에 301 리다이렉트 규칙들을 추가해 기존 링크들이 깨지지 않도록 처리했는데, 단순해 보이는 작업이지만 안고 있는 배경과 고려사항들이 생각보다 많더라.
읽기 → -
Discord 알림을 Embed 형식으로 전환해 가시성 개선
Discord 알림 시스템의 메시지 가시성을 개선하기 위해 사이트 온보딩과 메타 체크 두 모듈의 알림을 일반 텍스트 포맷에서 discord_embed 형식으로 전환했다.
읽기 → -
크론 스크립트 백업과 실행 권한을 문서화해 운영 불확실성을 줄였다
프로덕션 환경에서 24/7 돌아가는 자동화 스크립트들의 설정을 백업하고 실행 권한 요구사항을 명확히 문서화했다.
읽기 → -
SEO 메타데이터 검증 크론을 코드로 버전 관리하기 시작했다
SEO 메타데이터 검증 크론 작업의 설정을 코드 저장소에 명시적으로 추적하는 작업을 했다. 자동화 작업(chore)이라고 표기했지만, 사실 운영 안정성과 팀 커뮤니케이션에 꽤 중요한 변경이었다.
읽기 → -
22개 이커머스 사이트 메타 태그를 AI로 자동 감시한 방법
한 이커머스 서비스의 경우 여러 도메인과 런딩페이지를 동시에 운영하면서 각 사이트의 메타 태그가 검색 최적화 기준을 만족하는지 확인하는 게 점점 부담이 됐다. 손으로 하나하나 확인할 수 없는 규모가 되자, 결국 자동화된 SEO 감시 도구를 만들기로 결정했고 이게 meta-check.py다.
읽기 → -
daily-bible 모듈에 TypeScript strict 모드 타입
daily-bible 모듈의 서버 응답 처리 부분에서 TypeScript strict 모드 빌드를 통과하기 위해 res.json() 반환값의 타입을 명시적으로 캐스팅했다.
읽기 → -
SEO 모니터링 사이트 설정을 단일 모듈로 중앙화한 이유
들어가면서, 최근 한 refactor 작업으로 SEO 모니터링 시스템의 설정 관리를 다시 정리했다. _lib/gsc_submit.py와 seo-monitor/daily-report.py에 흩어져 있던 하드코딩된 SITES 목록을 sites.py 헬퍼 모듈로 통합하는 작업이었다. 작은 작업처럼 보이지만, 이 과정에서 팀 코드 관리의 질과 유지보수 비용에 대해
읽기 → -
자동화 봇 브로드캐스트의 깨진 URL을 ID 기반으로 수정
money-bot이 보내는 broadcast 메시지의 URL을 레거시 형식 /{slug}/에서 새로운 형식 /p/{id}/로 변경했다. 작은 것 같지만 자동화 시스템의 신뢰성을 크게 좌우하는 변경이었다.
읽기 → -
사이트맵 포스트 URL을 ID 기반 경로로 정규화해 SEO 신호 명확화
사이트맵의 포스트 URL을 기존 /{slug}/ 형식에서 새로운 /p/{id}/ 형식으로 정규화했다. 작은 변경처럼 보이지만, SEO 관점에서는 사이트의 URL 신호를 명확히 하는 중요한 작업이었다.
읽기 → -
디스코드 리뷰 링크를 ID 기반 경로로 교체해 장기 안정성 확보
review_loop 에서 Discord 에 보내는 원문 링크의 URL 형식을 legacy slug 방식에서 새로운 ID 기반 경로(/p/{id}/)로 변경했다. 작은 수정 같지만 이 과정에서 URL 마이그레이션의 관점과 팀 도구의 안정성을 다시 생각하게 됐다.
읽기 → -
대시보드 사이트 모니터링 설정 누락 수정과 재발 방지
대시보드에서 활성 사이트를 추적하기 위해 SITE_EXPECTED_INTERVAL 사전에 누락된 항목을 추가했다. 겉보기엔 작은 수정이지만, 이런 configuration 누락이 가지는 영향과 팀 단계에서 이를 방지하는 방법을 함께 정리해본다.
읽기 → -
nginx 사이트 자동 발견·등록으로 운영 수동 작업 제거
새로운 nginx 사이트를 수동으로 등록하는 번거로움을 줄이기 위해 자동 발견·등록 로직을 _lib에 추가했다.
읽기 → -
블로그 봇 마크다운 JSON 파싱 실패율을 낮춘 방법
블로그 자동화 봇이 마크다운 형식의 JSON 데이터를 파싱할 때 자꾸 실패하는 문제가 있었다. parse_json_block 함수의 호환성을 개선해 다양한 포맷을 수용하도록 했다.
읽기 → -
CMS 사이트 메타데이터를 LLM으로 자동 학습하는 구조 구축
CMS 시스템의 각 사이트가 메타데이터를 자동으로 학습하도록 site_learner.py를 구현했다. Claude CLI와 Sonnet 모델을 활용해 cms_site.meta 스키마를 동적으로 파악하는 작업이었다.
읽기 → -
자동화 사이트 정보를 단일 출처로 통합해 일관성 확보
자동화 시스템이 커질수록 설정 관리가 복잡해진다. 이번엔 hedvion 자동화의 사이트 정보를 한 곳으로 모아, 일관성을 높이는 구조로 개선했다.
읽기 →