seo-geo-skills은(는) 무엇을 하나요?
Codex 및 Claude Code를 위한 SEO/GEO 사이트 감사 기술로, 제한적 크롤링, 템플릿 인식 샘플링, 로컬 Lighthouse 또는 PageSpeed API 기반 이중 언어 HTML 보고서를 제공합니다.
개요
이 기술은 AI 에이전트(Codex, Claude Code)가 웹사이트의 SEO(검색 엔진 최적화)와 GEO(생성 엔진 최적화) 상태를 자동으로 감사할 수 있도록 지원합니다. 크롤링 깊이와 페이지 수를 제한하여 과도한 리소스 사용을 방지하며, CMS 템플릿 구조를 인식하여 중복 페이지를 효과적으로 샘플링합니다. 감사 결과는 한국어와 영어로 제공되는 HTML 보고서로 출력됩니다.
주요 기능
- 제한적 크롤링: 설정된 최대 페이지 수(기본값: 50) 내에서 사이트를 크롤링합니다.
- 템플릿 인식 샘플링: 동일한 템플릿 구조를 가진 페이지 중 대표 페이지만 선택하여 감사 효율성을 높입니다.
- 이중 언어 보고서: 감사 결과를 한국어와 영어로 동시에 포함하는 HTML 보고서를 생성합니다.
- 로컬 Lighthouse 사용: 사용자 환경에 설치된 Lighthouse를 사용하여 성능, 접근성, SEO 등을 측정합니다.
- PageSpeed API 사용: Google PageSpeed Insights API를 통해 감사할 수도 있습니다(API 필요).
사용 방법
Claude Code
claude
에이전트에게 사이트 URL과 함께 감사 명령을 전달합니다.
Codex
codex --skill iklynow-hue/seo-geo-skills --url https://example.com
설정
config.yaml 파일에서 다음 옵션을 조정할 수 있습니다.
| 옵션 | 설명 | 기본값 |
|---|---|---|
max_pages | 크롤링할 최대 페이지 수 | 50 |
language | 보고서 언어 (ko, en, both) | both |
lighthouse_path | 로컬 Lighthouse 실행 파일 경로 | (자동 탐지) |
pagespeed_api_key | PageSpeed API 키 (선택 사항) | (없음) |
의존성
- 로컬 Lighthouse를 사용하려면 Node.js와 Lighthouse 패키지가 필요합니다:
npm install -g lighthouse - PageSpeed API를 사용하려면 Google Cloud 프로젝트에서 API 키를 발급받아야 합니다.
- Python 3.8 이상 및
requests,beautifulsoup4,jinja2패키지가 필요합니다.
보고서 예시
생성된 HTML 보고서는 다음 정보를 포함합니다:
- 전체 SEO 점수
- 개별 페이지 감사 결과 (성능, 접근성, SEO, 모범 사례)
- 발견된 문제 목록 및 우선순위
- 각 문제에 대한 권장 수정 사항
- 페이지별 세부 진단
라이선스
MIT License