LightSpot

@lightspot/mcp

LightSpot.ai 用の MCP サーバーです。任意の MCP クライアント（Claude Desktop、Claude Code、Cursor、…）から、SEO と AI での可視性を監査し、その結果や専門家によるレポートを読み、編集カレンダーをインポートできます。

LightSpot の公開 API（/v1）を MCP ツールとして利用できるようにするため、AI アシスタントが「このサイトを監査して、ChatGPT が引用しない理由を教えて」と一度の操作で依頼できます。

要件

• LightSpot の API キー（lspai_live_…）— LightSpot → Integrations → API keys で作成してください。API アクセスは Eclat プランと Zenith プランに含まれています。
• Node.js ≥ 18（npx で必要に応じて実行するため、グローバルへのインストールは不要です）。

セットアップ

MCP クライアントの設定にサーバーを追加し、API キーを設定します。

{
  "mcpServers": {
    "lightspot": {
      "command": "npx",
      "args": ["-y", "@lightspot/mcp"],
      "env": {
        "LIGHTSPOT_API_KEY": "lspai_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

• Claude Desktop → claude_desktop_config.json
• Claude Code → claude mcp add またはプロジェクトの .mcp.json
• Cursor → ~/.cursor/mcp.json

環境変数

変数	必須	説明
LIGHTSPOT_API_KEY	はい	API キー（lspai_live_…）です。
LIGHTSPOT_BASE_URL	いいえ	API のベース URL を上書きします（デフォルトは https://lightspot.ai）。セルフホスト環境またはテスト専用です。

Claude プラグイン

plugin/ フォルダーには、このサーバーを Claude プラグインとしてパッケージ化したものが含まれています。@lightspot/mcp のバージョンを固定し、API キーを一度だけ入力してシステムの安全な認証情報ストアに保存し、ai-visibility-audit スキルを追加します。詳細は plugin/README.md を参照してください。

ツール

ツール	説明
audit_and_wait	URL を監査し、完了まで待ってから概要（スコア、主な対応事項、主な問題）を返します。「これを監査して、問題点を教えて」という一度の操作に使います。
run_audit	完了を待たずに監査を開始します（監査 ID を返します）。
get_audit_status	監査の簡易ステータス（PENDING／RUNNING／DONE／FAILED と進捗 0～1）を返します。
get_audit	監査結果を返します。デフォルトでは要約を簡略化して返し、full: true を指定すると全データを返します。
list_sites	チーム内のサイトを一覧表示します（各サイトの最新スコアを含みます）。
get_site	サイトのメタデータと最近の監査結果を返します。
list_site_audits	サイトのページ分割された監査履歴を返します。
get_competitors	サイトの最新の競合分析（検出された競合、ティア、引用、推奨事項）を取得します。読み取り専用です。新しい分析は開始しません。Zenith プランが必要です。
get_expert_report	サイトまたは指定した監査について、8 人の専門家（テクニカル SEO、コンテンツ、AI での可視性、構造化データ、サイトマップ、パフォーマンス、ビジュアル、ブランドオーソリティ）による最新レポートを読み取ります。優先順位付きの調査結果、手順付きの推奨アクション、制限事項、すぐに適用できる成果物を含みます。デフォルトでは要約を返し、full: true ですべてを返します。expert を指定すると、1 つの章を読み取れます。読み取り専用です。分析は開始しません。
get_editorial_calendar	ISO 日付範囲を指定してサイトのカレンダーを読み取ります。インポート済みの枠と、準備中、予定済み、または公開済みのコンテンツが含まれます。
create_editorial_calendar	日付付きの編集枠を最大 50 件インポートまたは更新します。externalId を使った場合は冪等です。コンテンツの生成や公開は行いません。

プロンプトの例

• 「https://example.com を監査して、AI での可視性を高めるために修正すべき上位 3 項目を教えてください。」
• 「LightSpot のサイトを一覧表示して、最もスコアが低いサイトを教えてください。」
• 「監査 <id> の全結果を取得して、問題を深刻度別に分類してください。」
• 「サイト <siteId> で検出された競合は何ですか？また、それらに対して何をすべきですか？」
• 「サイト <siteId> の専門家レポートを読み、構造化データの専門家が推奨する内容をコードベースに反映してください。」
• 「サイト <siteId> 用に 4 週間分の編集カレンダーを作成してください。週に LinkedIn の投稿を 2 件、教育的な Reddit の投稿を 1 件ずつ含め、LightSpot にインポートしてください。」
• 「2026-08-01T00:00:00+02:00 から 2026-09-01T00:00:00+02:00 までの間に、サイト <siteId> で予定または公開されているものをすべて表示してください。」

注意事項

• クォータ（月あたりの監査回数、監査あたりのページ数）とキーごとのレート制限は、ご利用の LightSpot プランに従います。
• 編集枠をインポートしても AI クレジットは消費されず、コンテンツが自動的に生成、スケジュール設定、公開されることもありません。
• REST API の完全なリファレンスは lightspot.ai/docs/api にあります。

ライセンス

MIT