English Français العربية

io.github.nitishagar/lumen

السجل الرسمي التسويق والمبيعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.nitishagar/lumen؟

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

كيف أثبّت io.github.nitishagar/lumen؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.nitishagar/lumen إلى مفتاح API؟

نعم. يتطلب LUMEN_PSI_KEY, LUMEN_CRUX_KEY, LUMEN_OPR_KEY، وتضبطها في إعداداته.

هل io.github.nitishagar/lumen مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون io.github.nitishagar/lumen؟

ينشره nitishagar. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.