pirsch

# Pirsch Plugin

Pirsch analytics integration for Claude Code - privacy-friendly website analytics and insights.

## Features

- **Traffic Overview**: Visitors, pageviews, sessions, and bounce rates
- **Top Content**: Most viewed pages and time on page
- **Traffic Sources**: Referrers and UTM campaign tracking
- **Trend Analysis**: Compare periods and track growth
- **Real-Time**: Active visitors on your site right now

## Installation

```bash
claude /plugin install ./plugins/pirsch
```

## Configuration

Set the following environment variables:

```bash
export PIRSCH_ACCESS_TOKEN="your-access-token"
export PIRSCH_DEFAULT_DOMAIN="domain-id"  # Optional
```

### Getting an Access Token

1. Log into your Pirsch dashboard
2. Go to Settings > Developer
3. Create a new access token
4. Copy the token

## Commands

| Command | Description |
| ------- | ----------- |
| `/analytics-overview [domain] [period]` | Get traffic overview |
| `/analytics-compare [period1] [period2]` | Compare two periods |

## Available MCP Tools

- `pirsch_list_domains` - List accessible domains
- `pirsch_overview` - Cached overview stats
- `pirsch_total` - Detailed totals with filters
- `pirsch_visitors` - Visitor time series
- `pirsch_pages` - Top pages stats
- `pirsch_referrers` - Traffic sources
- `pirsch_utm` - UTM campaign data
- `pirsch_growth` - Growth metrics
- `pirsch_active` - Real-time active visitors
- `pirsch_compare` - Period comparison with deltas

## Example Usage

```text
# Quick overview
/analytics-overview

# Compare this week to last week
/analytics-compare this-week last-week

# Natural language
"How's my website traffic doing this month?"
"What are my top pages?"
"Compare January to December traffic"
"How many people are on my site right now?"
```

## Periods

For commands and queries, you can use:

- `today`, `yesterday`
- `this-week`, `last-week`
- `this-month`, `last-month`
- `this-year`, `last-year`
- Date ranges: `2025-01-01 to 2025-01-31`
- Month shorthand: `2025-01`, `2024-12`

## Privacy

Pirsch is a privacy-friendly analytics platform that:

- Doesn't use cookies
- Doesn't track individual users
- Is GDPR compliant
- Stores data in the EU

## License

MIT