PageLens AI

PageLens AI - MCP Server

将 PageLens AI 报告连接到 Claude Desktop、Cursor、Codex 和其他 MCP 客户端，让你的 AI 助手了解出了什么问题、为什么重要，以及接下来该修复什么。

一个 MCP (Model Context Protocol) 服务，可让 AI Agent 直接访问 PageLens AI——这款独立的 AI 构建网站发布审核工具。PageLens AI 会将 UX、SEO、Performance、Accessibility、Security、Conversion 和 QA 流程审计中的发布风险，转化为通俗易懂的优先事项和适合 Agent 使用的修复上下文。

将其接入 Cursor、Claude Desktop、Codex 或任何兼容 MCP 的客户端后，你的 Agent 就可以读取扫描结果、深入查看问题、找出可快速解决的问题、记录负责人决策，并帮助完成修复闭环，无需离开 IDE。

---

MCP Endpoint

https://www.pagelensai.com/api/mcp

这是一个远程 MCP 服务——无需本地安装。

---

PageLens 路径选择指南

• Launch Pack 面向希望进行一次性修复循环的创始人、营销人员和 AI 构建者：以负责人为先的评估结果、供 AI 构建工具使用的修复提示词、Markdown 导出、桌面端和移动端审核，以及重新扫描。
• CLI/API/deploy hooks 面向 Pro+ 用户，可让 PageLens AI 通过 CI、发布脚本和客户端工作流创建扫描。
• MCP 面向需要读取 PageLens 报告、了解负责人的发布评估、检查证据，并帮助你修补或分类问题的 AI 助手。

如果你不想阅读技术细节，请从 PageLens 网页报告开始，并将修复提示词复制到 Lovable、Bolt、Replit、Cursor、Codex、Claude Code、Copilot 或 Windsurf。如果你希望编码 Agent 直接处理报告数据，请连接此 MCP 服务。

---

快速开始

Cursor

添加到你的 ~/.cursor/mcp.json（或工作区 .cursor/mcp.json）：

{
  "mcpServers": {
    "pagelens": {
      "url": "https://www.pagelensai.com/api/mcp"
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "pagelens": {
      "type": "http",
      "url": "https://www.pagelensai.com/api/mcp"
    }
  }
}

Codex CLI

添加到 ~/.codex/config.toml：

[mcp_servers.pagelens]
url = "https://www.pagelensai.com/api/mcp"

通用 / 其他客户端

使用可流式传输的 HTTP 端点：

https://www.pagelensai.com/api/mcp

---

身份验证

此服务使用 OAuth 2.0。首次连接时，你的 MCP 客户端会打开浏览器窗口，通过你的 PageLens 账户进行授权。无需管理 API 密钥。

授权后授予的权限范围：

权限范围	可用功能
read:scans	列出并读取你的扫描结果
read:findings	读取问题和可快速解决的问题
write:feedback	提交问题反馈和负责人决策

---

可用工具

whoami

确认此 MCP 会话使用的 PageLens 账户，以及已授予的 OAuth 权限范围。

{}

---

list_domains

列出你已验证所有权的域名，以及徽章等级和当前关联到公开徽章的扫描。

{
  "include_unverified": false
}

---

list_scans

列出你最近的 PageLens 扫描。可按状态、域名或日期筛选。每次扫描返回精简摘要（ID、URL、评分、等级、严重性数量和 launchVerdict）。扫描可能包含 launchContext，其中带有 builderPlatform 和 launchMoment，以便 Agent 根据负责人的工作流制定修复方案，同时不更改证据或严重性。QA Audit 扫描会包含精简的 qaAudit 摘要，其中涵盖置信度、流程步骤数量、已审核页面与页面预算、受阻/需要审核的步骤数量、身份验证配置文件状态，以及在安全的同源链接图已遍历完毕时，未能达到页面预算的原因。

{
  "limit": 20,
  "status": "COMPLETE",
  "domain": "example.com",
  "since": "2026-01-01T00:00:00Z"
}

状态值： PENDING · RUNNING · COMPLETE · FAILED · CANCELLED

---

get_scan

读取单次扫描的完整摘要：评分、等级、以负责人为先的 launchVerdict、严重性数量、发布上下文、执行摘要、优先级最高的 5 项问题，以及各角色的审核结果。对于 QA Audit 扫描，get_scan 还会返回一个 qaAudit 区块，其中包含产品流程综合分析、流程重放、安全的受阻操作、置信度、已验证路由上下文和页面预算覆盖情况。

{
  "scan_id": "clxxxxxxxxxxxxxxx"
}

---

可用资源

pagelensai://scan/{id}/markdown

获取与 PageLens 界面中相同的 Agent 风格 Markdown 报告。标准报告包含启动上下文和结论前置信息，例如在采集到时会包含 ai_builder、launch_moment、launch_verdict_status 和 launch_verdict，随后是 Owner launch verdict 部分，以及一组 AI 构建者优先级提示词，供你的 Agent 在查看详细证据前采取行动。对于 QA Audit 扫描，报告会包含诸如 qa_journey_event_count、qa_confidence 和 qa_needs_review_step_count 等前置信息，随后是应用解读、旅程回放、受阻／有风险的路径、安全操作和后续 QA 测试。

当 Agent 需要丰富上下文来推理 QA Audit 时，请使用此项：

pagelensai://scan/clxxxxxxxxxxxxxxx/markdown

pagelensai://scan/{id}/summary.json

获取扫描的精简 JSON。标准扫描包含与 list_scans 和 get_scan 返回的相同 launchVerdict 对象：状态、标签、标题、摘要和后续步骤。对于 QA Audit 扫描，qaAudit 对象包含旅程元数据、综合分析、页面预算覆盖情况，以及任何解释为何可发现页面数少于购买页面数的 queue_exhausted 原因。

pagelensai://scan/clxxxxxxxxxxxxxxx/summary.json

---

list_findings

分页获取扫描的所有发现。可按严重性、类别、Persona、页面 URL 或规则 ID 进行筛选。使用 format: "full" 可包含描述、建议和证据。

{
  "scan_id": "clxxxxxxxxxxxxxxx",
  "severity": "HIGH",
  "category": "SECURITY",
  "format": "full",
  "limit": 50
}

严重性级别： CRITICAL · HIGH · MEDIUM · LOW · INFO

类别： UX · SEO · PERFORMANCE · ACCESSIBILITY · SECURITY · CONTENT · HEADERS · DESIGN · ERROR

Persona： MARKETER · CRO · UX · ACCESSIBILITY · BRAND · EXECUTIVE · PERFORMANCE · SEO

---

get_quick_wins

返回排名靠前的 N 项快速见效发现——影响大、投入低到中等——排名依据与 PageLens 控制面板相同的影响 × 投入评分器。也可以覆盖扫描所用的预设，以另一种视角重新排序。

{
  "scan_id": "clxxxxxxxxxxxxxxx",
  "limit": 5,
  "preset_override": "CONVERSION"
}

预设： PRE_SALES · PRE_LAUNCH · CONVERSION · INVESTOR · BRAND_POLISH

---

report_finding_feedback

将某项发现标记为误报、严重性错误、类别错误或不可操作。需要提供一段理由说明和一段具体证据摘录。

{
  "finding_id": "clxxxxxxxxxxxxxxx",
  "kind": "FALSE_POSITIVE",
  "reason": "The selector .pointer-events-auto matches 100+ utility classes, not a single offending element.",
  "evidence": "<div class=\"pointer-events-auto ...\"> — Tailwind utility, not an event-handler.",
  "proposed_severity": "LOW"
}

反馈类型： FALSE_POSITIVE · INCORRECT_SEVERITY · INCORRECT_CATEGORY · NOT_ACTIONABLE · OTHER

---

acknowledge_finding_decision

当问题确实存在，但反映了有意为之的架构、安全或产品权衡时，为某项发现附加由负责人管理的上下文。

此操作不会隐藏发现、编辑报告或更改 PageLens 评分。它会记录理由，使报告能够显示负责人已确认该项权衡，并让后续扫描识别出相同发现此前已获确认。

{
  "finding_id": "clxxxxxxxxxxxxxxx",
  "decision": "INTENTIONAL_TRADEOFF",
  "reason": "Next.js Cache Components and PPR currently prevent us from using per-request CSP nonces safely.",
  "evidence": "proxy.ts documents the CSP tradeoff: script-src uses 'unsafe-inline' because cached HTML shells cannot vary nonces per request.",
  "expires_at": "2026-10-01T00:00:00Z"
}

决策类型： ACKNOWLEDGED · ACCEPTED_RISK · INTENTIONAL_TRADEOFF · WONT_FIX_NOW

---

clear_finding_decision

清除先前确认的决策，使其不再出现在当前和未来的报告中。审计历史记录会保留。

{
  "decision_id": "clxxxxxxxxxxxxxxx",
  "reason": "We have migrated to a nonce-compatible rendering path."
}

如果没有 decision_id，也可以通过 finding_id 清除。

---

PageLens 检查内容

每次扫描都会对每个页面运行确定性规则引擎 + AI 审核流水线：

区域	示例
SEO	标题/元描述长度、规范 URL、Open Graph、标题层级
性能	Core Web Vitals（LCP、CLS、INP）、页面体积、阻塞渲染的资源、DOM 大小、第三方加载
安全	HTTP→HTTPS 重定向、暴露的 .env/.git 文件、SSL 到期时间、XSS 攻击面、源映射、页面源代码中暴露的密钥
无障碍	焦点可见 CSS、减少动态效果支持、ARIA 模式
UX	主视觉层级、移动端菜单模式、CTA 结构
内容	占位文本、过时的版权年份、混合内容引用
QA 审计	用户旅程重放、安全的表单/输入探索、阻止高风险操作、应用流程综合分析、页面预算覆盖情况

发现项包含严重程度、工作量估算、可直接复制的证据，以及一行修复建议。

QA 审计扫描不同于标准技术扫描：其主要产物是 Agent 用户旅程报告。PageLens 会尝试检查已购买的页面预算（例如，QA 审计最多检查 10 个页面），只有在安全的同源链接图已遍历完毕时，才应返回更少的页面。它可以使用经过验证的身份验证配置文件访问限定范围内的登录后路由，同时仍会避开 SSO、CAPTCHA、MFA、注册、付款、破坏性更改及其他会提交操作的行为。

---

Agent 工作流示例

使用我的 AI 构建工具修复：

“读取 example.com 最新的 PageLens Launch Pack 报告，列出对负责人风险最高的 3 项修复，并将每项整理成可在此代码库中应用的补丁计划。”

遵循发布背景：

“打开最新的 PageLens 报告。如果该报告是使用 Codex 或 Cursor 生成的，且发布场景是 Product Hunt，请优先处理能确保公开发布安全的修复，然后给我精确补丁。”

在 Cursor 中进行发布前审计：

“使用我的预发布站点最新的 PageLens 扫描，列出所有 CRITICAL 和 HIGH 级别的发现，并为排名前 5 项创建 GitHub 问题。”

CRO 审核：

“获取 example.com 的最新扫描，找出转化率优化的快速见效项，并总结在营销活动发布前需要修复的内容。”

安全检查：

“列出我上次扫描中所有严重程度为 HIGH 或更高的安全发现，并展示每项的证据。”

已接受的架构决策：

“对于 CSP unsafe-inline 发现，请根据我们的安全文档中的理由，将其确认为有意接受的 Next.js/PPR 权衡。不要将其标记为误报。”

修复后验证：

“修复这些发现后，我通过 CLI/API 重新运行了 PageLens。请将最新扫描与上一次扫描进行比较，告诉我哪些方面有所改善、退步，或仍需处理。”

MCP 通过 OAuth 读取报告数据并与之交互。若要通过自动化创建新扫描，请使用 PageLens CLI、API、GitHub Action 或部署钩子，并订阅 Pro+ 计划；随后请连接 MCP 的助手检查已完成的报告。

QA 审计审核：

“获取 example.com 最新的 QA 审计，读取 Markdown 资源，并告诉我验证了哪些用户旅程、哪些操作被安全阻止，以及 PageLens 是否检查了完整的页面预算。”

---

定价

PageLens AI 支持一次性上线检查和持续的计划自动化。

产品	价格	适用对象
免费上线检查	免费	所有者结论、一项问题预览、一条 AI 构建器提示词
修复包	$9	单页完整修复流程，并附带一次验证性重新扫描
QA 审计	$10	针对最多 10 个页面的 Agentic 公开应用旅程审查
上线包	$29	适合希望检查桌面端和移动端、最多 15 个页面、获取 AI 构建器修复提示词、Markdown 导出和一次重新扫描的认真 AI 构建者
数据安全上线包	$79	适用于收集电子邮件、付款、上传内容、账户、预约、私人数据或涉及客户信任的上线项目

付费报告包含 MCP 访问权限，Agent 可以依据所有者看到的同一份证据开展工作。持续健康监控、API 密钥、CLI 扫描、GitHub Actions、部署钩子、竞争对手、提醒以及团队／客户席位均为计划功能：

计划	价格	升级理由
Watch	$9/mo	1 个在线应用、每周健康监控、电子邮件提醒和徽章新鲜度
Builder	$39/mo	3 个网站、每周监控、手动扫描和更深入的审计
Pro	$99/mo	更多网站、Slack／webhook 提醒、竞争对手、API／CLI／部署自动化以及可扩展的团队工作流
Agency	$299/mo	多个客户网站、更高配额、更多席位、客户工作流和优先支持

当前定价模式中没有面向新用户的独立 Monitor 产品。付费账户计划包含健康监控；现有客户仍可能看到旧版监控条目。

查看完整定价 ->

---

链接

• 网站： https://www.pagelensai.com
• MCP 端点： https://www.pagelensai.com/api/mcp
• 控制面板： https://www.pagelensai.com/dashboard
• GitHub： https://github.com/PageLens-AI/pagelensai-mcp-server
• MCP 文档： https://www.pagelensai.com/mcp

---

许可证

MIT © PageLens AI