yourtraffic

YourTraffic

オープンソースの、プライバシーを最優先したウェブ解析ツールです。ウェブサイト数は無制限で、使いやすい REST API と、エージェント向けのネイティブ MCP サーバーを備えています。Cookie も個人データも使用せず、同意バナーも不要です。

セルフホスティング

前提条件

• Vercel CLI がグローバルにインストールされていること
• Postgres データベース
• Node 20 以降

セットアップ

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/kozmos-tech/yourtraffic
cd yourtraffic
npm install

サンプルの環境変数ファイルをコピーし、値を設定します。

cp .env.example .env

• DATABASE_URL。Postgres の接続文字列です。これを設定しないとアプリは起動しません。
• BETTER_AUTH_SECRET。十分に長いランダムなシークレットです。openssl rand -base64 32 で生成してください。訪問者のハッシュはこの値をソルトとして使用するため、デフォルト値をそのまま使わないでください。
• BETTER_AUTH_URL。デプロイ先の公開オリジンです。たとえば https://analytics.example.com を指定します。開発時は http://localhost:3000 を使用してください。これは MCP クライアントが OAuth 用に検出するオリジンでもあるため、パスを末尾に付けず、公開 URL と完全に一致させる必要があります。
• GOOGLE_CLIENT_ID と GOOGLE_CLIENT_SECRET。任意です。両方を設定すると、ログインページと登録ページで Google サインインが有効になります。Google Cloud コンソールで OAuth 認証情報を作成し、BETTER_AUTH_URL + /api/auth/callback/google を認証済みリダイレクト URI として追加してください。Google ボタンを非表示にするには、空欄のままにします。

初回起動前にデータベースのテーブルを作成します。

npm run db:migrate

起動

vc dev
open http://localhost:3000

サインインしてウェブサイトを追加し、表示されたスニペットをサイトの <head> に挿入します。初回訪問から数秒で統計情報が表示されます。

デプロイ

npm install
vc deploy

Vercel プロジェクトの設定で DATABASE_URL、BETTER_AUTH_SECRET、BETTER_AUTH_URL を設定し、本番データベースに対してマイグレーションを実行します。

データベース

スキーマは src/db/schema.ts にあります。変更後にマイグレーションを生成し、適用します。

npm run db:generate
npm run db:migrate

統計情報の確認

各プロジェクトには API キーがあり、ダッシュボードの Settings に表示されます。

• REST API。キーを Bearer トークンとして /api/v1/stats に渡します。詳しい手順は llms.txt をご覧ください。
• MCP サーバー。エージェントから /mcp に接続します。OAuth を使用するため、サインインしてアクセスを承認します。API キーは不要です。