github-traffic은(는) 무엇을 하나요?
GitHub 저장소 트래픽 데이터(조회, 클론, 참조, 스타)를 가져와 저장하고 추세 차트로 시각화합니다. 저장소 푸시 접근 권한이 필요합니다.
개요
이 스킬은 GitHub 저장소의 트래픽 메트릭을 주기적으로 수집하고 분석할 수 있도록 도와줍니다. 수집된 데이터는 로컬에 저장되어 누적되며, 원할 때 추세 차트를 생성할 수 있습니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
필수 조건
- GitHub 개인 액세스 토큰 (repo 권한 필요)
- 대상 저장소에 대한 푸시 접근 권한
사용법
단일 메트릭 조회
views: 저장소 페이지 조회 수 추세clones: 저장소 클론 수 추세referrers: 외부 참조 사이트 통계stars: 스타 수 추세
통합 조회
모든 메트릭을 한 번에 조회할 수 있는 통합 명령어가 제공됩니다.
플래그
--export-csv: 데이터를 CSV 파일로 내보내기--chart: 추세 차트를 생성하여 출력
데이터 저장
수집된 데이터는 다음 구조로 저장됩니다:
.traffic-data/
├── views.json
├── clones.json
├── referrers.json
└── stars.json
구성
환경 변수 또는 설정 파일을 통해 저장소와 토큰을 지정할 수 있습니다.
GITHUB_TOKEN: GitHub API 접근 토큰GITHUB_REPO: 대상 저장소 (예:owner/repo)
예시
# 조회 수 추세 가져오기
skill github-traffic views
# 모든 트래픽 데이터 가져오기
skill github-traffic all --chart
# CSV로 내보내기
skill github-traffic views --export-csv
주의 사항
- GitHub API 요청 제한에 유의하세요.
- 저장소가 비공개인 경우 적절한 접근 권한이 필요합니다.
- 차트 생성에는 추가 라이브러리가 필요할 수 있습니다.