seo-google

seo-google 개요

seo-google이 하는 일

seo-google 스킬은 일반적인 프롬프트나 제3자 추정치에 의존하지 않고 Google SEO API에 직접 접근할 수 있게 해줍니다. Search Console, PageSpeed Insights, CrUX, Indexing API, GA4의 오가닉 트래픽까지 한 흐름에서 실제 필드 데이터를 확인해야 하는 사람을 위해 설계되었습니다.

가장 잘 맞는 사용자와 업무

색인 상태를 검증하거나, URL을 점검하거나, 노출수와 클릭수를 비교하거나, 실제 사용자 데이터를 기반으로 Core Web Vitals를 감사하거나, GA4에서 오가닉 트래픽 추세를 뽑아야 한다면 seo-google 스킬을 사용하세요. SEO 운영 담당자, 테크니컬 SEO, 콘텐츠 팀, 그리고 추천을 내리기 전에 Google 원천 데이터가 필요한 에이전트에게 특히 유용합니다.

무엇이 다른가

seo-google의 핵심 가치는 광범위한 SEO 이론이 아니라 신뢰할 수 있는 원천 데이터에 있습니다. 크롤링 기반 분석과 Google의 자체 API를 연결해 주기 때문에, “이 페이지는 괜찮아 보인다”에서 “Search Console에서 CTR이 낮다” 또는 “CrUX에서 모바일 INP가 좋지 않다”로 바로 넘어갈 수 있습니다. 그래서 일반적인 자유형 프롬프트보다 의사결정에 더 강합니다.

seo-google이 적합한 경우

실제 Google 데이터, 계정 설정, API 기반 진단이 필요한 작업이라면 seo-google을 선택하세요. 반대로 콘텐츠 아이디어 발상, Google Ads 접근 없이 하는 키워드 브레인스토밍, 실시간 데이터가 필요 없는 일회성 SEO 설명만 원한다면 효용이 떨어집니다.

seo-google 스킬 사용 방법

설치하고 사전 조건 확인하기

seo-google install 단계에서는 스킬 워크플로우를 통해 스킬을 추가한 뒤, 분석을 요청하기 전에 자격 증명이 제대로 잡혀 있는지 확인하세요. 이 저장소는 Google API 인증 정보가 준비되어 있기를 전제로 하며, 가장 먼저 실제로 필요한 설정은 ~/.config/claude-seo/google-api.json에 유효한 구성 파일이 있는지입니다.

올바른 입력 형태로 시작하기

seo-google usage 패턴은 구체적인 URL, property, 또는 목표를 넣을 때 가장 잘 작동합니다. 좋은 입력 예시는 다음과 같습니다: “https://example.com/pricing의 색인 상태와 CWV를 점검해줘”, “sc-domain:example.com의 지난 28일 GSC 쿼리를 비교해줘”, “블로그 섹션의 GA4 오가닉 랜딩 페이지를 확인해줘”. “SEO를 개선해줘”처럼 모호한 요청은 피하세요. API는 대상과 기간이 있어야 제대로 동작합니다.

먼저 읽어야 할 파일

신뢰할 수 있는 seo-google 가이드를 만들려면 먼저 SKILL.md를 보고, 그다음 references/auth-setup.md, references/search-console-api.md, references/pagespeed-crux-api.md, references/ga4-data-api.md를 확인하세요. 작업에 알림 또는 submit/inspect 흐름이 포함된다면 references/indexing-api.md도 읽어야 하고, 키워드 리서치가 목적이라면 references/keyword-planner-api.md를 사용하세요.

더 좋은 결과를 만드는 워크플로

실용적인 순서는 다음과 같습니다: 인증 확인 → 데이터 소스 식별 → property 또는 URL 정의 → 날짜 범위 선택 → 필요한 메트릭만 요청. 예를 들어 “seo-google을 사용해서 sc-domain:example.com의 지난 28일 Search Console Search Analytics를 확인하고, 노출수는 높지만 CTR이 낮은 페이지를 추려서 어떤 타이틀을 고쳐야 할지 설명해줘”처럼 요청하세요. 이 방식은 무엇을 가져와야 하는지와 결과를 어떤 관점으로 정리해야 하는지를 스킬에 분명히 알려 주기 때문에, 막연한 SEO 리뷰보다 훨씬 낫습니다.

seo-google 스킬 FAQ

seo-google은 Search Console 전용인가요?

아니요. Search Console이 중심이긴 하지만, seo-google 스킬은 PageSpeed Insights, CrUX, Indexing API, GA4 오가닉 데이터도 다룹니다. 색인, 성능, 트래픽 진단을 각각 따로 프롬프트로 처리하지 않고 하나의 스킬로 해결하고 싶을 때 특히 중요합니다.

API 키와 서비스 계정을 둘 다 써야 하나요?

대체로 전체 범위를 쓰려면 둘 다 필요합니다. API 키만으로는 PageSpeed Insights와 CrUX를 사용할 수 있고, Search Console, Indexing API, GA4는 서비스 계정이 필요합니다. 두 가지를 모두 설정해 두었을 때 이 스킬의 활용도가 가장 높습니다.

seo-google로 Keyword Research도 할 수 있나요?

네, 다만 조건이 있습니다. seo-google의 Keyword Research는 Google Ads/Keyword Planner 접근에 의존하므로 다른 API보다 설정이 더 번거롭습니다. 빠른 주제 아이디어가 아니라 Google 기반 볼륨이나 예측 데이터가 필요할 때 가장 적합합니다.

언제 이 스킬을 쓰지 말아야 하나요?

자격 증명이 없거나, 검증된 property가 없거나, 단순한 SEO 체크리스트만 필요하다면 seo-google을 쓰지 마세요. API로 증명할 수 있는 근거가 강점이기 때문에, 순수한 콘텐츠 생성에는 가장 좋은 선택이 아닙니다.

seo-google 스킬 개선 방법

스킬이 판단할 수 있는 맥락을 제공하세요

결과를 가장 빨리 개선하는 방법은 property 유형, URL 패턴, 날짜 범위, 디바이스 우선순위, 성공 지표를 함께 주는 것입니다. 예를 들어 “/blog/ 페이지의 모바일 CWV”, “노출수 1,000회 이상이고 CTR 2% 미만인 GSC 페이지”, “브랜드 랜딩 페이지를 제외한 지난 90일 GA4 오가닉 트래픽”처럼요. 이렇게 하면 seo-google이 넓은 요약이 아니라 실행 가능한 세그먼트를 반환할 수 있습니다.

한 번에 한 분석 축만 요청하세요

색인 상태, 순위, Core Web Vitals, 트래픽은 각각 분리해서 요청할 때 성능이 더 좋습니다. “URL 검사 후 GSC, 그다음 GA4까지 봐줘” 같은 요청은 결과를 지저분하게 만들기 쉽습니다. 먼저 하나의 축만 요청하고, 결과를 본 뒤 다음 단계로 이어가는 방식이 더 좋습니다.

흔한 실패 패턴을 주의하세요

가장 흔한 장애물은 인증 누락, 잘못된 property 형식, 그리고 스킬이 가져올 수 없는 데이터를 추론해 달라고 하는 경우입니다. 또 다른 자주 있는 문제는 시드 키워드가 부족하거나 Google Ads 자격 증명이 없는데도 너무 넓게 키워드를 요청하는 것입니다. seo-google에 키워드 리서치를 맡기고 싶다면, 아이디어가 필요한지, 과거 볼륨이 필요한지, 예측치가 필요한지를 분명히 말하세요.

직감이 아니라 증거를 바탕으로 반복하세요

첫 결과를 받은 뒤에는 방금 확인한 이상 징후를 그대로 좁혀서 다시 요청하세요. 예: “노출수는 높지만 클릭이 낮은 페이지”, “모바일에서만 INP가 나쁜 URL”, “최근 발행한 페이지의 색인 실패”. 이렇게 하면 seo-google이 진단 루프로 바뀌고, 두 번째 분석이 한 번의 일반 감사보다 훨씬 유용해집니다.