mcpField
L
lumen

lumen

本地服务
github.com/nitishagar商业与营销04 周前更新
代码仓库

关于 lumen

lumen 是面向 SEO 审计和编码 Agent 的本地优先工具包，可通过 CLI 或 MCP 检查网站、关键词与排名。它使用免费数据源，并为每项指标附上来源和抓取时间。

主要功能

  1. 0136 条规则的网站审计
  2. 02关键词建议与排名检查
  3. 03Core Web Vitals 报告
  4. 04指标来源与抓取时间
  5. 05支持 CI 的退出码

适用场景

  1. 01检查网站 SEO 问题并按严重程度排序
  2. 02通过 CLI 在 CI 中运行网站审计
  3. 03查询关键词创意与搜索排名

MCP 相关

提供五个 MCP 工具，用于网站审计、页面报告、关键词建议、排名检查和权威度查询；支持 stdio，也可通过 Cloudflare Worker 网关使用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "nitishagar-lumen": {
      "command": "npx",
      "args": [
        "-y",
        "@lumen-seo/cli"
      ],
      "env": {
        "LUMEN_PSI_KEY": "<LUMEN_PSI_KEY>",
        "LUMEN_CRUX_KEY": "<LUMEN_CRUX_KEY>",
        "LUMEN_OPR_KEY": "<LUMEN_OPR_KEY>"
      }
    }
  }
}
启动命令npx -y @lumen-seo/cli
需要配置的环境变量
LUMEN_PSI_KEY密钥Google PageSpeed Insights API key — enables the CWV lab leg of page reports. Optional; without it that leg reports not-configured.
LUMEN_CRUX_KEY密钥Chrome UX Report API key — enables field CWV data. Optional; without it that leg reports not-configured.
LUMEN_OPR_KEY密钥Open PageRank API key — enables the OPR authority signal. Optional; without it that signal reports not-configured.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@lumen-seo/cli0.3.0

工具

5

收录的工具列表 · 更新于 3 周前

参数类型必填说明
urlstring是
maxPagesinteger否
failThresholdenum否info | warning | error | off
response_formatenum否concise | detailed

详细介绍

lumen

CI npm Docs License: Apache-2.0

轻量、可插拔、MCP 优先的 SEO 工具包——仅使用免费服务，自备密钥，每项数据都注明来源。

状态： v0.2.x——首次公开发布。CLI、五个 MCP 工具和文档站点均已上线；请查看 CHANGELOG.md 了解已发布内容，并参阅文档获取完整指南。

为什么选择 lumen

大多数 SEO 工具都是需要订阅的黑箱。lumen 则截然不同：它是一款本地优先、Agent 优先的审计工具包，使用免费数据源运行，绝不提供无法注明来源的数据，并支持 MCP，让你的编码 Agent 可以代你运行。

  • 本地站点审计 — 有界且遵循 robots 规则的爬虫，内置 36 条规则、严重性评分和适用于 CI 的退出代码（0 通过，1 有发现，2 用法错误/中止）。
  • 免费层数据提供商 — PageSpeed Insights、CrUX、Google Suggest、Wikipedia 需求数据、OpenPageRank、Tranco、DuckDuckGo SERP。自备密钥（BYOK）：密钥仅按名称从环境变量读取，绝不存储或记录。
  • MCP 优先 — 五个工具（lumen_audit_site、lumen_page_report、lumen_keyword_ideas、lumen_rank_check、lumen_authority），通过 stdio 或轻量的 Cloudflare Worker 网关提供。
  • 每项数据都注明来源 — 每项指标均包含来源和获取时间戳；没有免费来源，就不提供数据。

快速开始

需要 Node >= 22.7。

# One-off audit — no install
npx -y @lumen-seo/cli audit https://example.com

# Install globally
npm install -g @lumen-seo/cli
lumen audit https://example.com --max-pages 50

将其接入 Claude Code（或 Cursor / VS Code——MCP 入门指南）：

claude mcp add --transport stdio lumen -- npx -y @lumen-seo/cli mcp

然后只需询问：“审计我的网站，并告诉我应该先修复什么。”

软件包

软件包用途
@lumen-seo/core类型和载荷模型、配置加载器（failThreshold）、Fetcher（SSRF/超时/退避）、robots、提供商/规则 SPI 和注册表
@lumen-seo/audit有界爬虫、36 条内置 AuditRules、严重性评分器、报告组装
@lumen-seo/providers内置数据提供商（自备密钥，仅使用免费服务）
@lumen-seo/clilumen CLI、JSONL 历史记录、stdio MCP 启动器
@lumen-seo/mcpMCP 工具定义和传输适配器（Cloudflare Worker）
@lumen-seo/site文档站点（在线查看）

关于打包的说明： npm 软件包包含编译后的 JavaScript 和类型声明（dist/）——可直接使用 node 导入，无需标志，也无需 tsx。仓库中的 TypeScript 源码仍是唯一可信来源；发布流程会在发布时按软件包编译。

文档

开发

需要 Node >= 22。

npm install
npm run lint
npm run typecheck
npm test

有关约定，请参阅 CONTRIBUTING.md；有关安全策略，请参阅 SECURITY.md；有关发布操作手册，请参阅 docs/release.md。

许可证

Apache-2.0 — 版权所有 2026 Nitish Agarwal

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。