io.github.PascaleBeier/hitkeep

Official

by PascaleBeier · Go

HitKeep

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

Read-only access to HitKeep analytics data and documentation.

Topics

analyticsangulargoaimcpagent-skills

README.md9 KBView on GitHub

HitKeep

Privacy-first web analytics with conversion reporting, AI visibility, and optional Ask AI, self-hosted or in EU/US cloud.

HitKeep is open source web analytics for teams that want useful product reporting, conversion analytics, and AI-era search visibility 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
Multi-site Overview, ECharts-based charts, expanded report ranges, and email reports
Traffic, events, goals, funnels, ecommerce, UTM, QR campaigns, and Web Vitals
Google Search Console aggregate import for query, page, country, and device reporting
AI visibility analytics for crawler fetches, AI-referred visits, and on-site AI chatbot outcomes
Optional Ask AI dashboard assistant for site-scoped aggregate questions, citations, small charts, and safe actions
Scoped API clients and a read-only MCP analytics server for approved assistants
Self-hosted or managed cloud with EU/US region choice

AI Performance · Website · Cloud · Live Demo · Docs · Ask AI · 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: multi-site Overview, top pages, landing and exit pages, events, goals, funnels, ecommerce, UTM attribution, QR campaigns, Web Vitals, 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, chatbot outcomes, and correlation reports
Ask AI: optional dashboard-session assistant for aggregate analytics answers with citations and safe dashboard actions
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:

bash

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

yaml

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: {}

bash

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:

bash

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:

html

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

Custom event example:

html

<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 six 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

AI Visibility

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

Ask AI

HitKeep Ask AI answer with completed analytics tool chips, citations, a table, and a safe dashboard action

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:

bash

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

For day-to-day development:

bash

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:

bash

make dev-seed

Contributor docs and local development guides:

License

Distributed under the MIT License. See LICENSE.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "hitkeep": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://{hitkeep_host}/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.