English Français العربية

io.github.nitishagar/lumen

Registre officiel Marketing et ventes

Deterministic SEO audits as MCP tools: 36-rule site audit, keywords, rank, CWV reports.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @lumen-seo/cli
Claude Code 
claude mcp add lumen -e 'LUMEN_PSI_KEY=<your lumen_psi_key>' -e 'LUMEN_CRUX_KEY=<your lumen_crux_key>' -e 'LUMEN_OPR_KEY=<your lumen_opr_key>' -- npx -y @lumen-seo/cli@0.3.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "lumen": {
            "command": "npx",
            "args": [
                "-y",
                "@lumen-seo/cli@0.3.0"
            ],
            "env": {
                "LUMEN_PSI_KEY": "<your lumen_psi_key>",
                "LUMEN_CRUX_KEY": "<your lumen_crux_key>",
                "LUMEN_OPR_KEY": "<your lumen_opr_key>"
            }
        }
    }
}

Variables d'environnement

  • LUMEN_PSI_KEY secret Google PageSpeed Insights API key — enables the CWV lab leg of page reports. Optional; without it that leg reports not-configured.
  • LUMEN_CRUX_KEY secret Chrome UX Report API key — enables field CWV data. Optional; without it that leg reports not-configured.
  • LUMEN_OPR_KEY secret Open PageRank API key — enables the OPR authority signal. Optional; without it that signal reports not-configured.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. lumen
  2. Why lumen
  3. Quickstart
  4. Packages
  5. Documentation
  6. Development
  7. License

lumen

Lightweight, pluggable, MCP-first SEO toolkit — free services only, bring your own keys, provenance on every number.

Status: v0.2.x — first public release. The CLI, the five MCP tools, and the docs site are live; see CHANGELOG.md for what shipped and the docs for the full guides.

Why lumen

Most SEO tooling is a black box with a subscription. lumen is the opposite: a local-first, agent-first audit toolkit that runs on free data sources, never ships a number it can't attribute, and speaks MCP so your coding agent can run it for you.

  • Local site audits — bounded, robots-respecting crawler with 36 built-in rules, severity scoring, and CI-friendly exit codes (0 pass, 1 findings, 2 usage/abort).
  • Free-tier data providers — PageSpeed Insights, CrUX, Google Suggest, Wikipedia demand, OpenPageRank, Tranco, DuckDuckGo SERP. BYOK: keys are read from env vars by name, never stored or logged.
  • MCP-first — five tools (lumen_audit_site, lumen_page_report, lumen_keyword_ideas, lumen_rank_check, lumen_authority) over stdio or a thin Cloudflare Worker gateway.
  • Provenance on every number — each metric carries its source and fetch timestamp; no free source, no number.

Quickstart

Requires 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

Wire it into Claude Code (or Cursor / VS Code — MCP onboarding):

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

Then just ask: "audit my site and tell me what to fix first."

Packages

PackagePurpose
@lumen-seo/coretypes + payload models, config loader (failThreshold), Fetcher (SSRF/timeout/backoff), robots, provider/rule SPIs + registries
@lumen-seo/auditbounded crawler, 36 built-in AuditRules, severity scorer, report assembly
@lumen-seo/providersbuilt-in data providers (BYOK, free services only)
@lumen-seo/clilumen CLI, JSONL history, stdio MCP launcher
@lumen-seo/mcpMCP tool definitions + transport adapters (Cloudflare Worker)
@lumen-seo/sitedocs site (live)

Note on packaging: npm packages ship compiled JavaScript + type declarations (dist/) — plain node import, no flags, no tsx. The TypeScript sources stay the source of truth in the repo; the release pipeline compiles per package at publish time.

Documentation

Development

Requires Node >= 22.

npm install
npm run lint
npm run typecheck
npm test

See CONTRIBUTING.md for conventions, SECURITY.md for the security policy, and docs/release.md for the release runbook.

License

Apache-2.0 — Copyright 2026 Nitish Agarwal

Questions fréquentes

Qu'est-ce que io.github.nitishagar/lumen ?

Deterministic SEO audits as MCP tools: 36-rule site audit, keywords, rank, CWV reports.

Comment installer io.github.nitishagar/lumen ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add lumen -e 'LUMEN_PSI_KEY=<your lumen_psi_key>' -e 'LUMEN_CRUX_KEY=<your lumen_crux_key>' -e 'LUMEN_OPR_KEY=<your lumen_opr_key>' -- npx -y @lumen-seo/cli@0.3.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.nitishagar/lumen ?

Oui. Il attend LUMEN_PSI_KEY, LUMEN_CRUX_KEY, LUMEN_OPR_KEY, à renseigner dans sa configuration.

io.github.nitishagar/lumen est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient io.github.nitishagar/lumen ?

Il est publié par nitishagar. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.