{"id":51172492,"url":"https://github.com/PascaleBeier/hitkeep","last_synced_at":"2026-06-28T23:00:17.203Z","repository":{"id":325365154,"uuid":"1092315417","full_name":"PascaleBeier/hitkeep","owner":"PascaleBeier","description":"HitKeep is privacy-first analytics for humans and AI agents, self-hosted or in managed EU/US cloud regions.","archived":false,"fork":false,"pushed_at":"2026-06-24T18:08:50.000Z","size":242516,"stargazers_count":61,"open_issues_count":2,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-24T18:18:20.172Z","etag":null,"topics":["agent-skills","ai","analytics","angular","go","mcp"],"latest_commit_sha":null,"homepage":"https://hitkeep.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PascaleBeier.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"PascaleBeier","custom":["https://www.paypal.me/kreuztal"]}},"created_at":"2025-11-08T11:56:11.000Z","updated_at":"2026-06-24T18:06:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/PascaleBeier/hitkeep","commit_stats":null,"previous_names":["pascalebeier/hitkeep"],"tags_count":97,"template":false,"template_full_name":null,"purl":"pkg:github/PascaleBeier/hitkeep","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PascaleBeier%2Fhitkeep","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PascaleBeier%2Fhitkeep/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PascaleBeier%2Fhitkeep/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PascaleBeier%2Fhitkeep/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PascaleBeier","download_url":"https://codeload.github.com/PascaleBeier/hitkeep/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PascaleBeier%2Fhitkeep/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34906700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai","analytics","angular","go","mcp"],"created_at":"2026-06-27T02:00:18.435Z","updated_at":"2026-06-28T23:00:17.194Z","avatar_url":"https://github.com/PascaleBeier.png","language":"Go","funding_links":["https://github.com/sponsors/PascaleBeier","https://www.paypal.me/kreuztal"],"categories":["Tools Powered by DuckDB"],"sub_categories":[],"readme":"# HitKeep\n\n\u003e Privacy-first analytics for humans and AI agents, self-hosted or in EU/US cloud.\n\n[![Continuous Integration](https://github.com/PascaleBeier/hitkeep/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/PascaleBeier/hitkeep/actions/workflows/ci.yml)\n[![Latest Release](https://img.shields.io/github/v/release/PascaleBeier/hitkeep?sort=semver)](https://github.com/PascaleBeier/hitkeep/releases)\n[![License](https://img.shields.io/github/license/PascaleBeier/hitkeep)](./LICENSE)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/PascaleBeier/hitkeep?logo=go)](https://github.com/PascaleBeier/hitkeep/blob/main/go.mod)\n[![Angular Version](https://img.shields.io/github/package-json/dependency-version/PascaleBeier/hitkeep/%40angular%2Fcore?filename=frontend%2Fdashboard%2Fpackage.json\u0026logo=angular\u0026label=Angular)](https://github.com/PascaleBeier/hitkeep/blob/main/frontend/dashboard/package.json)\n[![Docker Pulls](https://img.shields.io/docker/pulls/pascalebeier/hitkeep?logo=docker\u0026label=docker%20pulls)](https://hub.docker.com/r/pascalebeier/hitkeep)\n[![Documentation](https://img.shields.io/website?url=https%3A%2F%2Fhitkeep.com%2Fguides%2Fintroduction%2F\u0026label=docs)](https://hitkeep.com/guides/introduction/)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11990/badge)](https://www.bestpractices.dev/projects/11990)\n\nHitKeep is open source web analytics for teams that want useful product reporting without running PostgreSQL, Redis, ClickHouse, or a separate queue.\n\n- Single Go binary with embedded DuckDB and NSQ\n- Cookie-less tracker by default, with Do Not Track support\n- Traffic, events, goals, funnels, ecommerce, UTM, and email reports\n- Google Search Console aggregate import for query, page, country, and device reporting\n- AI visibility analytics for crawler fetches and AI-referred visits\n- Scoped API clients and a read-only MCP analytics server for approved agents\n- Self-hosted or managed cloud with EU/US region choice\n\n[AI Performance](https://hitkeep.com/ai-performance/) · [Website](https://hitkeep.com) · [Cloud](https://hitkeep.com/cloud) · [Live Demo](https://demo.hitkeep.com/share/7a55968bb42df256512fbe7ff73ab88f29dd45c236eddc818bd66420b4ffbaad) · [Docs](https://hitkeep.com/guides/introduction/) · [API](https://hitkeep.com/api/) · [Releases](https://github.com/PascaleBeier/hitkeep/releases)\n\n![HitKeep analytics dashboard with traffic overview, geographic breakdown, goals, funnels, and UTM attribution](./.github/assets/dashboard-overview.png)\n\n## Why HitKeep\n\nHitKeep is for teams that need clear web analytics, conversion reporting, and AI-era search visibility in one small operational footprint.\n\n- **Low-ops self-hosting:** one binary, one data directory, embedded DuckDB and NSQ\n- **Useful reports:** top pages, landing and exit pages, events, goals, funnels, ecommerce, UTM attribution, and Search Console aggregates\n- **Privacy defaults:** focused data collection, cookie-less tracking, and DNT handling\n- **AI visibility:** server-side crawler fetch analytics, AI-referred visits, and correlation reports\n- **Team controls:** passkeys, TOTP, site/team permissions, share links, audit logs, API clients, and read-only MCP access\n- **Deployment choice:** run it yourself or use managed cloud in the EU or US\n\n## Quick Start\n\n### Binary\n\nDownload the latest release for your system:\n\n```bash\nwget https://github.com/PascaleBeier/hitkeep/releases/latest/download/hitkeep-linux-arm64\nchmod +x hitkeep-linux-arm64\nexport HITKEEP_JWT_SECRET=\"replace-this-with-a-long-random-string\"\n./hitkeep-linux-arm64 -public-url=\"http://localhost:8080\"\n```\n\nOpen `http://localhost:8080` and create your first account.\n\n### Docker\n\n```yaml\nservices:\n  hitkeep:\n    image: pascalebeier/hitkeep:latest\n    restart: unless-stopped\n    ports:\n      - \"8080:8080\"\n    volumes:\n      - hitkeep_data:/var/lib/hitkeep/data\n    environment:\n      HITKEEP_JWT_SECRET: replace-this-with-a-long-random-string\n    command:\n      - \"-public-url=http://localhost:8080\"\n\nvolumes:\n  hitkeep_data: {}\n```\n\n```bash\ndocker compose up -d\n```\n\nFor production setup, reverse proxies, SMTP, systemd, Kubernetes, S3 archiving, and every configuration flag, use the docs instead of this README:\n\n- [Installation guides](https://hitkeep.com/guides/installation/)\n- [Configuration reference](https://hitkeep.com/reference/configuration/)\n- [Cloud documentation](https://hitkeep.com/cloud)\n\n## Local Development\n\nContributors can run the full hot-reload development stack with Docker:\n\n```bash\nmake dev-docker-seed\n```\n\nThis starts the Go backend, Angular dashboard, Mailpit, and seeded demo data.\nOpen `http://localhost:4200` and sign in with `demo@example.com` / `demo1234`.\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for Docker-only and native workflows.\n\n## Track Your Site\n\nOnce your instance is running and a site is created, add:\n\n```html\n\u003cscript async src=\"https://your-hitkeep-instance.com/hk.js\"\u003e\u003c/script\u003e\n```\n\nCustom event example:\n\n```html\n\u003cscript\u003e\n  window.hk = window.hk || {};\n  window.hk.event?.(\"signup\", { plan: \"pro\", source: \"landing-page\" });\n\u003c/script\u003e\n```\n\nTracker options, ecommerce events, custom events, and advanced tracking examples live here:\n\n- [Tracking docs](https://hitkeep.com/guides/tracking/)\n- [Custom events](https://hitkeep.com/guides/tracking/custom-events/)\n- [Ecommerce analytics](https://hitkeep.com/guides/analytics/ecommerce/)\n- [Google Search Console integration](https://hitkeep.com/guides/integrations/google-search-console/)\n- [MCP analytics access](https://hitkeep.com/guides/integrations/mcp/)\n- [WordPress integration](https://hitkeep.com/guides/integrations/wordpress/)\n- [AI visibility analytics](https://hitkeep.com/guides/analytics/ai-visibility/)\n- [CloudFront AI crawler tracking](https://hitkeep.com/guides/tracking/cloudfront-ai-crawler-tracking/)\n- [AI chatbot analytics](https://hitkeep.com/guides/analytics/ai-chatbot-analytics/)\n- [REST API reference](https://hitkeep.com/api/)\n- [Compliance overview](https://hitkeep.com/compliance/overview/)\n\n## Product Tour\n\n\u003cdetails\u003e\n\u003csummary\u003eSee five product screenshots\u003c/summary\u003e\n\n### Dashboard\n![HitKeep analytics dashboard with traffic overview, geographic breakdown, goals, funnels, and UTM attribution](./.github/assets/dashboard-overview.png)\n\n### Ecommerce\n![HitKeep ecommerce analytics with revenue KPIs, chart, top products, and revenue sources](./.github/assets/analytics-ecommerce.png)\n\n### Search Console\n![HitKeep Search Console drilldown with clicks, impressions, CTR, position, trends, top queries, pages, countries, and devices](./.github/assets/analytics-search-console.png)\n\n### AI Visibility\n![HitKeep AI visibility analytics with fetch KPIs, assistant filters, and fetch volume chart](./.github/assets/analytics-ai-visibility.png)\n\n### MCP Access\n![HitKeep MCP integration overview for read-only analytics access](./.github/assets/mcp.png)\n\n\u003c/details\u003e\n\n## Documentation\n\nThe maintained reference lives on `hitkeep.com`.\n\n- [Getting started](https://hitkeep.com/guides/introduction/)\n- [Installation](https://hitkeep.com/guides/installation/)\n- [Configuration](https://hitkeep.com/reference/configuration/)\n- [REST API reference](https://hitkeep.com/api/)\n- [Compliance](https://hitkeep.com/compliance/overview/)\n- [Comparison pages](https://hitkeep.com/vs/)\n- [Agent Skills](./skills/)\n\n## Cloud\n\nIf you want the same product without running it yourself, start here:\n\n- [Start in the EU](https://cloud.hitkeep.eu/signup)\n- [Start in the US](https://cloud.hitkeep.com/signup)\n- [Cloud overview](https://hitkeep.com/cloud)\n\n## Development\n\nPrerequisites:\n\n- Go 1.26+\n- Node.js 24+\n- Make\n- A working C toolchain for DuckDB builds\n\nBuild from source:\n\n```bash\ngit clone https://github.com/pascalebeier/hitkeep.git\ncd hitkeep\nmake build\n./hitkeep\n```\n\nFor day-to-day development:\n\n```bash\nmake dev\n```\n\nThis starts the Go backend with live reload and the Angular dashboard on `http://localhost:4200`.\n\nFor a seeded local workspace with demo data:\n\n```bash\nmake dev-seed\n```\n\nContributor docs and local development guides:\n\n- [Contributing guide](./CONTRIBUTING.md)\n- [Dashboard development notes](./frontend/dashboard/README.md)\n- [Changelog](./CHANGELOG.md)\n\n## License\n\nDistributed under the MIT License. See [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPascaleBeier%2Fhitkeep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPascaleBeier%2Fhitkeep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPascaleBeier%2Fhitkeep/lists"}