Rube MCP를 통한 Google Search Console 자동화
Google Search Console을 Rube MCP(Composio)를 통해 검색 애널리틱스 조회, URL 검사, 사이트맵 관리, 검색 성능 모니터링 등을 수행합니다.
툴킷 문서: composio.dev/toolkits/google_search_console
사전 요구 사항
- Rube MCP가 연결되어 있어야 함 (
RUBE_SEARCH_TOOLS사용 가능) - 툴킷
google_search_console을 사용한RUBE_MANAGE_CONNECTIONS를 통한 활성 연결 - Google Search Console에서 사이트 소유권 확인 또는 적절한 권한 보유
- 현재 도구 스키마를 얻기 위해 항상
RUBE_SEARCH_TOOLS를 먼저 호출해야 함
설정
Rube MCP 가져오기: 클라이언트 설정에 https://rube.app/mcp를 MCP 서버로 추가하세요. API 키는 필요 없습니다. 엔드포인트를 추가하기만 하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP 사용 가능 여부 확인- 툴킷
google_search_console을 사용하여RUBE_MANAGE_CONNECTIONS호출 - 연결이 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-prefix 속성은 프로토콜과 후행 슬래시가 포함된 전체 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 제공