Google의 무료 검색 성과 모니터링 서비스인 Google Search Console(GSC)에 앱을 연결해 도메인 소유권을 검증하고, 사이트맵을 제출하고, 검색 애널리틱스를 읽고, 채팅에서 직접 SEO 질문에 답하거나 Lovable 앱에 SEO 기능을 빌드하세요.
Google Search Console(GSC)은 사이트의 Google 검색 성과를 모니터링하는 Google의 무료 서비스입니다. GSC 커넥터를 통해 Lovable이 Lovable 앱의 Search Console 설정(도메인 검증, 사이트맵 제출)을 처리하게 하고, 실시간 데이터를 읽어 채팅에서 SEO 질문에 답하게 하고, 필요하다면 앱 안에 SEO 대시보드나 도구를 빌드할 수 있습니다.
Google Search Console을 사용하면 Lovable이 다음을 할 수 있습니다.
- Search Console에서 사이트 도메인 검증: meta 태그 토큰 생성, 앱 HTML에 임베드, 엔드투엔드 검증 완료
- 검증된 사이트의 사이트맵 제출과 관리
- 실시간 데이터로 채팅에서 SEO 질문에 답하기: 상위 쿼리, 상위 페이지, 클릭, 노출, CTR, 평균 게재 순위, 색인 상태
- 개별 URL 검사: 색인 상태, 마지막 크롤, 모바일 사용성, 리치 결과 확인
- 연결된 Search Console 계정의 검증된 사이트 나열
- 사이트맵 상태(경고, 오류, 색인된 수 포함) 읽기
앱 안에 오래가는 SEO 화면이 필요하다면 같은 커넥터 위에 빌드할 수 있습니다.
Search Console 데이터는 보통 며칠 지연됩니다. 오늘의 클릭과 노출은 Google이 처리 완료할 때까지 검색 애널리틱스에 표시되지 않습니다. 대시보드와 리포트는 "오늘"이 아니라 가장 최근의 데이터가 완전히 채워진 날짜를 기준으로 구성하세요.
Google Search Console 커넥터 활용 방법
Google Search Console 커넥터를 두 가지 방식으로 활용할 수 있습니다.
Lovable에게 SEO 작업 맡기기
커넥터의 가장 큰 가치는 빌드 중 Lovable이 코드를 작성하지 않고도 Lovable 앱의 SEO 작업을 수행하게 하는 것입니다. 커넥터가 연결되어 있으면 SEO 주제로 Lovable과 채팅하면 됩니다.
| 예시 프롬프트 | Lovable이 하는 일 |
|---|---|
| Verify my Lovable app's domain in Google Search Console. | meta 태그 검증 토큰을 생성하고 앱 HTML <head>에 임베드한 뒤 배포하고 Google verify 엔드포인트를 호출해 Search Console에 검증된 속성으로 추가합니다. |
| Submit my sitemap to Google. | 앱의 sitemap.xml을 생성하거나 위치를 찾아 검증된 속성에 대해 Search Console에 제출합니다. |
| Why isn't my homepage showing up in Google? | 홈페이지에 URL Inspection을 실행해 색인 상태, 마지막 크롤, 색인 문제를 평이한 언어로 설명합니다. |
| What are my top 10 search queries this week? | Search Analytics를 조회하고 클릭이나 노출 기준으로 쿼리를 순위화한 뒤 채팅에서 답합니다. |
| Did any of my pages drop in rankings last week? | 두 기간의 Search Analytics를 가져와 비교하고 가장 큰 변동 항목을 강조합니다. |
| Are there any errors in my submitted sitemaps? | 해당 속성의 제출된 사이트맵을 나열하고 경고·오류·낮은 색인 수를 표시합니다. |
자세한 내용은 SEO 및 AI 검색 최적화를 참고하세요.
앱에 SEO 기능 빌드하기
라이브 Lovable 앱에 Search Console 데이터를 노출할 수도 있습니다.
| 예시 앱 | 예시 프롬프트 | 설명 |
|---|---|---|
| SEO 성과 대시보드 | Use Google Search Console and build a dashboard that shows clicks, impressions, CTR, and average position for my verified site over the last 28 days. | 오가닉 검색 성과를 한 곳에서 시각화. 트렌드 차트와 상위 쿼리·상위 페이지로의 드릴다운. |
| 상위 쿼리·페이지 리포트 | Use Google Search Console and build a weekly report that lists my top 50 search queries and the pages they drive traffic to. | 원시 GSC 데이터를 읽기 쉬운 주간 리포트로 변환. 앱이 쿼리·페이지를 집계하고 클릭이나 노출 기준으로 순위를 매겨 내보낼 수 있는 요약을 렌더링합니다. |
| 알림 포함 키워드 트래킹 | Use Google Search Console and build a keyword tracker that records average position for my target queries each day and flags ranking drops. | 시간에 걸쳐 중요한 쿼리 목록 관찰. 설정한 일정에 따라 앱이 검색 애널리틱스 스냅숏을 기록하고 일자별로 비교해 순위가 하락한 쿼리를 강조합니다. |
| URL 검사 도구 | Use Google Search Console and build a tool where I paste a URL and see its index status, last crawl date, and any indexing issues. | Search Console을 열지 않고 개별 페이지 진단. 앱이 주어진 URL에 URL Inspection을 호출해 Google이 보는 모습을 읽기 쉬운 요약으로 렌더링합니다. |
| 사이트맵 매니저 | Use Google Search Console and build a tool that lists my submitted sitemaps and lets me submit new ones or delete old ones. | 앱을 벗어나지 않고 검증된 사이트의 사이트맵 관리. 앱이 제출된 사이트맵과 상태·경고·색인 수를 나열하고 사이트맵 URL을 제출하거나 삭제할 수 있게 합니다. |
| 기간 대 기간 비교 | Use Google Search Console and build a report that compares last week to the week before, with movers by query and by page. | 시간에 걸친 성장 또는 회귀 정량화. 앱이 두 번의 검색 애널리틱스 조회를 실행해 결과를 조인하고 가장 큰 변동을 순위화합니다. |
| 다중 사이트 SEO 개요 | Use Google Search Console and build an overview that shows traffic for every site I have verified in Search Console. | 검증된 모든 사이트의 성과 비교. 앱이 각 검증된 속성을 가져와 단일 대시보드에 렌더링해, 어떤 사이트가 성장 또는 감소하는지 한눈에 볼 수 있게 합니다. |
| 콘텐츠 기회 탐색기 | Use Google Search Console and build an app that finds queries where my pages rank between positions 5 and 20, pages I could improve. | 손쉬운 SEO 성과 항목 노출. 앱이 1페이지에 근접한 쿼리를 검색 애널리틱스에서 필터링하고 랜딩 페이지별로 그룹화해 편집자가 무엇을 업데이트해야 할지 알게 합니다. |
| 색인 건강 모니터 | Use Google Search Console and build a monitor that flags sitemaps with errors or sites that have dropped in impressions week over week. | 색인·가시성 문제를 조기에 포착. 앱이 사이트맵 상태와 검색 애널리틱스를 온디맨드(또는 설정된 일정)로 읽고 기간을 비교해 회귀를 집중된 뷰로 강조합니다. |
Google Search Console 연결의 동작 방식
Google Search Console 커넥터는 Google 계정에 대해 OAuth2를 사용하며, 안전한 토큰 저장과 자동 갱신을 위해 Lovable 게이트웨이 아키텍처를 통해 실행됩니다. 인증에 대한 자세한 내용은 게이트웨이 기반 커넥터를 참고하세요.
Lovable 워크스페이스 내에서는:
- 여러 Google Search Console 연결을 만들 수 있습니다.
- 각 연결은 Google 계정에 대한 별도의 OAuth 권한 부여이며 자체 선택된 스코프를 갖습니다.
- 각 연결에는 연결 단위 접근 제어가 있습니다. 기본적으로 연결을 만든 사람만 사용할 수 있지만, 특정 워크스페이스 멤버나 워크스페이스 전체로 열 수 있습니다.
- 여러 프로젝트가 같은 연결을 사용할 수 있습니다.
덕분에 환경 분리(예: 스테이징 속성을 소유한 Google 계정과 프로덕션 속성), 서로 다른 사이트를 소유한 여러 Google 계정 연결, 또는 계정 접근을 한 명에게만 제한하는 것이 쉬워집니다.
Google Search Console 연결 방법
워크스페이스 admin 과 owner 가 Google Search Console을 연결할 수 있습니다.
연결이 생성되면 Google Search Console이 워크스페이스의 모든 프로젝트에서 사용 가능해집니다(연결의 접근 설정에 따름).
사전 요구 사항
Google Search Console 연결 전 다음을 준비하세요.
- Google 계정
- Lovable 워크스페이스 admin 또는 owner 역할
먼저 Search Console에서 사이트를 검증할 필요는 없습니다. 연결 후 에이전트에게 Lovable 앱의 도메인을 검증해 달라고 요청할 수 있습니다. 계정에 이미 검증된 사이트가 있다면 에이전트가 자동으로 인식합니다.
이 커넥터를 통한 모든 요청은 연결된 Google 계정을 사용하며 Google Search Console의 표준 API 쿼터에 포함됩니다. 쿼터와 관련된 청구는 Lovable이 아닌 Google이 직접 처리합니다.
Google Search Console 연결 설정
Connectors에서 Google Search Console 열기
Connectors 로 이동해 Google Search Console 을 선택합니다.
연결 추가
Add connection 을 클릭합니다.
연결 이름 지정
Display name 에 Lovable 내에서 이 연결을 식별할 이름(예: GSC Prod)을 입력합니다. 이 이름은 Lovable 내부에서만 사용됩니다.
스코프 구성(선택)
Advanced settings 를 펼치면 Lovable이 요청할 Google 권한을 볼 수 있습니다. 기본 스코프는 미리 선택되어 있어 연결이 애널리틱스를 읽고 사이트맵을 관리하고 새 사이트를 검증할 수 있습니다.
필요 없는 스코프는 옆의 × 를 클릭해 제거하세요. 읽기 전용 애널리틱스에는 검증된 사이트의 Search Console 데이터 보기 스코프만 필요하며 Required 로 표시되어 있습니다. 전체 목록은 스코프와 권한을 참고하세요.
이후 연결을 편집하고 다시 연결해 스코프를 업데이트할 수 있습니다.
연결 접근 권한 선택
Who can access this connection 에서 워크스페이스의 누가 연결을 사용할 수 있을지 결정합니다.
- Only you(기본): 연결을 만든 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace 를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 단위 접근을 참고하세요.
Google에 연결하고 권한 부여
Connect 를 클릭합니다. Google 권한 부여 창이 열리므로 브라우저의 팝업 차단을 확인하세요. 차단되어 있다면 Lovable이 리다이렉트합니다.
사용할 Google 계정을 선택하고 요청된 권한을 검토한 뒤 Allow 를 클릭합니다.
확인 메시지와 함께 Lovable로 돌아옵니다.
연결되면 Google 계정의 검증된 사이트에 대해 도메인 검증, 사이트맵 제출, SEO 질문 답변을 즉시 요청할 수 있습니다.
스코프와 권한
Google Search Console 연결은 Search Console API와 Site Verification API 두 가지 Google API에 대한 스코프를 요청합니다. 검증된 사이트의 Search Console 데이터 보기 는 필수이고 나머지는 선택이며 연결 전 제거할 수 있습니다.
| 스코프 | 에이전트가 할 수 있는 일 | 필수 |
|---|---|---|
View Search Console data for verified siteswebmasters.readonly | 검색 애널리틱스, 검증된 사이트, URL inspection, 사이트맵 목록에 대한 읽기 전용 접근. | 예 |
View and manage Search Console data and sitemaps for verified siteswebmasters | 사이트맵 제출·삭제, Search Console에 새 검증된 사이트 추가. | 아니요 |
Verify ownership of new sites via the Site Verification APIsiteverification.verify_only | 도메인 소유권을 증명하기 위해 검증 토큰을 요청. | 아니요 |
Manage the list of sites and domains you controlsiteverification | 검증 완료, 검증된 사이트 나열, 검증 제거. | 아니요 |
에이전트에게 도메인 검증을 맡기려면 검증 스코프를 선택한 상태로 두세요. 읽기 전용 SEO 데이터만 원한다면 필수 스코프 외 모든 것을 해제할 수 있습니다.
자세한 내용은 Google의 Search Console API 및 Site Verification API 참고 문서를 보세요.
채팅에서 새 도메인 검증
검증 스코프를 부여하면 Lovable이 앱 도메인을 엔드투엔드로 검증해 Search Console에 추가할 수 있습니다. 요청만 하면 됩니다. 흐름은 네 단계이며 Google의 meta 태그 검증 방식을 기반으로 합니다.
- 검증 토큰 요청. 에이전트가 Google에 사이트의 토큰을 요청합니다.
- meta 태그 임베드. 에이전트가
<meta name="google-site-verification" content="<TOKEN>" />을 사이트 루트 URL의<head>에 추가합니다. 태그는 클라이언트 측 주입이 아니라 서버 렌더링되어야 하며, 계속하기 전에 변경 사항이 배포되어야 합니다. - 소유권 검증. 에이전트가 토큰을 요청할 때 사용한 것과 동일한 사이트 식별자(슬래시 포함)로 Google verify 엔드포인트를 호출합니다.
failedToFindMetaTag오류는 보통 배포가 아직 라이브가 아니거나, 태그가 클라이언트에서 주입되거나, 사이트가 인증 뒤에 있거나, 식별자가 정확히 일치하지 않음을 의미합니다. - Search Console에 사이트 추가. 검증되면 에이전트가 사이트를 속성으로 등록해 Search Console 계정에 표시되게 합니다.
예를 들어 Lovable에 다음과 같이 프롬프트를 주세요.
Use Google Search Console and verify ownership of https://example.com, then add it to Search Console.커넥터를 통해 검증할 때는 meta 태그(META) 방식만 지원됩니다. DNS 레코드, HTML 파일 업로드, Google Analytics 검증은 작동하지 않습니다. 검증 토큰이 사이트 루트 URL의 HTML <head> 에 서버 렌더링되어야 하기 때문입니다. 또한 verify 엔드포인트를 호출하는 시점에 사이트가 Google 크롤러에서 공개적으로 접근 가능해야 합니다.
모든 단계에서 슬래시를 포함해 정확히 동일한 사이트 식별자를 사용하세요(예: https://example.com 가 아니라 https://example.com/). 토큰을 요청한 URL과 verify 엔드포인트에 전달한 URL이 일치하지 않는 것이 배포 라이브 후 failedToFindMetaTag 오류의 가장 흔한 원인입니다.
쿼터와 제한
커넥터를 통한 모든 요청은 Google Search Console의 표준 API 쿼터에 포함되며, 이는 Google이 설정하고 같은 Google 계정을 사용하는 다른 모든 것과 공유됩니다.
- URL Inspection 은 속성별 일일 쿼터가 엄격합니다(작성 시점 기준 속성당 하루 약 2,000회). 대량 URL을 검사하는 앱이나 채팅은 이 한도를 빠르게 소진합니다.
- Search Analytics 쿼리는 Google의 분당·일일 쿼터를 따릅니다. 차원을 여러 개 둔 큰 기간 범위는 페이지네이션된 결과를 반환하며 여러 번 요청이 필요할 수 있습니다.
- 쿼터는 Google 일정에 따라 리셋되며 Lovable이 아닙니다.
429또는 쿼터 오류가 발생하면 사용자나 에이전트가 한도를 해제할 수 없습니다. 쿼터 윈도가 리셋될 때까지 기다리거나 요청 볼륨을 줄이세요.
현재 수치는 Google의 Search Console API 사용 한도를 참고하세요.
제한사항
Google Search Console 커넥터로 할 수 없는 것:
- 사이트 검증에 DNS, HTML 파일 업로드, Google Analytics 사용. 커넥터에서는 meta 태그 방식만 지원합니다.
- URL에 대한 색인 요청(
urlNotifications:publish). 커넥터는 Search Console과 Site Verification만 대상으로 합니다. - 검색 순위 변경이나 수동 조치에 대한 재검토 요청.
- Google Search Console 알림을 웹훅이나 푸시 이벤트로 수신.
- 최종 사용자별 Google 로그인(각 연결은 단일 연결된 Google 계정을 사용).
커넥터가 지원하지 않는 워크플로는 Google Search Console 웹 앱을 직접 사용할 수 있습니다.
Google Search Console 연결에서 프로젝트 연결 해제
Editor 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용 가능합니다.
프로젝트 연결 해제:
Connectors 열기
Connectors 를 열고 App connectors 로 이동한 뒤 Google Search Console 을 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects 에서 해제할 프로젝트를 체크합니다.
확인
Unlink projects 를 클릭하고 확인합니다.
해제되면 해당 프로젝트는 이 연결을 통해 Google Search Console에 접근할 수 없게 됩니다. 프로젝트에 Google Search Console이 다시 필요하면 사용 가능한 연결에 다시 연결할 수 있습니다.
Google Search Console 연결 삭제
워크스페이스 admin과 owner가 Google Search Console 연결을 삭제할 수 있습니다.
연결을 삭제하는 것은 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 이 연결을 사용하는 앱은 새 연결을 추가할 때까지 작동을 멈춥니다.
삭제 전 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 확인하세요.
연결 삭제:
Connectors 열기
Connectors 를 열고 App connectors 로 이동한 뒤 Google Search Console 을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토
Linked projects 섹션을 확인합니다.
삭제
Delete this connection 에서 Delete 를 클릭하고 확인합니다.