View Categories

Google 검색 콘솔을 Google 스프레드시트에 연결하는 방법 - SQL로 SEO 데이터 쿼리하기

7분 읽기

Query Streams는 Google Search Console을 Google Sheets에 연결하여 자연 검색 데이터를 필요에 따라 새로 고칠 수 있는 실시간 SQL 쿼리 가능 테이블로 변환합니다. 키워드 순위, 노출수, 클릭률, 페이지별 실적 데이터를 Google Sheets 스프레드시트로 가져올 수 있습니다. CSV 파일로 수동으로 내보내거나 API 코딩을 할 필요가 없습니다. QueryStreams.com에서 무료로 가입하세요. SQL을 사용하여 몇 분 안에 GSC 데이터를 분석해 보세요.

5개의 GSC 테이블

검색 분석, 인기 검색어, 페이지, 국가 및 기기

서비스 계정 인증

OAuth 브라우저 인증 흐름 없음 — 헤드리스 인증을 위해 JSON 키를 붙여넣으세요

AES-256 암호화

서비스 계정 자격 증명은 클라우드가 아닌 네트워크에 저장됩니다.

16개월간의 기록

표준 3개월 UI 제한을 넘어 최대 16개월까지 GSC 데이터에 액세스할 수 있습니다.

Google Search Console에서 어떤 데이터에 접근할 수 있나요?

Query Streams는 GSC 검색 실적 데이터를 SQL 쿼리가 가능한 테이블로 동기화합니다. GSC 데이터는 일반적으로 Google의 처리 파이프라인에서 2~3일 정도 지연되어 제공됩니다.

검색 분석

  • 검색 분석 일일 클릭수, 노출수, 클릭률(CTR) 및 검색어별 순위
  • 상위 쿼리 노출수 및 클릭률(CTR) 지표가 높은 주요 키워드
  • 상위 페이지 페이지 수준 검색 성능 및 순위

청중 분석

  • 국가별 국가별 검색 분석
  • 기기별 데스크톱, 모바일 및 태블릿 검색 성능

데이터 노트

  • GSC 데이터는 구글로부터 2~3일의 처리 지연이 발생합니다.
  • 최대 16개월간의 과거 데이터 이용 가능 (GSC UI에서는 3개월 이용 가능)
  • 데이터는 집계되며, 개별 사용자 세션은 추적되지 않습니다.

주요 열

  • 질문 URL을 표시한 검색 키워드
  • 클릭 구글 검색에서 발생한 클릭 수
  • 인상 URL이 검색 결과에 표시된 횟수
  • 센터 클릭률(클릭수/노출수)
  • 위치 검색 결과에서의 평균 순위

전제 조건

1
스트림 계정 쿼리

무료로 가입하세요 — 신용카드 필요 없음

2
쿼리 스트림 네트워크 에이전트

네트워크에 설치된 Windows 서비스입니다. 설치 가이드

3
구글 클라우드 프로젝트

Google Search Console API가 활성화되어 있고 GSC 속성이 인증된 경우

4
Google 서비스 계정

GSC에 인증된 사용자로 서비스 계정이 추가된 JSON 키 파일

5
Google 스프레드시트

Google Workspace Marketplace에서 Query Streams 추가 기능을 설치하면

설치 가이드

1에이전트 설치
2서비스 계정
3커넥터 추가
4동기화 일정
5추가 기능 설치

1단계: Query Streams 네트워크 에이전트를 설치합니다.

  1. 로그인하세요 my.querystreams.com
  2. 다음으로 이동하세요 네트워크 에이전트 왼쪽 사이드바에
  3. 클릭 다운로드 에이전트 그리고 윈도우 설치 프로그램을 실행하세요.
  4. 에이전트는 Windows 서비스로 설치되며 자동으로 연결됩니다.
  5. 담당 상담원이 30초 이내에 포털에서 "온라인"으로 표시됩니다.

2단계: Google 클라우드 서비스 계정 생성

  1. 가세요 Google 클라우드 콘솔 프로젝트를 생성하거나 선택하세요.
  2. 다음으로 이동하세요 API 및 서비스도서관 → 검색 후 활성화 Google 검색 콘솔 API
  3. 가다 IAM 및 관리자서비스 계정서비스 계정 생성
  4. 이름을 지정하고(예: "query-streams-gsc") 클릭하세요. 생성 및 계속
  5. 선택적 역할 할당 건너뛰기 → 클릭 완료
  6. 서비스 계정을 클릭하세요 → 열쇠 탭 → 키를 추가하세요새 키를 생성하세요JSON
  7. JSON 키 파일이 자동으로 다운로드됩니다. 안전하게 보관하세요.

Google 검색 콘솔에서 액세스 권한 부여

  1. 가다 Google 검색 콘솔 그리고 원하는 부동산을 선택하세요
  2. 클릭 설정사용자 및 권한
  3. 클릭 사용자 추가
  4. 붙여넣으세요 클라이언트 이메일 JSON 키 파일에서
  5. 권한을 설정하세요 가득한 → 클릭 추가하다

3단계: Google 검색 콘솔 커넥터를 추가합니다.

  1. 네트워크 에이전트 인터페이스를 엽니다. http://localhost:1823
  2. 클릭 연결 추가 그리고 선택하세요 Google 검색 콘솔
  3. 내용을 붙여넣으세요 서비스 계정 JSON 키 (또는 파일을 업로드하세요)
  4. 선택 GSC 속성 드롭다운 메뉴에서 (도메인 또는 URL 접두사 속성)을 선택하세요.
  5. 클릭 다음 동기화 일정을 구성하고 사전 구축된 쿼리를 설치합니다.

4단계: 동기화 일정 구성

검색 분석(일별)가장 많이 검색된 검색어, 페이지, 국가 및 기기 정보는 3~4일의 시차를 두고 매일 동기화됩니다.
초기 동기화첫 실행 시 최대 16개월분의 과거 데이터를 가져옵니다.

GSC 데이터는 일반적으로 Google의 처리 파이프라인에서 2~3일 정도 지연되어 표시됩니다. 따라서 매일 동기화하는 것이 가장 이상적이며, 더 자주 동기화한다고 해서 새로운 결과가 나오는 것은 아닙니다. 초기 동기화 시에는 최대 16개월분의 과거 데이터가 불러와지므로, GSC 사용자 인터페이스에서 제공하는 3개월 제한보다 훨씬 더 많은 기록을 확인할 수 있습니다.

5단계: Google Sheets 추가 기능을 설치합니다.

  1. 브라우저에서 Google Sheets를 엽니다.
  2. 가다 확장 기능추가 기능추가 기능을 받으세요
  3. 검색 "쿼리 스트림"
  4. 클릭 설치하다 필요한 권한을 부여합니다.
  5. 다음을 통해 접속하세요 확장 기능쿼리 스트림열려 있는
  6. Query Streams 계정 자격 증명으로 로그인하세요.
  7. 또는 직접 설치하세요: Google 스프레드시트용 쿼리 스트림 설치

연결되었습니다! Google Sheets에서 쿼리 스트림을 열고 클릭하세요. 저장된 쿼리키워드 순위, 클릭률(CTR) 분석, 페이지 실적 등을 위한 사전 구성된 쿼리가 포함된 Google 검색 콘솔 폴더를 찾으세요. 원하는 쿼리를 선택하고 클릭하세요. 실행 GSC의 실시간 데이터를 스프레드시트로 가져오려면.

Google 검색 콘솔 SQL 쿼리 예시

클릭 수 기준 상위 키워드 (지난 30일)
SELECT query, SUM(clicks) AS total_clicks, SUM(impressions) AS total_impressions, ROUND(AVG(ctr) * 100, 2) AS avg_ctr_pct, ROUND(AVG(position), 1) AS avg_position FROM gsc.search_analytics WHERE date >= CURRENT_DATE - INTERVAL '30 days' GROUP BY query ORDER BY total_clicks DESC LIMIT 25;
1페이지 바로 바깥쪽 페이지(위치 11~20)
gsc.top_pages 테이블에서 날짜가 현재 날짜에서 30일을 뺀 값 이상인 페이지를 선택하고, 각 페이지의 평균값을 11에서 20 사이로 정렬한 후, 각 노출수를 내림차순으로 정렬하고, 20까지 제한합니다.
노출 수는 많지만 클릭률(CTR)은 낮은 키워드 (CTR 기회)
SELECT query, SUM(impressions) AS impressions, SUM(clicks) AS clicks, ROUND(AVG(ctr) * 100, 2) AS ctr_pct, ROUND(AVG(position), 1) AS avg_position FROM gsc.search_analytics WHERE date >= CURRENT_DATE - INTERVAL '90 days' GROUP BY query HAVING SUM(impressions) > 500 AND AVG(ctr) < 0.03 ORDER BY impressions DESC LIMIT 20;

GSC 접근 권한 공유 없이 SEO 보고서 공유하기

쿼리 빌더에서 GSC 쿼리를 열고 → 클릭하세요. 공유 탭 → 이메일 주소 입력 → 클릭 공유수신자는 Google 검색 콘솔 속성, 서비스 계정 자격 증명 또는 SQL 코드에 액세스하지 않고도 Google Sheets 추가 기능에서 키워드 및 순위 데이터를 받을 수 있습니다.

자주 묻는 질문

GSC 데이터를 3개월 이상 받을 수 있나요?
네. Google Search Console API는 최대 16개월간의 과거 데이터를 제공합니다. Query Streams는 최초 동기화 시 이 전체 기록을 가져오므로 Google Search Console 웹 인터페이스에서 제공되는 3개월 제한보다 훨씬 더 많은 데이터를 활용할 수 있습니다. 이는 추세 분석, 전년 대비 비교, 계절별 SEO 보고서 작성에 이상적입니다.
내 GSC 데이터가 항상 며칠씩 늦어지는 이유는 무엇인가요?
이는 Google 플랫폼의 제한 사항입니다. Google Search Console(GSC) 데이터 처리는 API를 통해 사용 가능해지기까지 2~3일의 지연 시간이 발생합니다. 이는 쿼리 스트림뿐만 아니라 Search Console API에서 데이터를 읽는 모든 도구에 영향을 미칩니다. 이러한 지연 시간을 고려하여 일일 계정 동기화를 적절히 수행해야 합니다.
GSC 속성들을 여러 개 연결할 수 있나요?
네. 각 GSC 속성별로 별도의 커넥터를 추가하세요. 각 속성은 쿼리 빌더에서 별도의 데이터 소스로 표시되므로 Google Sheets에서 단일 SQL 문을 사용하여 여러 웹사이트의 유기적 검색 실적을 쿼리하고 비교할 수 있습니다.
GSC 데이터와 Google Analytics 데이터를 동일한 쿼리에서 결합할 수 있나요?
네. Google Search Console과 Google Analytics 4가 모두 연결되어 있다면 단일 SQL 쿼리에서 페이지 URL을 기준으로 두 플랫폼을 결합하여 Google Search Console의 검색 노출수와 클릭률(CTR)을 Google Analytics 4의 세션 지속 시간 및 이탈률과 같은 사이트 내 참여 지표와 연관시킬 수 있습니다.

관련 가이드

카테고리: API 커넥터

태그: Google Search Console, GSC, Google Sheets, SEO, 키워드, 순위, SQL, 유기적 검색

메타 설명: SQL을 사용하여 Google Search Console을 Google Sheets에 연결합니다. 키워드 순위, 클릭률(CTR) 및 16개월간의 검색 데이터를 조회할 수 있으며 CSV 파일로 내보낼 필요가 없습니다.

Updated on 2026년 6월 3일

Powered by BetterDocs