agent-analytics

Web analytics your AI agent can read. Drop a JS snippet on your site, query the data via API.

Quick Start

# 1. Get your API key from https://api.agentanalytics.sh (sign in with GitHub)

# 2. Save your key
npx @agent-analytics/cli login --token aak_your_key

# 3. Create a project
npx @agent-analytics/cli create my-site --domain https://mysite.com

# 4. Check your stats
npx @agent-analytics/cli stats my-site

Commands

# Auth
npx @agent-analytics/cli login --token <key>    # Save your API key
npx @agent-analytics/cli whoami                  # Show current account

# Projects
npx @agent-analytics/cli create <name> --domain <url>    # Create a project
npx @agent-analytics/cli projects                        # List your projects
npx @agent-analytics/cli delete <id>                     # Delete a project

# Analytics
npx @agent-analytics/cli stats <name>              # Stats (last 7 days)
npx @agent-analytics/cli stats <name> --days 30    # Stats (last 30 days)
npx @agent-analytics/cli events <name>             # Recent events
npx @agent-analytics/cli properties-received <name>  # Property keys per event
npx @agent-analytics/cli insights <name>           # Period-over-period comparison (--period 7d)
npx @agent-analytics/cli breakdown <name> --property path  # Top values for a property
npx @agent-analytics/cli pages <name>              # Landing page performance (--type entry|exit|both)
npx @agent-analytics/cli sessions-dist <name>      # Session duration histogram
npx @agent-analytics/cli heatmap <name>            # Peak hours & busiest days

# Security
npx @agent-analytics/cli revoke-key     # Revoke and regenerate API key

For AI Agents

Set the env var and call the API directly — no CLI needed:

export AGENT_ANALYTICS_API_KEY=aak_your_key

# Query stats
curl "https://api.agentanalytics.sh/stats?project=my-site&days=7" \
  -H "X-API-Key: $AGENT_ANALYTICS_API_KEY"

# Create a project
curl -X POST "https://api.agentanalytics.sh/projects" \
  -H "X-API-Key: $AGENT_ANALYTICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "new-site", "allowed_origins": "https://mysite.com"}'

Environment Variables

| Variable | Description | |----------|-------------| | AGENT_ANALYTICS_API_KEY | API key (overrides config file) | | AGENT_ANALYTICS_URL | Custom API URL (for self-hosted) |

Config

Stored at ~/.config/agent-analytics/config.json (file permissions: 600).

Links

• Dashboard: https://api.agentanalytics.sh
• Website: https://agentanalytics.sh
• GitHub: https://github.com/Agent-Analytics
• Self-host: https://github.com/Agent-Analytics/agent-analytics

License

MIT