GSC 포트폴리오 감사
Search Console 계정의 모든 속성에 대해 "전체적으로 어떻게 돌아가고 있나?"라는 질문에 답합니다. 이는 사이트별 도구로는 수십 번의 수동 내보내기 없이는 답할 수 없는 질문입니다.
설정
https://www.googleapis.com/auth/webmasters.readonly 범위의 OAuth 리프레시 토큰이 필요합니다:
export GOOGLE_GSC_CLIENT_ID=... # 또는 GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=... # 또는 GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com" # 선택 사항, 쉼표로 구분
pip install requests
가장 흔한 설정 실패는 토큰 갱신 시 unauthorized_client입니다. 이는 리프레시 토큰이 현재 사용 중인 ID/비밀번호와 다른 OAuth 클라이언트에 대해 발급되었음을 의미합니다. 시간이 지남에 따라 Google 통합을 추가한 계정은 일반적으로 여러 클라이언트를 보유하고 있습니다. 토큰을 발급한 쌍을 일치시키세요.
실행
python3 scripts/audit_gsc.py # 전체: 상위 12개 사이트에 대한 순위 및 키워드 차이 분석
python3 scripts/audit_gsc.py portfolio # 순위 테이블만 표시
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90 # 분기 대비
플래그: --days (기간, 직전 동일 기간과 비교), --site (반복 가능), --top, --limit, --min-clicks.
섹션 및 의미
| 섹션 | 해석 방법 |
|---|---|
| NEW | 이전 기간에 클릭이 전혀 없었던 쿼리. 실제 성장이 발생하는 곳입니다. |
| RISING | 50% 이상 상승. 위치도 함께 이동했는지 확인하세요. 이동하지 않았다면 수요가 증가한 것이지 순위가 오른 것이 아닙니다. |
| DROPPING | 실제 기준보다 40% 이상 하락. 위치가 어떤 종류인지 알려줍니다: 순위 하락 = 순위 손실; 순위는 유지되었지만 클릭이 급감 = 상단에서 클릭을 가져간 무언가(AI 개요, 새로운 SERP 기능, 또는 쿼리 자체 변화). |
| LOST | 이전에는 순위에 있었지만 지금은 데이터 없음. |
| CTR GAP | 노출수 1,500 이상, 상위 10위, CTR 2% 미만. 제목과 설명을 다시 작성하는 것이 가장 저렴한 개선책입니다. |
해석
- 클릭을 먼저 보고, 그 다음에 노출수를 보세요. 하나의 큰 속성이 포트폴리오 노출수를 충분히 흔들어 다른 모든 것이 성장한 것을 가릴 수 있습니다.
- 브랜드 키워드와 비브랜드 키워드를 분리하세요. 전체 키워드 세트가 자체 이름(또는 경쟁사의 오타)뿐인 사이트는 클릭수가 아무리 좋아도 획득 엔진이 없는 것입니다. 보고서에 명확히 언급하세요.
- 전체 사이트가 자체 헤드 텀에서 붕괴하는 것은 일반적으로 SEO 문제가 아닙니다. 순위 진단 전에 소유권을 확인하세요:
whois <domain> | grep -i "registrar\|updated date"및 여전히 사이트가 응답하는지 확인. 만료, 이전 또는 분쟁 중인 도메인은 전형적인 순위 절벽을 생성하며 SEO 작업으로 해결할 수 없습니다. - 포트폴리오 테이블의 "new"는 이전 기간에 클릭이 0이었음을 의미합니다. 최근에 출시된 사이트의 경우 데이터 공백이 아니라 출시입니다.
- 읽을 수 없는 언어의 쿼리를 건너뛰지 마세요. 다국적 사이트의 경우 성장은 대개 비영어 롱테일에서 발생합니다. 걸러내지 말고 흥미로운 쿼리를 번역하세요.
- 403을 반환하는 속성은 검색결과 등록은 되어 있지만 검색 애널리틱스는 허용되지 않은 것입니다. 스크립트는 이를 숨기지 않고 보고합니다.
참고 사항
- GSC 데이터는 약 3일 지연됩니다. 스크립트가 이를 자동으로 보정합니다.
- 두 기간 모두 속성별로 병렬로 가져오므로 40개 속성 계정도 몇 초 만에 완료됩니다.
- 쿼리 행 수는 기간당 25,000개로 제한되며, 이는 28일 기간 동안 단일 사이트가 반환하는 양보다 훨씬 많습니다.