LightSpot

io.github.nmarijanev0.5.0更新於 Oct 3, 2026

Audit a website for SEO and AI search visibility (ChatGPT, Perplexity, Gemini) and read the fixes.

概覽

AI 產生的概覽

讓助理對網站進行 SEO 與 AI 搜尋可見性稽核,讀取結果與專家報告,並匯入編輯行事曆。

功能
將 LightSpot 公開 API 包裝成 MCP 工具。它可以對某個網址啟動稽核並等待回傳分數、主要行動與主要問題的摘要,也能以非同步方式執行並輪詢狀態與結果。它還能列出團隊網站及其稽核歷史、讀取競爭對手分析與八位專家的最新報告,以及讀取或匯入帶日期的編輯行事曆檔期。
適用情境
適合需要讓助理查明網站為何被或未被 AI 搜尋引擎引用、把依優先順序排列的 SEO 與 GEO 修正建議帶入程式碼或內容流程,或在規劃工具與 LightSpot 之間搬移編輯行事曆的情境。
執行需求
透過 npx 在本機執行,需要 Node.js 18 或更新版本。需要 LightSpot API 金鑰(lspai_live_...),以環境變數 LIGHTSPOT_API_KEY 設定;API 存取包含在 Zenith 方案中。選用的環境變數 LIGHTSPOT_BASE_URL 可覆寫預設 API 基礎網址。需要能連線至 LightSpot API 的網路。
安裝前請注意
LIGHTSPOT_API_KEY 密鑰會寫入用戶端設定,可存取你團隊的 LightSpot 資料。create_editorial_calendar 工具會在你的帳戶中寫入或更新最多 50 個帶日期的檔期,但不會產生、排程或發布內容。稽核會消耗方案配額,並受每個金鑰的速率限制約束。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 LightSpot,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@lightspot/mcp

MCP server for LightSpot.ai — run SEO & GEO audits, read their results and our experts' reports, and import editorial calendars from any MCP client (Claude Desktop, Claude Code, Cursor, …).

It wraps the LightSpot public API (/v1) as MCP tools, so an AI assistant can "audit this site and tell me why ChatGPT doesn't cite it" in one step.

Requirements

  • A LightSpot API key (lspai_live_…) — create one in LightSpot → Integrations → API keys. API access is included in the Zenith plan.
  • Node.js ≥ 18 (run on demand via npx, nothing to install globally).

Setup

Add the server to your MCP client config and set your API key:

json
{  "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 or your project's .mcp.json
  • Cursor → ~/.cursor/mcp.json

Environment variables

VariableRequiredDescription
LIGHTSPOT_API_KEYyesYour API key (lspai_live_…).
LIGHTSPOT_BASE_URLnoOverride the API base URL (defaults to https://lightspot.ai). For self-hosted/testing only.

Tools

ToolWhat it does
audit_and_waitRun an audit on a URL, wait for it to finish, and return a summary (score, top actions, main issues). The one-shot "audit this and tell me what's wrong."
run_auditStart an audit without waiting (returns the audit id).
get_audit_statusLightweight status of an audit (PENDING/RUNNING/DONE/FAILED + progress 0–1).
get_auditAudit results — a trimmed summary by default, or the full payload with full: true.
list_sitesList the sites in your team (with their latest score).
get_siteA site's metadata and recent audits.
list_site_auditsA site's paginated audit history.
get_competitorsGet a site's latest competitor analysis (detected competitors, tiers, citations, recommendations). Read-only — does not trigger a new analysis.
get_expert_reportRead the latest report from our 8 experts (technical SEO, content, GEO, structured data, sitemaps, performance, visual, brand authority) for a site or a given audit: prioritized findings, recommended actions with steps, limitations and ready-to-apply artifacts. Summary by default, full: true for everything, expert to read one chapter. Read-only — does not trigger an analysis.
get_editorial_calendarRead a site's calendar over an ISO date range, including imported slots and content already preparing, scheduled, or published.
create_editorial_calendarImport or update up to 50 dated editorial slots. Idempotent with externalId; it does not generate or publish content.

Example prompts

  • "Audit https://example.com and give me the top 3 things to fix for AI visibility."
  • "List my LightSpot sites and which one has the lowest score."
  • "Get the full results for audit <id> and group the issues by severity."
  • "What competitors were detected for my site <siteId>, and what should I do about them?"
  • "Read the experts' report for my site <siteId> and fix what the structured-data expert recommends in my codebase."
  • "Create a four-week editorial calendar for my site <siteId> with two LinkedIn posts and one educational Reddit post per week, then import it into LightSpot."
  • "Show me everything planned or published for site <siteId> between 2026-08-01T00:00:00+02:00 and 2026-09-01T00:00:00+02:00."

Notes

  • Quotas (audits/month, pages/audit) and per-key rate limits follow your LightSpot plan.
  • Importing editorial slots does not consume AI credits and never generates, schedules, or publishes content automatically.
  • The full REST API reference lives at lightspot.ai/docs/api.

License

MIT

來源:README.md,提交 98536cb

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.5.0最新Oct 3, 2026