HitKeep

pascalebeier/hitkeep
62 starsMITCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Read-only MCP server for aggregate HitKeep analytics and official documentation.

README.md

HitKeep

Privacy-first analytics for humans and AI agents, self-hosted or in EU/US cloud.

![Continuous Integration](https://github.com/PascaleBeier/hitkeep/actions/workflows/ci.yml) ![Latest Release](https://github.com/PascaleBeier/hitkeep/releases) ![License](./LICENSE) ![Go Version](https://github.com/PascaleBeier/hitkeep/blob/main/go.mod) ![Angular Version](https://github.com/PascaleBeier/hitkeep/blob/main/frontend/dashboard/package.json) ![Docker Pulls](https://hub.docker.com/r/pascalebeier/hitkeep) ![Documentation](https://hitkeep.com/guides/introduction/) ![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11990)

HitKeep is open source web analytics for teams that want useful product reporting without running PostgreSQL, Redis, ClickHouse, or a separate queue.

  • Single Go binary with embedded DuckDB and NSQ
  • Cookie-less tracker by default, with Do Not Track support
  • Traffic, events, goals, funnels, ecommerce, UTM, and email reports
  • Google Search Console aggregate import for query, page, country, and device reporting
  • AI visibility analytics for crawler fetches and AI-referred visits
  • Scoped API clients and a read-only MCP analytics server for approved agents
  • Self-hosted or managed cloud with EU/US region choice

AI Performance · Website · Cloud · Live Demo · Docs · API · Releases

!HitKeep analytics dashboard with traffic overview, geographic breakdown, goals, funnels, and UTM attribution

Why HitKeep

HitKeep is for teams that need clear web analytics, conversion reporting, and AI-era search visibility in one small operational footprint.

  • Low-ops self-hosting: one binary, one data directory, embedded DuckDB and NSQ
  • Useful reports: top pages, landing and exit pages, events, goals, funnels, ecommerce, UTM attribution, and Search Console aggregates
  • Privacy defaults: focused data collection, cookie-less tracking, and DNT handling
  • AI visibility: server-side crawler fetch analytics, AI-referred visits, and correlation reports
  • Team controls: passkeys, TOTP, site/team permissions, share links, audit logs, API clients, and read-only MCP access
  • Deployment choice: run it yourself or use managed cloud in the EU or US

Quick Start

Binary

Download the latest release for your system:

wget https://github.com/PascaleBeier/hitkeep/releases/latest/download/hitkeep-linux-arm64
chmod +x hitkeep-linux-arm64
export HITKEEP_JWT_SECRET="replace-this-with-a-long-random-string"
./hitkeep-linux-arm64 -public-url="http://localhost:8080"

Open http://localhost:8080 and create your first account.

Docker

services:
  hitkeep:
    image: pascalebeier/hitkeep:latest
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - hitkeep_data:/var/lib/hitkeep/data
    environment:
      HITKEEP_JWT_SECRET: replace-this-with-a-long-random-string
    command:
      - "-public-url=http://localhost:8080"

volumes:
  hitkeep_data: {}
docker compose up -d

For production setup, reverse proxies, SMTP, systemd, Kubernetes, S3 archiving, and every configuration flag, use the docs instead of this README:

Local Development

Contributors can run the full hot-reload development stack with Docker:

make dev-docker-seed

This starts the Go backend, Angular dashboard, Mailpit, and seeded demo data. Open http://localhost:4200 and sign in with demo@example.com / demo1234. See CONTRIBUTING.md for Docker-only and native workflows.

Track Your Site

Once your instance is running and a site is created, add:

<script async src="https://your-hitkeep-instance.com/hk.js"></script>

Custom event example:

<script>
  window.hk = window.hk || {};
  window.hk.event?.("signup", { plan: "pro", source: "landing-page" });
</script>

Tracker options, ecommerce events, custom events, and advanced tracking examples live here:

Product Tour

<details> <summary>See five product screenshots</summary>

Dashboard

!HitKeep analytics dashboard with traffic overview, geographic breakdown, goals, funnels, and UTM attribution

Ecommerce

!HitKeep ecommerce analytics with revenue KPIs, chart, top products, and revenue sources

Search Console

!HitKeep Search Console drilldown with clicks, impressions, CTR, position, trends, top queries, pages, countries, and devices

AI Visibility

!HitKeep AI visibility analytics with fetch KPIs, assistant filters, and fetch volume chart

MCP Access

!HitKeep MCP integration overview for read-only analytics access

</details>

Documentation

The maintained reference lives on hitkeep.com.

Cloud

If you want the same product without running it yourself, start here:

Development

Prerequisites:

  • Go 1.26+
  • Node.js 24+
  • Make
  • A working C toolchain for DuckDB builds

Build from source:

git clone https://github.com/pascalebeier/hitkeep.git
cd hitkeep
make build
./hitkeep

For day-to-day development:

make dev

This starts the Go backend with live reload and the Angular dashboard on http://localhost:4200.

For a seeded local workspace with demo data:

make dev-seed

Contributor docs and local development guides:

License

Distributed under the MIT License. See LICENSE.

Related MCP servers

Browse all →