Rube MCP를 통한 Google Search Console 자동화
Google Search Console을 Rube MCP(Composio)를 통해 사용하여 검색 애널리틱스를 조회하고, URL을 검사하며, 사이트맵을 관리하고, 검색 성능을 모니터링합니다.
도구 키트 문서: composio.dev/toolkits/google_search_console
사전 조건
- Rube MCP가 연결되어 있어야 합니다 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해google_search_console도구 키트로 활성 연결 상태여야 함- Google Search Console에서 사이트 소유권이 확인되었거나 적절한 권한이 있어야 함
- 항상
RUBE_SEARCH_TOOLS를 먼저 호출하여 현재 도구 스키마를 확인하세요
설정
Rube MCP 받기: 클라이언트 설정에 MCP 서버로 https://rube.app/mcp를 추가하세요. API 키가 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다.RUBE_MANAGE_CONNECTIONS를google_search_console도구 키트로 호출합니다.- 연결이 ACTIVE 상태가 아니면 반환된 인증 링크를 따라 설정을 완료합니다.
- 워크플로우를 실행하기 전에 연결 상태가 ACTIVE로 표시되는지 확인합니다.
핵심 워크플로우
1. 모든 인증된 사이트 목록 조회
GOOGLE_SEARCH_CONSOLE_LIST_SITES를 사용하여 인증된 사용자가 소유하거나 접근 권한이 있는 모든 사이트를 가져옵니다.
도구: GOOGLE_SEARCH_CONSOLE_LIST_SITES
매개변수: (필요 없음)
반환: siteUrl 및 permissionLevel이 포함된 사이트 항목 목록
2. 검색 애널리틱스 조회
GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY를 사용하여 클릭수, 노출수, CTR, 평균 순위를 포함한 검색 성능 데이터를 가져옵니다.
도구: GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY
매개변수:
- site_url (필수): 사이트 URL (예: "https://www.example.com/" 또는 "sc-domain:example.com")
- start_date (필수): 시작 날짜 (YYYY-MM-DD 형식)
- end_date (필수): 종료 날짜 (YYYY-MM-DD 형식)
- dimensions: ["query", "page", "country", "device", "date", "searchAppearance"] 중에서 그룹화
- search_type: "web" (기본값), "image", "video", "news", "discover", "googleNews"
- dimension_filter_groups: 차원 필터 (연산자: equals, notEquals, contains, notContains, includingRegex, excludingRegex)
- row_limit: 최대 행 수 (1-25000, 기본값 1000)
- start_row: 페이지네이션 오프셋 (기본값 0)
- aggregation_type: "auto", "byPage", "byProperty", "byNewsShowcasePanel"
- data_state: "final" (기본값), "all", "hourly_all"
3. URL 검사
GOOGLE_SEARCH_CONSOLE_INSPECT_URL을 사용하여 특정 URL의 색인 상태와 문제를 확인합니다.
도구: GOOGLE_SEARCH_CONSOLE_INSPECT_URL
매개변수:
- inspection_url (필수): 검사할 전체 URL (예: "https://www.example.com/page")
- site_url (필수): 속성 URL (예: "https://www.example.com/")
- language_code: BCP-47 언어 코드 (기본값: "en-US")
4. 사이트맵 목록 조회
GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS를 사용하여 사이트에 제출된 모든 사이트맵을 가져옵니다.
도구: GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS
매개변수:
- site_url (필수): 사이트 URL (예: "https://www.example.com/")
- sitemap_index: 사이트맵을 가져올 특정 사이트맵 인덱스 URL
5. 사이트맵 제출
GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP을 사용하여 사이트맵을 등록하거나 다시 제출합니다.
도구: GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP
매개변수:
- site_url (필수): 사이트 URL 또는 도메인 속성 (예: "sc-domain:example.com")
- feedpath (필수): 전체 사이트맵 URL (예: "https://www.example.com/sitemap.xml")
6. 사이트맵 세부 정보 조회
GOOGLE_SEARCH_CONSOLE_GET_SITEMAP을 사용하여 제출된 특정 사이트맵의 정보를 가져옵니다.
도구: GOOGLE_SEARCH_CONSOLE_GET_SITEMAP
매개변수:
- site_url (필수): 사이트 URL
- feedpath (필수): 세부 정보를 가져올 사이트맵 URL
일반적인 패턴
- 성능 모니터링:
dimensions: ["date"]와 함께GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY를 사용하여 날짜 범위별 일일 검색 성능 추세를 추적합니다. - 상위 쿼리 보고서:
dimensions: ["query"]와 함께GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY를 사용하여 가장 많이 클릭된 검색어를 찾습니다. - 페이지별 분석:
dimensions: ["page"]를 사용하여 상위 성과 페이지를 식별하고,dimensions: ["query", "page"]를 사용하여 각 페이지에 트래픽을 유도하는 쿼리를 확인합니다. - 색인 감사:
GOOGLE_SEARCH_CONSOLE_INSPECT_URL을 사용하여 중요한 페이지의 색인 상태를 확인합니다. - 사이트맵 관리:
GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS로 제출된 사이트맵을 확인한 후,GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP으로 새 사이트맵이나 업데이트된 사이트맵을 제출합니다. - 국가/기기별 분석:
dimensions: ["country", "device"]를 사용하여 검색 트래픽의 지리적 및 기기 유형별 분포를 파악합니다. - 특정 쿼리 필터링:
dimension_filter_groups에contains또는includingRegex연산자를 사용하여 특정 키워드 그룹에 집중합니다.
알려진 문제점
- 사이트 URL 형식 중요: URL-접두사 속성은 프로토콜과 후행 슬래시가 포함된 전체 URL을 사용합니다 (예:
https://www.example.com/). 도메인 속성은sc-domain:접두사를 사용합니다 (예:sc-domain:example.com). 잘못된 형식을 사용하면 빈 결과나 오류가 발생합니다. - 날짜 범위 제한: 데이터는 일반적으로 2~3일의 지연 후에 사용할 수 있습니다.
data_state: "all"은 더 최신 데이터를 포함하지만 변경될 수 있습니다.hourly_all은 최근 3일 이내의 날짜에만 작동합니다. - 행 제한 페이지네이션: API는 클릭수 기준(날짜별 그룹화 시 날짜 기준)으로 정렬된 상위 결과를 반환합니다. 전체 데이터를 얻으려면
start_row를row_limit과 함께 사용하여 페이지네이션합니다. - 요청당 최대 25,000행: 페이지네이션을 사용하더라도 각 요청은 최대 25,000행을 반환합니다. 매우 큰 데이터셋의 경우 날짜 범위를 좁히거나 차원 필터를 추가하세요.
- 검사 URL이 사이트와 일치해야 함:
inspection_url은site_url속성에 속한 페이지여야 합니다. 속성을 벗어난 검사는 실패합니다. - 사이트맵에 접근 가능해야 함:
GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP은 사이트맵 파일이 지정된 URL에서 공개적으로 접근 가능하고 XML 형식이 올바른지 요구합니다. - 결과는 클릭수 기준 정렬: 기본적으로 애널리틱스 결과는 클릭수 내림차순으로 정렬되며,
date로 그룹화하는 경우에만 날짜 오름차순으로 정렬됩니다.
빠른 참조
| 작업 | 도구 | 주요 매개변수 |
|---|---|---|
| 사이트 목록 | GOOGLE_SEARCH_CONSOLE_LIST_SITES | (없음) |
| 검색 애널리틱스 | GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY | site_url, start_date, end_date, dimensions |
| URL 검사 | GOOGLE_SEARCH_CONSOLE_INSPECT_URL | inspection_url, site_url |
| 사이트맵 목록 | GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS | site_url |
| 사이트맵 제출 | GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP | site_url, feedpath |
| 사이트맵 정보 | GOOGLE_SEARCH_CONSOLE_GET_SITEMAP | site_url, feedpath |
Composio 제공