measuremy.site

measuremysite-mcp

AI Agent 可读取的无 Cookie 网站分析。 一款用于单个网站的小型分析服务，内置 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" } } }

登录时，你需要创建账户（或登录）并输入网站域名。然后让 Agent“将 measuremy.site 分析添加到此项目”：服务会向它提供适用于你网站的 script 标签。文档：measuremy.site/docs/mcp。

本 README 其余部分介绍可自托管版本。

你的 Agent 可以做什么

你可以用日常语言提问，例如：

• “昨天流量为什么激增？”它会找出峰值及背后的来源、页面或事件。
• “用户从首页到注册的过程中在哪一步流失？”它会创建漏斗并显示流失最多的环节。
• “什么效果好，我接下来应该发布什么内容？”它会按转化量对渠道排序，并据此列出行动步骤。
• “为我的 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 提示词，可引导 Agent 制定以数据为依据的计划。

隐私

• 不使用 Cookie，也不会在访客的浏览器中存储任何信息。
• 不存储 IP 地址或用户代理。访客 ID 是每日变化的哈希值，因此无法跨日跟踪访客。
• 只保留浏览器和 OS 名称（如“Firefox”“macOS”）以及 Cloudflare 报告的国家/地区。
• 原始事件会在 400 天后删除；小时汇总数据会保留。

请确认这些内容在你所在地区以及访客所在地区的适用情况；本文不构成法律建议。

部署

一键部署

该按钮会将此代码仓库复制到你的 GitHub 账户、创建 D1 数据库、运行迁移并部署 worker。它会要求设置三项配置：

• SITE_DOMAIN：你的网站域名，例如 example.com（不含 https:// 或 www）
• HASH_SECRET：任意一串较长的随机字符串，用于生成每日访客 ID
• MCP_READ_KEY：另一串较长的随机字符串，供你的 AI Agent 使用

使用 openssl rand -hex 32 生成这两个随机值，并保留 MCP_READ_KEY，以便在下文连接 Agent。

手动部署

你需要一个 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. 设置三项配置。 两个密钥请使用较长的随机值，例如通过 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
   

   Wrangler 可能会在首次执行 secret put 时询问是否创建 worker；选择是即可。

3. 部署（这也会创建数据表）：

   npm run deploy
   

无论采用哪种方式，你都会获得一个 worker URL，例如 https://agentlytics-mcp.<you>.workers.dev。打开该 URL 会显示包含你域名的状态页面。你可以在 Cloudflare 控制面板中绑定自定义域名，例如 stats.yourdomain.com。

**可选的速率限制：**若要限制单个 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（及其子域名）的页面才会被统计。

连接你的 Agent

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 的 shell 中执行 export AGENTLYTICS_READ_KEY=YOUR_MCP_READ_KEY。

然后询问：“使用 agentlytics 告诉我这个星期网站的表现如何。”要比较流量峰值，需要先积累几天的流量数据。

让 Agent 帮你完成设置

让你的编码 Agent 查看 AGENTS.md，并对它说：“按照 AGENTS.md 为我的网站部署 measuremysite-mcp。”它会逐步完成所有操作，并在需要登录 Cloudflare 前征求你的同意。

自托管还是托管服务？

	measuremysite-mcp（此代码仓库）	measuremy.site
为你的 Agent 提供的 MCP 工具	是	是
无 Cookie 跟踪、漏斗、流量峰值、营销活动	是	是
网站数量	每次部署一个	多个，共用一个账户
控制面板	无（向你的 Agent 提问）	有，支持筛选和公开分享链接
流量峰值的 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。