Lookout

lookout-mcp

这是 Lookout 的 MCP 服务。Lookout 可在一个视图中展示你所有项目的 Vercel Web Analytics。

连接 Claude、Cursor 或其他 MCP 客户端。然后询问你的网站相关问题：访客、来源、营销活动、Core Web Vitals，以及网站之间的流量。答案基于真实数据。

“本周哪个落地页的表现下滑最多？下滑前部署了什么？”

该服务是 Lookout REST API 的轻量客户端。所有答案均来自 api.lookoutstats.com。该服务不存储任何数据。

你可以通过两种方式运行该服务：

• 托管，通过 Streamable HTTP：https://mcp.lookoutstats.com
• 本地，通过 stdio：npx lookout-mcp

60 秒快速设置

1. 在 Lookout 中，打开 Settings › API & MCP 并创建 API 密钥（lk_live_…）。仅当你需要使用两个写入工具时，才选择 Allow notes and exports。
2. 使用以下配置之一，将服务添加到你的客户端。将密钥粘贴到配置中。
3. 重启客户端。

Claude Desktop

打开 Settings → Developer → Edit config（claude_desktop_config.json），并添加以下条目：

{
  "mcpServers": {
    "lookout": {
      "command": "npx",
      "args": ["-y", "lookout-mcp"],
      "env": { "LOOKOUT_API_KEY": "lk_live_…" }
    }
  }
}

claude.ai（连接器）

claude.ai 自定义连接器不会发送密钥标头。因此，托管服务目前无法从连接器获取你的 API 密钥。在 Lookout 支持连接器 OAuth 登录之前，请使用 Claude Desktop（见上文）或 Claude Code。

Cursor

将以下内容放入项目中的 .cursor/mcp.json。若要在所有项目中使用该服务，请将其放入 ~/.cursor/mcp.json。

{
  "mcpServers": {
    "lookout": {
      "url": "https://mcp.lookoutstats.com",
      "headers": { "Authorization": "Bearer lk_live_…" }
    }
  }
}

Claude Code

claude mcp add --transport http lookout https://mcp.lookoutstats.com \
  --header "Authorization: Bearer lk_live_…"

Windsurf

将以下内容放入 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "lookout": {
      "serverUrl": "https://mcp.lookoutstats.com",
      "headers": { "Authorization": "Bearer lk_live_…" }
    }
  }
}

其他客户端

• stdio：LOOKOUT_API_KEY=lk_live_… npx -y lookout-mcp
• Streamable HTTP：通过标头 Authorization: Bearer lk_live_… 向 https://mcp.lookoutstats.com 发送 POST 请求。如果你的网关会保留 Authorization 供自身使用（Smithery 就是如此），请改为发送 X-Lookout-Api-Key: lk_live_…。

工具

这些规则适用于所有工具：

• range 为 24h、7d（默认值）或 30d。也可以使用自定义时间范围，例如 { "from": "2026-10-01", "to": "2026-10-14" }。自定义时间范围最长为 30 个 UTC 日。
• board 为看板的 ID 或准确名称。
• 每个工具会先返回一行摘要，随后是精简的 JSON。

工具	参数	结果
list_boards	—	工作区中的看板及其 ID 和站点数量
get_board	board、range	看板上的所有站点。每个站点包含访客数、与上一时段相比的变化、页面浏览量、每次访问的页面数、主要来源和国家/地区，以及转化次数
get_site	site、range、board?	单个站点的详细信息。显示每日（或每小时）访客数、主要引荐来源、国家/地区和页面、生产环境部署以及 Core Web Vitals。指定 board 后，也会显示备注。
compare_sites	sites[]（1–5）、range、mode、baseline?	并排比较站点。absolute 显示访客数。indexed 将第一个数据点设为 100。baseline 将各站点显示为某个站点的百分比。
get_campaigns	site、range	按 UTM 活动、来源和媒介统计访客数，并显示目标转化次数。此工具需要 Vercel Web Analytics Plus。
get_flow	board、range	看板上各站点之间的流量：哪个站点向哪个站点引流
get_speed	site、range、device	所有、移动端或桌面端访客的 Core Web Vitals（LCP、INP、CLS、p75），以及最慢的路由
list_fixes	board、range、status	看板的修复列表：按受影响访客数排序，列出应优先修复的事项、重要原因以及检查修复的方法
list_alerts	—	告警规则及过去 30 天的告警
add_annotation ✎	board、site?、date、text、scope	在看板图表的某一天添加备注，可针对单个站点或所有站点
export_board ✎	board、fmt（pdf 或 csv）、range	看板的下载链接。链接有效期为 5 分钟。

✎ 写入工具。使用写入工具需要带有 Allow notes and exports 权限的密钥。

资源：

• lookout://boards：看板。
• lookout://boards/{id}：看板上的站点，涵盖过去 7 天。

提示词：

• weekly_brief(board)：简短简报，列出变化最大的站点及其原因。
• why_did_it_drop(site)：查明流量何时开始下降、发生了哪些变化，以及可能的原因。

示例问题

1. “本周哪个落地页的表现下滑最多？下滑前刚部署了什么？”
2. “按索引值比较过去 30 天的三个定价页面。”
3. “acme.com 的访客来自哪里？哪个活动带来的访客最多？”
4. “我们的网站在移动端是否通过了 Core Web Vitals？哪个路由最慢？”
5. “我的落地页会将访客引导到主站吗？哪些页面会让访客止步？”

安全性

• 你的密钥只能访问你的数据。 每次调用都会携带你的密钥发送到 Lookout API。密钥只能访问自己的工作区。服务端不保留数据，也不会记录回答。服务端不会存储密钥。
• 密钥默认只读。 除非创建密钥时启用 Allow notes and exports，否则密钥只能读取数据。写入密钥可以添加图表备注和创建导出链接，但不能更改看板、成员、警报或设置，也无法查看你的 Vercel 令牌。
• 不含个人数据。 Vercel Web Analytics 不使用 Cookie，只会报告汇总数据。回答包含计数、域名、路径、引荐来源和国家/地区，但不会识别个人。
• 不要将密钥放入代码库。 将密钥放入客户端的本地配置中。示例包括 ~/.cursor/mcp.json、Claude 配置和环境变量。不要将密钥放入会提交的文件中。你可以随时在 Settings › API & MCP 中撤销密钥。撤销后，密钥将在下一次请求时失效。
• 限制。 每个密钥每小时最多可发出 600 个请求。REST API 和 MCP 服务共用此限制。compare_sites 会为每个站点发出 1 个请求。其他每个工具会发出 1 个请求。超出限制时，你会收到带有 Retry-After 标头的 429 响应。托管服务每批最多接受 5 条消息。
• 来自外部的数据。 引荐来源、路径、UTM 值、部署消息和备注文本来自网站及其访客。服务端会告知模型将这些内容作为数据而非指令处理。除非需要使用写入工具，否则请保持密钥只读。

请将安全问题发送至 [email protected]。

自托管

npm i -g lookout-mcp
PORT=3000 lookout-mcp-http        # Streamable HTTP on http://127.0.0.1:3000 (POST /, GET /health)

服务端默认监听 127.0.0.1。在容器中，请设置 HOST=0.0.0.0。

你也可以在自己的服务端中使用处理程序。该处理程序是一个普通的 (Request) => Promise<Response> 函数：

import { createHttpHandler } from "lookout-mcp/http";
export const POST = createHttpHandler();

你可以不做任何更改，直接将此代码库部署到 Vercel（vercel.json、api/index.js）。若要在任一入口点使用不同的 API 基础 URL，请设置 LOOKOUT_API_URL。

链接

• Lookout · API 与 MCP 文档 · OpenAPI
• 贡献指南 · 行为准则 · MIT 许可证

Lookout 与 Vercel Inc. 无关联。