mcpField
L
lumen

lumen

ローカル
github.com/nitishagarビジネス・マーケティング04 週間前に更新
リポジトリ

lumen について

lumenは、サイト監査やコーディングエージェント向けのローカルファーストなSEOツールキットです。CLIとMCPから利用でき、無料データソースを使い、各指標に出典と取得時刻を記録します。

主な機能

  1. 0136ルールによるサイト監査
  2. 02キーワード案と順位チェック
  3. 03Core Web Vitalsレポート
  4. 04指標の出典と取得時刻
  5. 05CI向け終了コード

活用シーン

  1. 01サイトのSEO課題を特定して優先順位付け
  2. 02CLIでCI内のサイト監査を実行
  3. 03キーワード案と検索順位を確認

MCP 対応

サイト監査、ページレポート、キーワード案、順位チェック、オーソリティ確認の5つの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 ツールキットです。無料サービスのみを使用し、API キーはご自身で用意。すべての数値に出典情報が付与されます。

ステータス： v0.2.x — 初の一般公開リリースです。CLI、5 つの MCP ツール、ドキュメントサイトを公開しています。リリース内容はCHANGELOG.md、詳しいガイドはドキュメントをご覧ください。

lumen を選ぶ理由

ほとんどの SEO ツールは、サブスクリプションが必要なブラックボックスです。lumen はその対極にあります。ローカル優先、エージェント優先の監査ツールキットで、無料のデータソースを使い、出典を明示できない数値は決して提示せず、MCP に対応しているため、コーディングエージェントに実行させることができます。

  • ローカルサイト監査 — 範囲を制限し、robots を尊重するクローラーを搭載。組み込みのルールは 36 個で、重大度スコアリングと CI に適した終了コード（0 成功、1 検出事項あり、2 使用方法エラー／中断）を備えています。
  • 無料枠のデータプロバイダー — PageSpeed Insights、CrUX、Google Suggest、Wikipedia の需要、OpenPageRank、Tranco、DuckDuckGo SERP に対応します。BYOK：キーは環境変数から 名前で 読み込まれ、保存やログへの記録は行いません。
  • MCP ファースト — 5 つのツール（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範囲を制限したクローラー、組み込みの AuditRules 36 個、重大度スコアラー、レポートの組み立て
@lumen-seo/providers組み込みデータプロバイダー（BYOK、無料サービスのみ）
@lumen-seo/clilumen CLI、JSONL 履歴、stdio MCP ランチャー
@lumen-seo/mcpMCP ツール定義とトランスポートアダプター（Cloudflare Worker）
@lumen-seo/siteドキュメントサイト（公開サイト）

パッケージングについて： npm パッケージには、コンパイル済み JavaScript と型宣言（dist/）が含まれます。フラグや tsx を使わず、通常の node import で読み込めます。TypeScript ソースはリポジトリ内で引き続き信頼できる唯一の情報源であり、リリースパイプラインが公開時にパッケージごとにコンパイルします。

ドキュメント

開発

Node >= 22 が必要です。

npm install
npm run lint
npm run typecheck
npm test

規約についてはCONTRIBUTING.md、セキュリティポリシーについてはSECURITY.md、リリース手順についてはdocs/release.mdをご覧ください。

ライセンス

Apache-2.0 — Copyright 2026 Nitish Agarwal

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。