하나의 연결, 모든 표면
검색 콘솔 데이터가 전송될 수 있는 위치
- 1 발신 연결
- 0 입국항
- 읽기 전용 · 자격 증명은 그대로 유지됩니다
실행 중
- 귀사 팀, 협력업체 및 파트너 여러분께
-
Excel 추가 기능 · 필요에 따라 새로 고침
-
Google 스프레드시트 추가 기능 · 필요에 따라 새로 고침
-
Nova AI 쉬운 말로 질문해 주세요 · 텍스트를 SQL로 변환
-
데이터 뷰어 실시간 결과 공유 · 팀, 협력업체, 파트너 · 모든 기기에서
- 앱 및 시스템용
-
REST API JSON 엔드포인트 · OpenAPI 3.1
-
파워 BI 파워 쿼리 M
-
예약된 동기화 Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- AI 도구의 경우
-
AI 비서 클로드 · 커서 · MCP 서버
- 사람들에게 전달됨
-
알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
쿼리 스트림은 검색 콘솔 속성을 SQL로 변환합니다. 모든 쿼리, 페이지, 국가 및 장치 조합이 하나의 테이블 행으로 표시되며, 사이트, 사이트맵 및 검사 결과도 포함됩니다. 이 데이터는 Microsoft Excel, Google Sheets, Power BI, MCP를 통한 AI 비서 및 REST 엔드포인트에서 읽을 수 있습니다. 최초 동기화 시 Google이 보관하는 16개월 전체 데이터를 가져오는데, 이는 검색 콘솔 인터페이스에서 한 번에 제공하지 않는 부분입니다.
- 귀사 팀, 협력업체 및 파트너 여러분께
-
Search Console을 Excel로 마이크로소프트 엑셀 · 엑셀 추가 기능
Google Search Console의 실시간 검색 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. (데스크톱 Excel, Excel Online, Microsoft 365 지원)
검색 콘솔 가이드 -
Google 검색 콘솔에서 Google Sheets로 스프레드시트 추가 기능
사이드바에서 저장된 검색 콘솔 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.
검색 콘솔 가이드 -
Nova에게 Search Console에 대해 문의하세요. Nova AI · 텍스트를 SQL로 변환
쉬운 영어로 질문하세요. Nova는 이미 검색 콘솔 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성하거나 계정 정보를 제공할 필요가 없습니다.
Nova는 어떻게 작동하나요? -
검색 콘솔에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱
동료, 협력업체, 파트너 등 누구와도 실시간 검색 콘솔 결과를 북마크 가능한 그리드 형식으로 공유할 수 있습니다. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 최신 결과가 표시됩니다. 공유받은 사람은 결과만 볼 수 있고, SQL 쿼리나 계정 정보는 절대 노출되지 않습니다.
데이터 뷰어 작동 방식 - 앱 및 시스템용
-
검색 콘솔 REST API HTTP 엔드포인트
인증된 JSON 엔드포인트로 검색 콘솔 쿼리를 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양을 지원하며 Postman, Insomnia, Hoppscotch 컬렉션이 미리 준비되어 있습니다. 데이터베이스 포트는 열지 않습니다.
REST API 작동 방식 -
검색 콘솔에서 Power BI로 파워 쿼리 M
생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 실시간 검색 콘솔 결과를 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.
Power BI 작동 방식 -
검색 콘솔에서 Airtable로 자동화 플랫폼
검색 콘솔의 행을 예약된 시간에 Airtable 베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 가져올 수 있습니다.
검색 콘솔 가이드 -
검색 콘솔에서 Baserow로 자동화 플랫폼
검색 콘솔에서 REST 엔드포인트(자체 호스팅 또는 Baserow 클라우드)를 통해 Baserow 테이블에 데이터를 제공합니다.
검색 콘솔 가이드 -
SeaTable 검색 콘솔 자동화 플랫폼
파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 Search Console 데이터로 최신 상태로 유지할 수 있습니다.
검색 콘솔 가이드 -
검색 콘솔에서 스마트시트로 자동화 플랫폼
검색 콘솔 결과를 스마트시트 그리드에 추가하여 계획 및 보고서가 지난주 내보내기가 아닌 원본 시스템에서 읽어오도록 합니다.
검색 콘솔 가이드 -
Anvil로 가는 검색 콘솔 앤빌 웍스 · 앱 플랫폼
Anvil Python 앱을 데이터베이스 자격 증명을 앱에 직접 포함하는 대신 REST 엔드포인트를 통해 검색 콘솔과 연동하는 방법을 알아보세요.
검색 콘솔 가이드 - AI 도구의 경우
-
검색 콘솔 MCP 서버 Claude, Cursor 및 MCP 고객
AI 어시스턴트에게 올바른 SQL 쿼리를 작성하는 데 필요한 스키마와 함께 검색 콘솔에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅창에 자격 증명을 입력할 필요는 없습니다.
검색 콘솔 가이드 - 사람들에게 전달됨
-
검색 콘솔 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
검색 콘솔 쿼리를 예약 실행하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.
알림 및 보고서 작동 방식
작동 방식
5단계, 인바운드 방화벽 변경 없음
Google 서비스 계정을 생성하고 검색 콘솔 속성에 사용자로 추가하세요.
네트워크 에이전트를 설치하고 서비스 계정 키와 사이트 URL(https 형식 또는 sc-domain 형식)을 입력하십시오.
저장. 첫 번째 동기화는 5가지 검색 유형 모두에서 16개월 전까지 거슬러 올라갑니다.
gsc.search_analytics에 대해 일반 SQL 쿼리를 직접 작성하거나 Nova가 자동으로 작성하도록 할 수 있습니다.
Excel, Sheets, Power BI, MCP 또는 REST에서 데이터를 읽어오고, 가입자 및 수익 정보가 저장된 시스템과 연동하세요.
기능 심층 분석
Search Console이 제공하는 기능
16개월, 한 표에
Search Console은 16개월 치 데이터를 보관하며, 데이터를 부분적으로 보여줍니다. SQL로 변환된 데이터는 인터페이스에서 불가능한 전년 대비 비교를 위해 GROUP BY 절을 사용할 수 있습니다.
- gsc.search_analytics는 쿼리, 페이지, 국가, 기기 및 일별로 한 행씩 표시되며, 클릭 수, 노출 수, 클릭률 및 평균 순위 정보를 제공합니다.
- 웹 검색뿐만 아니라 5가지 검색 유형이 동기화됩니다. — 이미지, 비디오, 뉴스 및 Discover 콘텐츠도 각각 라벨이 붙어서 표시됩니다.
- Discover 및 News 행에는 검색어 또는 기기 정보가 포함되어 있지 않습니다. Google에서 해당 항목에 대한 정보를 제공하지 않기 때문입니다. 따라서 해당 열은 생성된 값이 아니라 null 값입니다.
- gsc.sites와 gsc.sitemaps는 별도의 테이블로 제공되므로 제출된 사이트 수와 인덱싱된 사이트 수를 쿼리할 수 있습니다.
구글의 지연 현상에 대해 솔직하게 이야기합니다
검색 콘솔 데이터는 대략 3일 정도 지연되어 표시되며, 최근 며칠간의 데이터는 처음 표시된 후에도 계속 변경됩니다. 이는 모두 구글의 정책이며, 숨겨지는 것이 아니라 공개적으로 표시되는 방식입니다.
- 동기화는 3일 전까지의 데이터만 보여줍니다. 그보다 최근 데이터를 요청하면 내일이면 잘못된 데이터가 반환될 것이기 때문입니다.
- 각 행에는 데이터 상태가 부분 완료인지 최종 완료인지를 나타내는 data_state 열이 있으므로 보고서에서 아직 확정되지 않은 날짜를 제외하고 평균을 낼 수 있습니다.
- 각 단계별 처리 과정에서 지난 5일간의 데이터를 다시 읽어오기 때문에, 부분적인 행이 처음 읽은 버전으로 남아있지 않고 최종 버전으로 저장됩니다.
저희도 이 제품을 사용하고 있습니다.
Query Streams는 이 커넥터에 대해 자체 SEO를 실행합니다. 동일한 테이블, 동일한 3일 지연 시간, 동일한 부분/최종 플래그를 사용합니다. 로고 전시를 위한 데모 통합이 아닙니다.
- 만약 검색어에 대한 결과가 구글이 하루에 페이지당 반환하는 2만 5천 개 이상의 행을 초과하면, 해당 행의 일부만 표시됩니다. 더 많은 기준으로 결과를 분할하는 것은 자동으로 이루어지지 않습니다.
- URL 검사 테이블은 존재하며 예약된 동기화가 아닌 필요에 따라 데이터가 채워집니다.
모든 API 커넥터에서 공유됨
모든 API 커넥터의 작동 방식
- 귀하의 계정은 테이블이 됩니다. 엔드포인트는 기본 키와 인덱스가 있는 형식화된 SQL 테이블에 매핑되므로 JSON을 페이지별로 탐색하는 대신 SELECT, JOIN 및 GROUP BY를 작성할 수 있습니다.
- 동기화할 항목과 동기화 빈도를 직접 선택할 수 있습니다. 각 테이블마다 고유한 업데이트 간격이 있거나 아예 없을 수도 있습니다. 공급업체의 API에서 지원하는 경우, 마지막 실행 이후 변경된 레코드만 가져옵니다.
- 이 사본은 당신 것입니다. — 해당 정보는 에이전트와 함께 사용자의 컴퓨터에 있는 AES-256-GCM으로 암호화된 DuckDB 파일에 저장됩니다. 저희 클라우드에 저장되는 것이 아닙니다.
- 판매자는 오직 당신에게서만 연락을 받습니다. — 에이전트가 사용자 네트워크에서 직접 API를 호출하므로 Query Streams가 쿼리에 응답하는 데 토큰이 필요하지 않습니다.
알아두면 좋겠네요.
- 이것은 동기화된 복사본이며, 실시간 프록시가 아닙니다. — 쿼리는 이미 가져온 데이터를 다시 읽기 때문에 SQL 속도로 반환되며 API 사용량 제한을 초과하지 않습니다. 또한 선택한 테이블은 읽는 즉시 오래된 행을 새로 고칠 수 있습니다.
- 요금 제한이 준수됩니다. 각 커넥터는 공급업체가 게시한 제한 범위 내에서 안정적으로 작동하므로, 보고서로 인해 해당 커넥터를 사용하는 다른 모든 서비스에 대한 계정 속도가 제한되는 일은 없습니다.
- 아무것도 버려지지 않습니다 — 테이블에 이름이 지정되지 않은 필드는 raw_data JSON 열에 저장되므로 해당 열을 쿼리할 수 있습니다.
- 데이터베이스에 연결하세요 — 동일한 명령문에서 API 테이블과 SQL Server 테이블을 함께 사용하는 것은 일반적인 쿼리일 뿐, 통합 프로젝트가 아닙니다.
크로스 소스 SQL
검색 콘솔을 나머지 데이터와 통합하세요
검색 콘솔은 클릭이 발생한 페이지를 알려줄 수 있습니다. 하지만 클릭 중 어떤 것이 계정으로 이어졌는지, 또는 해당 계정이 어떤 결제를 진행했는지는 알 수 없습니다. 이러한 정보는 다른 곳에서 관리되며, 하나의 쿼리로 세 가지 모두를 확인할 수 있습니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍 방식으로 전송하며, 모든 데이터는 중앙에서 통합됩니다. 소스 간에는 데이터가 직접 전송되지 않으며, 데이터도 복사되지 않습니다.
3개의 연결 · 3명의 에이전트
한 가지 진술
-- 검색 콘솔의 클릭 수, 데이터베이스의 가입 내역, Stripe의 수익
선택 s.page, SUM(s.clicks) AS clicks, SUM(i.amount_due) AS invoiced
FROM gsc_site.gsc.search_analytics1 s
JOIN pg_crm.공개.고객2 c ON c.landing_page = s.page
JOIN 청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 s.페이지
주문 기준 클릭 DESC;세 가지 구성 요소는 연결, 스키마 및 테이블이며, 연결 이름은 사용자가 지정한 이름입니다. 열은 예시일 뿐이며, 테이블은 사용자가 직접 지정해야 합니다. 검색 콘솔 데이터는 최대 3일 전까지 제공되는데, 이는 동기화로 인한 지연이 아니라 Google 자체 보고 지연 때문입니다. 모든 항목은 읽기 전용으로 적용되며, SELECT, WITH 및 EXPLAIN만 사용할 수 있고, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리의 작동 방식
연결 정보
검색 콘솔에 필요한 사항
- 입증
- 속성에 사용자로 추가된 Google 서비스 계정 키입니다. 에이전트에 저장된 읽기 전용 범위입니다.
- 재산
- 사이트 URL(https://example.com/ 또는 sc-domain:example.com)을 입력하세요. 이 필드를 비워두면 계정에서 볼 수 있는 모든 속성이 동기화됩니다.
- 손을 뻗었다
- 사용자 네트워크에서 Search Console API까지 HTTPS 연결을 사용합니다. 수신되는 트래픽은 없습니다.
- 스키마
- gsc — 즉 gsc.search_analytics, gsc.sitemaps
- 테이블
- 4. 검색 분석, 사이트, 사이트맵 및 URL 검사
- 검색 유형
- 웹, 이미지, 비디오, 뉴스, 검색 순으로 각 항목에 라벨이 붙어 있습니다.
- 선도
- 3일 전까지의 데이터를 실행하는데, 이는 구글 자체 보고 지연 시간입니다. 최근 5일간의 데이터는 매 실행마다 다시 읽어들입니다.
- 역사
- 최초 동기화 후 16개월 동안 Google은 모든 정보를 보존합니다.
- 로컬 복사본
- 에이전트 옆에 있는 AES-256-GCM으로 암호화된 DuckDB 파일이 사용자 컴퓨터에 있습니다.
읽기 전용은 구조적인 특성입니다. 이 커넥터가 수행하는 모든 호출은 읽기 작업이며, 커넥터가 보유한 토큰은 읽기 전용 범위로 제한됩니다. 따라서 사이트맵을 제출하거나 인덱싱을 요청할 수 없습니다.
크로스 소스 쿼리에서 3부분으로 구성된 참조의 중간 부분은 gsc입니다. 검색 분석을 읽는 gsc_site라는 연결은 gsc_site.gsc.search_analytics로 기록됩니다.
공급업체 문서: 검색.구글.com
자주 묻는 질문
Google Search Console 관련 질문
쿼리 스트림을 통해 Google 검색 콘솔 데이터를 읽을 수 있는 도구는 무엇인가요?
Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 도구를 하나의 연결로 이용할 수 있습니다. 계정을 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.
Google Search Console 계정에 접근하려면 방화벽 포트를 열어야 하나요?
아니요. Query Streams 네트워크 에이전트는 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 수신하는 기능은 없으며 VPN도 필요하지 않고 계정은 기존 방화벽 규칙을 그대로 유지합니다.
쿼리 스트림을 사용하면 Google 검색 콘솔의 데이터가 변경될 수 있나요?
아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.
Query Streams가 Google Search Console에 연결하려면 무엇이 필요합니까?
접근 가능한 호스트, 역할 및 암호 - 에이전트가 드라이버를 제공하므로 계정에 아무것도 설치되지 않습니다. 인증: 속성에 사용자로 추가된 Google 서비스 계정 키. 에이전트에 저장된 읽기 전용 범위. 속성: 사이트 URL(예: https://example.com/ 또는 sc-domain:example.com). 비워두면 계정에서 볼 수 있는 모든 속성이 동기화됩니다. 연결 방식: 네트워크에서 Search Console API까지 HTTPS 연결. 인바운드 연결은 없습니다. 스키마: gsc - 즉 gsc.search_analytics, gsc.sitemaps.
Google Search Console을 다른 데이터베이스와 동일한 쿼리로 연결할 수 있나요?
네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 Google Search Console과 다른 연결을 동시에 참조할 수 있으며, 연결은 `connection.schema.table` 형식으로 작성됩니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍 방식으로 전송합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되지 않으며, 데이터 복사나 예약 실행도 없습니다. 모든 부분에는 읽기 전용(SELECT, WITH, EXPLAIN만 해당)이 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish