analyga

analyga

MCP とウェブトラフィックのためのエージェントファーストなアナリティクス。ターミナルまたは MCP クライアントから、クエリ、計測、設定を行えます。ブラウザーもダッシュボードも不要です。

人間にはダッシュボードを。エージェントには tga を。

現代のトラフィックの両面、つまりサイトへのウェブ訪問と、ますますその流れを生み出すエージェント／MCP呼び出しの両方を、ひとつのアナリティクス画面で扱えます。アナリティクスツールは、チャートをじっと見つめる人間を想定しています。しかし、数値を必要とするのはますますエージェントになっています。エージェント自身がイベントを発火し、記録されたかを知りたがり、表示するダッシュボードではなく、5つの数値を求めています。analyga はエージェント自身が操作する画面です。インストールは1回だけで、ウェブと MCP の統計やファネルをクエリし、サーバーサイドイベントを送信し、自分のスキーマを読み取れます。すべて構造化 JSON として扱えるため、画面をスクレイピングする必要はありません。

対応環境： Claude Code · Cursor · Cline · Windsurf · Aider · Codex · あらゆる MCP クライアント

ひとつのエージェント、ひとつのターミナル — 60秒でクエリからファネルまで。デモ全編を見る。

動作を見る

モックアップではありません。各クリップは、シード済みテナントに対するライブの tga セッションです。GIF をクリックすると、高解像度の動画を見られます。

クエリ → ファネル	エージェントによるセルフサインアップ	サーバーサイド取り込み
ひとつのエージェント、ひとつのターミナル、60秒	キーレスでブートストラップ — 管理者の介入は不要	安定した --id を指定してイベントを送信

MCP クライアント	人間向けダッシュボード
Claude Code ／ Cursor で使える13個のネイティブツール	エージェントが収集したすべての情報を、ひとつのリアルタイム UI に表示

インストール

npm install -g analyga

npm パッケージは analyga、コマンドは tga です。

クイックスタート

# No account yet? Create a tenant and its first key — no card, no admin in the loop
tga signup --slug acme --name "Acme" --username you --password <8+ chars>

# Point at a tenant
tga login --key <your-api-key>     # or set ANALYGA_KEY

# Confirm WHICH tenant you are about to write to (shows tenant + key scope for a tga_ key)
tga whoami

# What can this credential see?
tga websites

# Five numbers, not a dashboard
tga stats <websiteId> --from 7d

# Full reference
tga --help

すべてのコマンドで --json を指定できます。マシン向けのインターフェースは後付けではなく、第一級の機能です。

tga stats <websiteId> --from 7d --json

フラグを推測せず、仕様を確認する

tga agent-schema --json

コマンド、引数、フラグ、型、読み取り専用かどうか、エラーコードの全一覧が返されます。パーサー、ヘルプテキスト、MCP ツールを制御するものと同じテーブルから生成されるため、CLI の実際の動作と食い違うことはありません。スキーマにないものは存在しません。

クエリ — 統計、イベント、ファネル

リリース後にエージェントが実際に尋ねること、つまりイベントが記録されたか、フローを最後まで完了した人がいたかを確認できます。

# Traffic and top-line stats for a window
tga stats <websiteId> --from 7d
tga events <websiteId> --from 24h

# Define a funnel once, then run it whenever
tga funnel define <websiteId> --name signup --steps "/,/pricing,/signup"
tga funnel list <websiteId>
tga funnel run <funnelId> --from 30d

# Cross-site rollup for a team
tga network <teamId> --from 7d

すべて読み取り専用で、すべて --json を指定できます。エージェントはチャートを解析するのではなく、数値に基づいて次の処理を判断できます。

Identity — --id を指定しないと、エージェントがすべて1人の訪問者に集約されます

匿名 ID は IP とユーザーエージェントから生成されます。エージェントのトラフィックではどちらも共通します。CLI のバージョンが同じならユーザーエージェントも同じになり、エージェントは同じ外向き IP を共有することも多いため、安定した ID がないと、その IP の背後にいるすべてのエージェントが1人の訪問者に集約されます。 この情報を後から補完することはできません。

tga send <websiteId> --name cli_signup --id <stable-user-id> --data '{"source":"cli"}'

サーバーサイドでイベントを送信する

# Mint a per-website ingest key first (shown ONCE; regenerating rotates it)
tga ingest-key create <websiteId>

tga send <websiteId> --name cli_signup --id <stable-user-id> \
  --ingest-key <per-site-key> --data '{"plan":"pro"}'

tga ingest health <websiteId> --from 24h    # did anything actually land?

tga ingest-key revoke <websiteId>           # kill server-side ingest for this site

破棄されたイベントでも HTTP 200 が返されます。 取り込みエンドポイントは、イベントをボットとして破棄した場合に {"beep":"boop"} を返します。この CLI は成功として報告せず、ヒントを添えて致命的エラーとして扱います。そのため、エージェントが破棄されたイベントを成功したと思い込むことはありません。

サーバーサイドの取り込みには、ウェブサイトごとに別のキー（ANALYGA_INGEST_KEY または --ingest-key）を使用します。このキーは1つのウェブサイトにスコープが限定されているため、そのサイトのトラフィックにしか書き込めません。tga ingest-key create <websiteId> で発行し、tga ingest-key revoke <websiteId> で失効させます。平文が表示されるのは一度だけで、保存されるのはそのハッシュのみです。

課金 — 人間にチェックアウト URL を渡す

エージェントはテナントキーで認証し、プランを指定すると、支払いを完了する人間に渡すための Stripe Checkout URL を受け取ります。

tga billing checkout --plan pro

テナントはサーバー側でキーに基づいて固定されます。無料プラン（および価格が設定されていないプラン）は購入できず、内部の姉妹スタックのテナントに課金されることもありません。

MCP サーバー

CLI よりツールを使いたいですか？ analyga には MCP サーバーが付属しています。Claude Code（または任意の MCP クライアント）から接続すると、統計、イベント、ファネル、ウェブサイト、ID、サーバーサイドの取り込み（取り込みキーの発行と失効を含む）、課金チェックアウトを網羅する13個のネイティブツールをエージェントから利用できます。

tga mcp-serve        # stdio, for Claude Code / Cursor / Cline / Windsurf

JSON 設定を使うクライアントでは、ANALYGA_KEY 経由でキーを渡してください。MCP サーバーはプロジェクトディレクトリの外で実行されるため、.analyga/config.json は読み込まれません。

{
  "mcpServers": {
    "analyga": {
      "command": "tga",
      "args": ["mcp-serve"],
      "env": { "ANALYGA_KEY": "your-key" }
    }
  }
}

読み取り専用ツールにはその旨が明示されるため、クライアントが読み取り操作について人間に確認を求めることはありません。すべてのツールに outputSchema が定義されているため、エージェントが文章を解析したり、フィールド名を推測したりする必要はありません。また、ツールの結果と --json の出力は同じバイト列で、2つのインターフェースで1つのクライアントを使えます。キーのないセッションで表示されるのはオンボーディング用のインターフェースだけです。接続方法と、自分のテナントを初期設定する analyga_signup が利用でき、ツール一式は表示されません。

エラーコード

失敗には固定の code と専用の終了コードが付与されるため、エージェントはメッセージ文字列の照合ではなく、結果に応じた分岐ができます。

終了コード	意味	対応
2	使用方法	呼び出しを修正し、再試行しないでください
3	認証	認証情報を修正してください
4	権限	再試行せず、エスカレーションしてください
5	見つかりません	ID を確認してください
6	検証	ペイロードを修正してください
7	レート制限	間隔を空けて再試行してください
8	ネットワーク	再試行して問題ありません
9	サーバー	1回再試行してから報告してください

終了コード 1 は未処理のクラッシュ用に予約されているため、分類済みの失敗が曖昧になることはありません。サーバーが次の対応を提示できる場合は、独立した行に hint として返されます。

設定

優先順位の高い順に解決されます。

1. --key フラグ
2. ANALYGA_KEY 環境変数
3. カレントディレクトリの .analyga/config.json

tga whoami は、これらのうちどれが採用されたかを報告します。マルチテナントプラットフォームで最も重要なのは、「これから書き込む先のテナントはどれか」という確認です。.analyga/ には有効な認証情報が含まれるため、バージョン管理に含めないでください。

特徴

• セルフサービス登録 — tga signup を実行すると、カードも管理者の介在も不要で、テナントと最初の API キーが作成されます。キーなしで実行できるため、認証情報を用意する前から使えます
• テナントを考慮した ID 情報 — tga whoami を実行すると、tga_ キーの場合は固定されたテナントとキーのスコープが、セッションログインの場合はユーザーとチームが表示されます
• 統計とイベント — 任意の期間の主要なトラフィックとイベントの件数を確認できます。すべて読み取り専用で、すべて --json に対応しています
• ファネル — 一度定義すればいつでも実行でき、サイトのステップごとのコンバージョンを確認できます
• ネットワーク集計 — チーム全体の複数サイトにまたがる統計を確認できます
• サーバーサイド取り込み — サイト単位のスコープ付きキーを使って tga send を実行します。tga ingest-key create|revoke でキーを発行、ローテーション、失効できます。ボットとして破棄されたイベントは、偽の 200 を返さず、明確に失敗します
• 課金チェックアウト — tga billing checkout --plan <id> を実行すると、人に渡せる Stripe URL が返されます
• 安定した ID — --id を指定することで、エージェントがひとつの匿名訪問者にまとめられるのを防ぎます
• agent-schema — 1 つのコマンドで契約全体（コマンド、フラグ、型、エラーコード）を出力するため、エージェントが推測する必要はありません
• MCP サーバー — Claude Code、Cursor、Cline、Windsurf、その他すべての MCP クライアント向けに 13 個のツールを提供します（tga mcp-serve）
• 分類されたエラー — 安定した code と失敗の種類ごとに異なる終了コードを返し、実行可能な hint を提供します

エージェントとの連携

CLAUDE.md、.cursorrules、.clinerules、.windsurfrules、または AGENTS.md に追加します。

## Analyga
This project uses Analyga for analytics. Use the `tga` CLI.
Config is in .analyga/config.json (auto-loaded), or set ANALYGA_KEY.
If not configured: tga login --key YOUR_KEY

Run `tga agent-schema --json` — it returns every command + valid flags + error codes.
This is the single source of truth: if it is not in the schema, do not use it.
Always pass --id on `tga send`, or agent traffic collapses into one visitor.

開発の背景

これまで使ってきた分析ツールは、どれも人がグラフを見ることを前提としていました。しかし、数値を必要としていたのはイベントを発生させたエージェントでした。そのため、ここでは CLI と MCP サーバーを主要なインターフェースとしており、REST API に後付けしたラッパーではありません。まだ初期段階で、素早く改善を続けています。粗削りな点や不足している点があれば、issue を作成してください。

ドキュメント

現時点では、tga --help と tga agent-schema --json が正式なリファレンスです。

ステータス

初期段階です。Tyga の姉妹スタックでドッグフーディングするために公開しています。インターフェースは変更される可能性がありますが、公開後にエラーコードの表記を変更することはありません。エージェントがそれらに基づいて分岐するためです。

ライセンス

プロプライエタリ — Tyga.Cloud Ltd. 詳細は LICENSE をご覧ください。