MCP Fathom 분석

AI 어시스턴트를 통해 Fathom Analytics 데이터에 액세스하기 위한 비공식 모델 컨텍스트 프로토콜( MCP ) 서버입니다. 이 구현은 Fathom Analytics API와 상호 작용하기 위해 @mackenly/fathom-api 비공식 SDK를 사용합니다. Fathom Analytics와 제휴, 보증 또는 지원되지 않습니다. npx 스크립트로 npm 에 게시됩니다.

특징

MCP 서버는 다음과 같은 Fathom Analytics 도구를 제공합니다.

계정 정보

get-account : Fathom Analytics 계정에 대한 세부 정보를 검색합니다.

사이트 관리

list-sites : 모든 Fathom Analytics 사이트를 나열합니다.

이벤트

list-events : 특정 사이트의 이벤트 목록

해석학

get-aggregation : 유연한 필터링 및 그룹화 옵션을 사용하여 집계된 분석 보고서를 생성합니다.

방문자 추적

get-current-visitors : 현재 사이트 방문자에 대한 실시간 데이터를 가져옵니다.

용법

Claude Desktop을 사용하는 경우 JSON 구성을 사용하여 MCP 서버를 추가할 수 있습니다( 자세한 내용은 여기를 참조하세요 ). 다음은 예시입니다.

지엑스피1

다른 MCP 클라이언트에 대한 자세한 내용은 여기에서 확인할 수 있습니다. 모델 컨텍스트 프로토콜 예제 클라이언트

API 구조

MCP 서버는 @mackenly/fathom-api SDK를 사용하여 Fathom Analytics API 엔드포인트와 인터페이스합니다.

계정 API : https://api.usefathom.com/v1/account
사이트 API : https://api.usefathom.com/v1/sites
이벤트 API : https://api.usefathom.com/v1/sites/SITE_ID/events
집계 API : https://api.usefathom.com/v1/aggregations
현재 방문자 API : https://api.usefathom.com/v1/current_visitors

집계 예제

집계 도구는 매우 유연합니다. 다음은 몇 가지 사용 사례입니다.

지난 30일간의 일일 페이지뷰 통계 :

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,visits",
  "date_grouping": "day",
  "date_from": "2023-08-01 00:00:00"
}

개별 페이지의 성능 :

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,avg_duration",
  "field_grouping": "pathname",
  "sort_by": "pageviews:desc",
  "limit": 10
}

특정 국가의 트래픽 :

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "visits",
  "field_grouping": "country_code",
  "sort_by": "visits:desc"
}

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

MCP Fathom Analytics

Integrations