Search Console API로 SEO 성과 자동 리포트 만들기

• #블로그 운영 자동화

웹사이트의 검색 엔진 최적화(SEO) 성과를 분석할 때 구글 서치콘솔(Google Search Console)은 필수적인 도구입니다. 하지만 매주 또는 매달 수동으로 데이터를 다운로드하고 보고서를 작성하는 일은 번거롭고 많은 시간이 소요됩니다. 특히 구글 서치콘솔 웹 UI에서는 한 번에 내보낼 수 있는 데이터 행(Row) 수에 제한이 있어, 대량의 키워드 데이터를 상세히 분석하기 어렵습니다.

이러한 문제를 해결하는 가장 효과적인 방법이 바로 구글 서치콘솔 API 자동화입니다. API를 활용하면 수작업 없이 대용량 데이터를 자동으로 수집하고, 실시간으로 업데이트되는 SEO 성과 리포트를 구축할 수 있습니다.

구글 서치콘솔 API 자동화가 필요한 이유

1. 데이터 수집 한계 극복: 웹 UI에서 제공하는 다운로드 제한을 넘어 더 많은 행의 검색 쿼리 및 페이지 데이터를 한 번에 가져올 수 있습니다.
2. 리포트 작성 시간 단축: 매번 반복되는 데이터 추출, 가공, 시각화 과정을 완전히 자동화하여 업무 효율성을 높입니다.
3. 통합 분석의 용이성: 구글 스프레드시트, 데이터베이스(BigQuery 등), 시각화 도구(Looker Studio)와 직접 연동하여 다른 마케팅 데이터와 함께 분석할 수 있습니다.

API 자동 리포트 구축 3단계 프로세스

구글 서치콘솔 API를 활용하여 자동화 리포트를 만드는 과정은 크게 다음과 같은 단계로 진행됩니다.

1. Google Cloud 프로젝트 생성 및 API 활성화 구글 클라우드 콘솔(Google Cloud Console)에 접속하여 새 프로젝트를 생성한 후, ’Google Search Console API’를 검색하여 활성화합니다.

2. 사용자 인증 정보(Credentials) 구성 API에 안전하게 접근하기 위해 인증 키를 발급받아야 합니다. 일반적으로 자동화 스크립트나 서버 간 연동에는 ‘서비스 계정(Service Account)’ 키를 생성하여 JSON 파일로 다운로드하는 방식이 사용됩니다.

3. 데이터 연동 및 시각화 파이썬(Python) 라이브러리를 사용하거나 구글 앱스 스크립트(Google Apps Script)를 활용해 API 데이터를 호출합니다. 수집된 데이터는 구글 스프레드시트에 자동으로 기록되거나, 루커 스튜디오(Looker Studio)와 같은 대시보드 도구와 연동하여 실시간 리포트로 시각화합니다.

자동화 리포트에 포함해야 할 핵심 SEO 지표

정확한 SEO 성과 측정을 위해 API로 수집하는 리포트에는 아래 4가지 핵심 지표가 반드시 포함되어야 합니다.

• 클릭수(Clicks): 검색 결과를 통해 웹사이트로 유입된 사용자의 수입니다.
• 노출수(Impressions): 웹사이트 링크가 구글 검색 결과에 노출된 횟수입니다.
• 클릭률(CTR): 노출 대비 클릭이 일어난 비율로, 메타 태그의 매력도를 평가하는 기준이 됩니다.
• 평균 게재순위(Average Position): 검색 결과에서 웹사이트 페이지들이 기록한 평균 순위입니다.

설정 중 자주 발생하는 오류

API 연동을 처음 시도할 때 막히는 지점은 대체로 정해져 있습니다.

• 403 Permission Denied 오류: 서비스 계정을 생성했더라도, 해당 계정 이메일을 서치콘솔의 [설정] > [사용자 및 권한]에 별도로 추가해 주지 않으면 API 호출이 거부됩니다. 서비스 계정 키 발급과 서치콘솔 권한 부여는 별개의 단계라는 점을 놓치기 쉽습니다.
• 속성(Property) 유형에 따른 데이터 접근 범위 차이: 도메인 속성(Domain Property)과 URL 접두어 속성(URL-prefix Property) 중 어떤 것으로 등록했는지에 따라 API로 가져올 수 있는 데이터 범위가 달라질 수 있습니다. 서브도메인이나 http/https를 모두 포함해 분석하고 싶다면 도메인 속성 기준으로 데이터를 다루는 것이 유리합니다.
• 데이터 지연: 서치콘솔 데이터는 실시간이 아니라 보통 2~3일의 처리 지연이 있습니다. “오늘 발행한 글의 오늘 성과”를 API로 즉시 조회하려 하면 데이터가 비어 있는 것이 정상이며, 이는 API의 결함이 아니라 서치콘솔 자체의 데이터 처리 방식입니다.

어떤 방식으로 리포트를 구성할지 결정하기

자주 묻는 질문

Q. API로 가져온 순위 데이터가 서치콘솔 화면과 살짝 다르게 보입니다. 왜 그런가요? API와 웹 UI가 동일한 원본 데이터를 사용하더라도, 집계 방식(디바이스별 합산, 기간 구분 등)이나 필터 조건이 다르면 화면에 보이는 숫자가 미세하게 달라 보일 수 있습니다. 두 화면을 비교할 때는 같은 필터 조건(기간, 디바이스, 국가)을 동일하게 맞췄는지 먼저 확인하는 것이 좋습니다.

Q. 굳이 API까지 써야 할까요? 서치콘솔 화면만 봐도 되지 않나요? 글이 적을 때는 화면만으로 충분하지만, 페이지·키워드 수가 늘어나면 웹 UI의 다운로드 행 제한에 자주 부딪히게 됩니다. 특히 여러 페이지의 데이터를 시계열로 추적하거나 다른 마케팅 데이터와 함께 분석하려면 API 자동화가 훨씬 효율적입니다.

API를 활용한 자동화 환경을 구축하면 데이터 수집에 드는 시간을 크게 줄이고, 실질적인 SEO 개선 전략을 세우는 데 더 많은 시간을 투자할 수 있습니다. 처음 설정할 때 권한·속성 유형·데이터 지연 세 가지만 미리 이해해 두면 이후 트러블슈팅에 드는 시간을 크게 아낄 수 있습니다.