프로젝트 소개
anacraft는 Google Analytics 4 데이터를 터미널 대시보드로 읽어 들이는 Rust 명령줄 도구입니다. README는 이 프로젝트를 "Google Analytics, 블록 단위로 채굴"이라고 표현합니다. 7개의 토글 가능한 패널이 광석 텍스처 막대, 실시간 이벤트 피드, 업적 토스트로 GA4 지표를 렌더링합니다. `craft` 명령만 실행하면 대시보드가 열리며, 저장된 속성이 없으면 합성 데이터로 실행되므로 로그인 전에 시도해 볼 수 있습니다.
설치 방법으로는 macOS/Linux용 설치 스크립트, `cargo install --git`, 또는 Releases에서 수동 바이너리 다운로드가 있습니다. 기존 속성을 연결하려면 OAuth(`craft login`)를 사용한 다음 `craft props`로 읽을 수 있는 속성을 나열하고 `craft use ID`로 기본값을 저장합니다. 별도의 `craft configure domain` 명령은 GA4 속성과 웹 데이터 스트림을 생성하고 gtag.js 스니펫을 출력합니다. README에 따르면 이 명령은 Analytics 계정에서 무엇이든 변경하는 유일한 명령이며 유료 플랜의 일부입니다.
대시보드 외에도 일회성 보고서(`overview`, `pages`, `portals`, `realms`, `live`, `demo`)를 제공하며, `--format json` 및 `--format slack` 출력을 지원하여 스크립트나 웹훅으로 파이프할 수 있습니다. `craft audit`는 구성 가능한 기간에 걸쳐 15가지 검사를 실행하며, Data API와 Admin API를 모두 읽어 측정 문제와 구성 문제를 구분합니다. `--fix`는 이미 기록된 결과를 핵심 이벤트로 표시하고 기존 태그가 지원하는 측정을 활성화할 수 있습니다. `craft watch`는 가장 최근의 완료된 날짜를 기준선과 비교하여 급락, 급증, 침묵을 보고하며, 지표별 임계값은 TOML에서 구성할 수 있고 설치된 웹훅을 통해 선택적으로 Slack으로 전송할 수 있습니다.
대시보드에는 7개의 패널(이벤트, 실시간, 국가 지도, 인기 페이지, 바이탈, 상위 국가, 일일 사용자)이 있으며 키보드 토글, 여러 팔레트, 다중 속성 전환을 지원합니다. MCP 서버(`craft mcp`)는 `site_status`, `audit_site`, `live_visitors` 및 목록/검색 도구와 같은 도구를 노출하여 Claude Desktop과 같은 MCP 클라이언트가 동일한 숫자를 조회할 수 있게 합니다. `configure_site`는 유일한 쓰기 도구로 설명됩니다. 구성은 `~/.config/anacraft/config.toml`에 저장되며, OAuth 토큰은 별도로 `~/.anacraft/`에 보관됩니다. 일부 기능은 구독 플랜 뒤에 있고 `--demo` 모드는 제한 없이 사용할 수 있습니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.