에이전트 스킬
PrivateStater는 Claude Code, Cursor, GitHub Copilot 등 AI 코딩 도구를 위한 에이전트 스킬을 제공합니다. 스킬을 설치하면 에이전트가 직접 PrivateStater를 웹사이트에 연동하거나 데이터를 조회할 수 있습니다.
제공 스킬
| 스킬 | 기능 |
|---|---|
privatestater-install |
Analytics, Captcha, Feedback Widget을 웹사이트에 설치 |
privatestater-openapi |
Open API로 애널리틱스 조회, 피드백 관리, 설정 변경 |
설치
프로젝트 루트에서 아래 명령어를 실행하세요. 스킬은 .agents/skills/에 추가되며 에이전트가 자동으로 인식합니다.
개별 설치
# Analytics, Captcha, Feedback Widget 연동
npx skills add https://github.com/gpdir16/privatestater-skills --skill privatestater-install
# Open API 조회 및 관리
npx skills add https://github.com/gpdir16/privatestater-skills --skill privatestater-openapi
한 번에 설치
npx skills add https://github.com/gpdir16/privatestater-skills --skill privatestater-install --skill privatestater-openapi
각 스킬 설명
privatestater-install
에이전트가 다음을 수행할 수 있습니다:
- HTML 페이지에 PrivateStater 스크립트 추가
window.PrivateStater.statsClick()으로 클릭 이벤트 추적 설정- Captcha 위젯 구현 및 서버 사이드 토큰 검증
- Feedback Widget 활성화 및 프로그래밍 방식으로 열기
에이전트는 대시보드에서 확인할 수 있는 웹사이트 ID를 요청한 후, 서버 사이드 캡차 검증 코드를 포함한 전체 연동을 처리합니다.
privatestater-openapi
Open API를 통해 PrivateStater 데이터를 조회하고 관리하는 방법을 에이전트에게 가르칩니다. 다음과 같이 질문하세요:
- "이번 주 방문자 수는 얼마야?"
- "가장 많이 본 페이지가 뭐야?"
- "읽지 않은 이슈 피드백 보여줘"
- "캡차 난이도를 high로 바꿔줘"
에이전트는 API 키(대시보드 → 프로젝트 → 개발자용 → API 키)와 웹사이트 ID를 요청한 후, API를 호출하고 결과를 자연어로 설명합니다.
소스
스킬은 github.com/gpdir16/privatestater-skills에 공개되어 있습니다.