Skip to content

[DB-1025] feat: SEO 분석 결과를 구글 시트에 누적한다 - #560

Merged
guesung merged 2 commits into
masterfrom
guesung/seo-분석-구글시트-누적
Sep 22, 2026

Hidden character warning

The head ref may contain hidden characters: "guesung/seo-\ubd84\uc11d-\uad6c\uae00\uc2dc\ud2b8-\ub204\uc801"
Merged

guesung merged 2 commits into
masterfrom
guesung/seo-분석-구글시트-누적

Conversation

@guesung

@guesung guesung commented Sep 22, 2026

Copy link
Copy Markdown
Owner

설명

SEO 하네스의 실행 결과를 GA 분석과 같은 Google Sheets에 장기 누적합니다. Actions 아티팩트는 원본 확인용으로 30일 유지하고, 비교 분석에 필요한 요약·변경 이벤트·GSC 지표는 시트에 멱등 적재합니다.

변경

  • SEO Runs, SEO Issue Events, GSC Index, GSC Performance, SEO Changes 탭을 자동 생성합니다.
  • 실행 ID와 시도 번호를 키로 사용해 동일 적재 재시도 시 기존 행을 갱신합니다.
  • 오류·경고·정상 페이지 비율, 신규·지속·해소·관측 불가 이슈, GSC 주간 성과를 저장합니다.
  • GA 작업의 GA_SHEET_ID, GA4_SERVICE_ACCOUNT_JSON을 재사용하되 서로 다른 탭에 기록합니다.
  • 설정이 없으면 Sheets 적재만 경고와 함께 건너뛰고, 설정 후 API 오류는 워크플로 실패로 드러냅니다.
  • 환경 변수 매니페스트와 운영 문서를 갱신합니다.

관련 이슈

변경 유형

  • 기능 추가
  • 테스트 추가
  • 문서 수정

체크리스트

  • Sheets 관련 Vitest 18개 통과
  • pnpm check 통과(기존 경고 11개 유지)
  • pnpm type-check:scripts 통과
  • pnpm type-check 통과
  • 환경 변수 매니페스트 정합 검사 통과
  • 실제 Google Sheets API 적재 및 동일 키 재시도 중복 방지 확인
  • 서비스 계정 편집 권한과 GitHub Secret 등록 확인
  • 독립 코드 리뷰 완료

GA 분석과 같은 개인 스프레드시트에 실행 요약, 이슈 변화, GSC 지표를 멱등 적재해 장기 추이를 비교할 수 있게 한다.
@notion-workspace

Copy link
Copy Markdown

SEO 하네스 설치

@guesung guesung self-assigned this Sep 22, 2026
GA 주간 수치와 SEO 이력이 한 스프레드시트 ID를 나눠 쓰면, 한쪽이 Secret을
바꿨을 때 다른 쪽이 경고 없이 남의 시트에 쓴다. 실제로 GA 백필 한 번이
SEO 시트에 요약·이벤트 탭을 만들었다. 폴백은 두지 않는다.
@guesung
guesung merged commit 7d44367 into master Sep 22, 2026
16 checks passed
@guesung
guesung deleted the guesung/seo-분석-구글시트-누적 branch September 22, 2026 21:55

This branch was successfully deployed

1 active deployment
Preview d6bf940a Deployed Sep 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant