measuremy.site

measuremysite-mcp

AI エージェントが読み取れる、クッキーを使わないウェブ解析です。 1 つのウェブサイト向けの小規模な解析サーバーで、MCP サーバーが組み込まれているため、Claude Code、Cursor、Codex でトラフィックを確認し、次に何をすべきかを判断できます。

ご自身の Cloudflare アカウントにデプロイします（Workers + D1。小規模サイトのほとんどは無料枠で十分です）。データはご自身のアカウント内に保管されます。

このリポジトリは以前、agentlytics-mcp という名前でした。既存のインストールとの互換性を保つため、worker、データベース、トラッカー（agentlytics.track）、MCP サーバーは引き続きその名前を使用しています。

_{質問と回答の例。数値は説明用です。}

ホステッド MCP サーバー：https://a.measuremy.site/mcp

自分で運用したくない場合は、measuremy.site がホステッド版です（MCP レジストリでは site.measuremy/analytics）。同じ MCP ツールに加え、ダッシュボード、トラフィック急増の AI による解説、自分に言及した投稿（Hacker News、Bluesky、YouTube など）の追跡、アラート、週次サマリーを利用できます。OAuth による Streamable HTTP に対応しています。初回はブラウザーからサインインするだけで、API キーを貼り付ける必要はありません。30 日間の無料トライアルがあり、カード登録は不要です。プランは月額 9 ドルからです。

VS Code（Copilot）：.vscode/mcp.json に設定するか、MCP: Add Server → HTTP を選択します。サーバーの起動時に VS Code からサインインを求められます。

{
  "servers": {
    "measuremysite": { "type": "http", "url": "https://a.measuremy.site/mcp" }
  }
}

Claude Code

claude mcp add --scope user --transport http measuremysite https://a.measuremy.site/mcp

Cursor（~/.cursor/mcp.json）

{ "mcpServers": { "measuremysite": { "url": "https://a.measuremy.site/mcp" } } }

サインイン時にアカウントを作成（またはログイン）し、サイトのドメインを入力します。次に、エージェントに「このプロジェクトに measuremy.site の解析を追加して」と依頼してください。サーバーからサイト用のスクリプトタグが渡されます。ドキュメント：measuremy.site/docs/mcp。

この README の以降の部分では、セルフホスト版について説明します。

エージェントでできること

たとえば、自然な言葉で質問できます。

• 「昨日、トラフィックが急増したのはなぜですか？」急増と、その背景にある流入元、ページ、イベントを特定します。
• 「ホームページから登録ページに進む間に、ユーザーはどこで離脱していますか？」ファネルを作成し、最大の離脱ポイントを示します。
• 「何がうまくいっていますか？ 次に何を投稿すべきですか？」コンバージョン数でチャネルを順位付けし、具体的な手順にまとめます。
• 「Reddit の投稿用に追跡リンクを作成して、来週、成果を確認してください。」

MCP 経由で公開されるツール：

分野	ツール
トラフィック	get_overview、get_timeseries、top_sources、top_pages、top_countries、top_browsers、top_systems、list_events
訪問に関する質問	query_visits（国、ブラウザー、OS、流入元、ページ、イベント、日ごとのフィルタリングとグループ化）、recent_visits
急増	find_traffic_spikes、explain_spike（注釈を含む、原因の順位付け）
ファネル	create_funnel、get_funnel、delete_funnel
成長	get_whats_working、get_growth_actions
キャンペーン	create_tracked_link、get_campaign_results、add_annotation

さらに、データに基づく計画の作成をエージェントに案内する plan_marketing プロンプトもあります。

プライバシー

• クッキーは使用せず、訪問者のブラウザーには何も保存しません。
• IP アドレスやユーザーエージェントは保存しません。訪問者 ID は毎日変わるハッシュなので、翌日以降に同じ人を追跡することはできません。
• 保存するのはブラウザー名と OS 名（「Firefox」、「macOS」など）、および Cloudflare が報告する国のみです。
• 生のイベントデータは 400 日後に削除されます。時間単位の集計値は保存されます。

ご自身や訪問者に適用される要件をご確認ください。これは法的助言ではありません。

デプロイ

ワンクリック

ボタンをクリックすると、このリポジトリが GitHub アカウントにコピーされ、D1 データベースが作成され、マイグレーションが実行されて、Worker がデプロイされます。次の3つの設定を求められます。

• SITE_DOMAIN：ウェブサイトのドメイン（example.com など。https:// や www は含めません）
• HASH_SECRET：日次の訪問者 ID の生成に使う、長くランダムな文字列
• MCP_READ_KEY：もう1つの長くランダムな文字列。AI エージェントが使用するキーです

openssl rand -hex 32 で2つのランダムな値を生成し、以下でエージェントを接続するために MCP_READ_KEY を控えておいてください。

手動で設定する

Cloudflare アカウントと Node.js 20 以降が必要です。

git clone https://github.com/developeron29/measuremysite-mcp.git
cd measuremysite-mcp
npm install
npx wrangler login

1. データベースを作成し、出力された database_id を wrangler.jsonc に貼り付けます。

   npx wrangler d1 create agentlytics-mcp
   

2. 3つの設定を指定します。 2つのキーには、openssl rand -hex 32 で生成した値など、長くランダムな値を使用してください。

   npx wrangler secret put SITE_DOMAIN     # e.g. example.com
   npx wrangler secret put HASH_SECRET     # makes the daily visitor id; never share it
   npx wrangler secret put MCP_READ_KEY    # the key your agent uses; keep it out of your repo
   

   初めて secret put を実行すると、Wrangler が Worker の作成を提案する場合があります。その場合は「はい」と答えてください。

3. デプロイします（この操作でテーブルも作成されます）。

   npm run deploy
   

どちらの方法でも、https://agentlytics-mcp.<you>.workers.dev のような Worker URL が発行されます。URL を開くと、ドメインが表示されたステータスページが表示されます。Cloudflare ダッシュボードで stats.yourdomain.com などのカスタムドメインを設定できます。

レート制限（任意）： 1つの IP アドレスからのアクセス回数を制限するには、これを wrangler.jsonc に追加して、再度デプロイします。

"ratelimits": [{ "name": "COLLECT_LIMITER", "namespace_id": "1001", "simple": { "limit": 120, "period": 60 } }]

サイトにトラッカーを追加する

すべてのページの <head> に次のコードを追加します。

<script defer src="https://YOUR-WORKER-URL/t.js"></script>

シングルページアプリでのクライアント側のナビゲーションも含め、ページビューをカウントします。登録などの重要なイベントをカウントするには、次のようにします。

agentlytics.track("signup", { plan: "pro" });

または、JavaScript を使わずに任意の要素で次のようにします。

<button data-agentlytics-event="cta_click">Start free</button>

SITE_DOMAIN（およびそのサブドメイン）上のページのみがカウントされます。

エージェントを接続する

Claude Code

claude mcp add --scope user --transport http agentlytics https://YOUR-WORKER-URL/mcp --header "Authorization: Bearer YOUR_MCP_READ_KEY"

Cursor（.cursor/mcp.json または ~/.cursor/mcp.json）

{
  "mcpServers": {
    "agentlytics": {
      "url": "https://YOUR-WORKER-URL/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_READ_KEY" }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.agentlytics]
url = "https://YOUR-WORKER-URL/mcp"
bearer_token_env_var = "AGENTLYTICS_READ_KEY"

また、Codex を起動するシェルで export AGENTLYTICS_READ_KEY=YOUR_MCP_READ_KEY を実行します。

次のように依頼してください："agentlytics を使って、今週のサイトの状況を教えてください。" 比較するには、アクセスの急増を把握できるだけの数日分のトラフィックが必要です。

エージェントにセットアップを任せる

コーディングエージェントに AGENTS.md を指定し、「AGENTS.md に従って、自分のサイト用に measuremysite-mcp をデプロイしてください」と依頼します。Cloudflare へのログインが必要な操作を行う前に確認を求めながら、すべての手順を進めます。

セルフホストとホステッド、どちらを選ぶ？

	measuremysite-mcp（このリポジトリ）	measuremy.site
エージェント向け MCP ツール	はい	はい
Cookie を使わないトラッキング、ファネル、急増、キャンペーン	はい	はい
サイト数	デプロイごとに1つ	1アカウントにつき複数
ダッシュボード	いいえ（エージェントに尋ねてください）	はい。フィルターと公開共有リンク付き
急増に関する AI の説明	いいえ	はい
あなたに言及した投稿（HN、Lobsters、Bluesky、YouTube、Reddit）	いいえ	はい。トラフィックグラフ上に表示
アラート、週次メールサマリー	いいえ	はい
運用者	あなた自身（自分の Cloudflare アカウント上）	私たち
価格	無料（Cloudflare の利用料金が適用されます）	30日間の無料トライアル後、月額 $9 から

開発

cp .dev.vars.example .dev.vars   # then edit the values
npm run db:migrate:local
npx wrangler dev
npm test
npm run typecheck

scripts/stdio.sh はサーバーをローカルで実行し、stdio 経由で MCP を提供します。コマンドとしてサーバーを起動するクライアント（Glama など）向けです。環境変数に SITE_DOMAIN、HASH_SECRET、MCP_READ_KEY が必要です。

ライセンス

MIT。詳しくは LICENSE をご覧ください。