웹 애널리틱스 기술(Web Analytics Skill)
이 기술을 통해 에이전트는 Google과 Bing의 트래픽 데이터를 가져와 심층적인 SEO 인사이트를 제공할 수 있습니다.
환경 준비
필요한 스크립트는 이 SKILL.md 파일이 위치한 디렉토리의 scripts/ 하위에 있습니다.
다음 종속성을 설치해야 합니다:
python3 -m pip install -r scripts/gsc-requirements.txt
필요한 자격 증명 및 획득 방법
이 기술을 실행하기 전에 환경이 구성되어 있는지 확인하세요. 사용자에게 필요한 자격 증명이 없는 경우, 에이전트는 다음 단계에 따라 사용자에게 자격 증명을 획득하도록 안내해야 합니다:
1. Google OAuth 클라이언트 시크릿 (client_secret.json)
에이전트는 Google API에 접근하기 위해 데스크톱 OAuth 2.0 클라이언트 ID가 필요합니다. 사용자 안내 사항:
- Google Cloud 콘솔로 이동합니다.
- 새 프로젝트를 만들거나 기존 프로젝트를 선택합니다.
- API 및 서비스 > 라이브러리로 이동하여 Google Search Console API와 Google Analytics Data API를 사용 설정합니다.
- API 및 서비스 > OAuth 동의 화면으로 이동하여 구성합니다(사용자 유형을 "외부"로 설정하고 자신의 이메일을 테스트 사용자로 추가할 수 있습니다).
- API 및 서비스 > 사용자 인증 정보로 이동합니다. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형으로 데스크톱 앱을 선택합니다.
- 만들기를 클릭한 후 JSON 파일을 다운로드합니다. 파일 이름을
client_secret.json으로 변경하고 이 기술의scripts/디렉토리에 저장합니다.
2. Google OAuth 토큰 (token.json, google_analytics_token.json)
이 토큰들은 스크립트에 의해 자동으로 생성됩니다.
- 에이전트 지침: 스크립트 출력에 "브라우저 인증을 위해 열기"라는 메시지가 표시되면, 사용자에게 새로 열린 브라우저 창을 확인하고 Google OAuth 로그인을 완료하도록 안내하세요. 로그인이 성공하면 스크립트가 자동으로 토큰을 로컬에 저장합니다.
3. Bing API 키
사용자 안내 사항:
- Bing Webmaster Tools로 이동합니다.
- 확인된 웹사이트를 선택합니다.
- 오른쪽 상단의 설정 톱니바퀴 아이콘을 클릭합니다.
- API 액세스 > API 키로 이동합니다.
- API 키 생성을 클릭합니다(또는 기존 키를 복사합니다).
.env파일에BING_API_KEY=your_key_here형식으로 붙여넣습니다.
실행 단계
1. Google Search Console(GSC) 데이터 수집
GSC 분석 스크립트를 실행하여 클릭수, 노출수, CTR, 평균 순위를 확인합니다:
cd scripts && python3 analyze_gsc.py
2. Google Analytics 4(GA4) 데이터 수집
GA4 스크립트를 실행하여 사용자 세션, 트래픽 소스, 페이지뷰를 분석합니다:
cd scripts && python3 ga4_both.py
3. Bing Webmaster Tools 데이터 수집
Bing 스크립트를 실행하여 Google 대비 Bing 검색 성능을 비교합니다:
export BING_API_KEY=$(grep BING_API_KEY ../../.env | cut -d '=' -f2)
cd scripts && python3 bing_webmaster.py
4. 인사이트 종합
수집된 출력 결과를 분석하여 다음 사항을 보고합니다:
- 트렌드 분석: 14일 기준으로 전체 트래픽이 증가하는지 감소하는지 확인합니다.
- 플랫폼 비율: Google 대비 Bing 트래픽의 비율은 얼마인가?
- 키워드 및 페이지 기회: 노출수는 높지만 CTR이 낮은 키워드 또는 Bing에서는 성과가 좋지만 Google에서는 그렇지 않은 페이지를 강조합니다.
최종 요약을 깔끔한 Markdown 형식으로 사용자에게 제공합니다.