구글 서치 콘솔(GSC) API 기초 세팅 | 파이썬으로 내 블로그 검색 트래픽 데이터 수집하기

매번 구글 서치 콘솔에 직접 들어가서 데이터를 확인하는 게 번거로워서, 파이썬으로 10초 만에 데이터를 뽑아보는 세팅을 직접 해봤거든요. 복잡해 보이지만 딱 필요한 설정만 따라 하면 누구나 하실 수 있답니다.

💡 핵심 요약

데이터 수집 자동화로 매일 15분 이상의 분석 시간 절약

GSC API 연동으로 90일치 상세 검색 트래픽 데이터 즉시 추출

파이썬 라이브러리 활용하여 50줄 이내의 코드로 데이터 처리 가능

단계	필수 항목	예상 소요 시간
프로젝트 생성	구글 클라우드 계정	5분
API 활성화	서치 콘솔 API	2분
인증 파일 발급	JSON 키 파일	3분
데이터 수집	파이썬 스크립트	5분

🚀 구글 클라우드 프로젝트 생성하기

먼저 Google Cloud Console에 접속해서 새 프로젝트를 생성해야 해요. 프로젝트 이름을 정하고 만들기 버튼을 누르면 되는데, 이때 프로젝트 ID를 메모장에 따로 복사해두는 게 나중에 훨씬 편하답니다.

💡 꿀팁! 프로젝트 이름은 'gsc-data-collector'처럼 소문자와 하이픈을 사용해 짧게 지어야 나중에 코드에서 꼬이지 않아요.

⚠️ 주의사항: 결제 계정 설정 창이 뜨더라도 API 사용 목적이라면 별도의 비용 발생 없이 무료로 충분히 활용할 수 있어요.

⚙️ Search Console API 활성화

좌측 사이드바의 API 및 서비스 메뉴에서 라이브러리로 들어간 뒤, 'Google Search Console API'를 검색해서 활성화하세요. 이 과정을 거쳐야만 파이썬 코드가 구글 서버와 안전하게 통신할 수 있게 된답니다.

💡 꿀팁! 검색창에 'Search Console'이라고만 쳐도 바로 나오니 당황하지 마세요.

🔐 서비스 계정 및 JSON 키 발급

사용자 인증을 위해 서비스 계정을 만들고 '편집자' 권한을 부여하세요. 마지막에 JSON 형식의 키 파일을 다운로드하게 되는데, 이 파일은 암호와 같으니 절대 타인에게 공유하면 안 된답니다.

💡 꿀팁! 다운로드한 JSON 파일 이름을 'credentials.json'으로 바꾸면 파이썬 코드 수정 없이 그대로 사용할 수 있어 편리해요.

⚠️ 주의사항: 키 파일 내부에 적힌 이메일 주소를 복사해서 실제 내 구글 서치 콘솔 '사용자 및 권한' 설정에서 소유자로 추가해줘야 데이터가 보입니다.

🐍 파이썬 환경 세팅 및 라이브러리 설치

터미널에서 pip install google-api-python-client 명령어를 입력해 필요한 라이브러리를 설치하세요. 이제 파이썬에서 구글 서비스 라이브러리를 불러와서 앞서 받은 JSON 키와 연결하기만 하면 모든 준비가 끝난답니다.

💡 꿀팁! 가상환경(venv)을 만들어서 설치하면 다른 프로젝트와 패키지 버전이 섞이지 않아 깔끔해요.

📊 데이터 수집 스크립트 작성

이제 분석할 데이터 기간과 사이트 주소를 지정해서 API를 호출해보세요. 특정 키워드로 들어온 방문자가 몇 명인지, 클릭률은 몇 퍼센트인지 상세한 수치를 리스트 형태로 바로 받아볼 수 있어요.

💡 꿀팁! 처음에는 전체 데이터를 다 가져오지 말고, 상위 10개 키워드만 먼저 출력해 보세요. 데이터 구조를 파악하는 데 30초면 충분하거든요.

📝 실전 적용 후기

저도 처음에는 코딩이 막막했는데, 2026년 들어서 매주 업데이트되는 데이터를 직접 시각화해보니 어떤 글이 반응이 좋은지 한눈에 들어오더라고요. 수동으로 엑셀 정리하던 시절보다 데이터 정확도가 100% 올라가서, 지금은 더 전략적인 글쓰기가 가능해졌답니다.

💡 꿀팁! 수집된 데이터를 판다스(Pandas) 라이브러리를 사용해 엑셀 파일로 자동 저장되게 만들면 매주 월요일 오전마다 데이터 리포트를 바로 받아볼 수 있어요.

❓ 자주 묻는 질문

Q. API 사용료가 따로 발생하나요?

아니요, 구글 서치 콘솔 API는 현재 기준 무료로 제공되며 호출 제한 내에서는 비용 걱정 없이 이용 가능합니다.

Q. 파이썬 초보자도 할 수 있나요?

네, 제공되는 구글 공식 가이드의 샘플 코드를 그대로 활용하면 수정할 부분은 5줄 내외라 초보자도 충분히 가능합니다.

Q. 과거 데이터를 1년 치 한꺼번에 가져올 수 있나요?

GSC API는 최대 90일 전까지의 검색 트래픽 데이터를 수집할 수 있도록 설계되어 있습니다.

Q. JSON 키 파일을 잃어버리면 어떻게 하죠?

구글 클라우드 콘솔에서 기존 키를 삭제하고 새로운 키를 발급받아 프로젝트에 다시 연결하면 됩니다.

Q. 여러 블로그를 동시에 관리할 수 있나요?

네, 인증된 서비스 계정을 각 블로그의 서치 콘솔 권한에 추가하기만 하면 하나의 코드로 여러 사이트 데이터를 수집할 수 있습니다.

Q. 데이터 수집 시 에러가 나면 어떻게 하나요?

대부분 권한 설정 문제인데, 서치 콘솔의 사용자 권한에서 서비스 계정 이메일이 정확히 등록되었는지 30초 내로 확인해 보세요.

작성자: 로그

파이썬을 활용해 웹 스크래핑과 업무 자동화 프로그램을 개발하며 디지털 자산을 키워가는 평범한 직장인입니다. 반복되는 작업은 코드에 맡기고, 실무에서 직접 부딪히며 얻은 구체적인 문제 해결 노하우를 기록하고 공유합니다.