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.

已验证STDIO仅桌面Web Search & ScrapingData & AnalyticsProductivity & Workflow

概览

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