LightSpot

@lightspot/mcp

适用于 LightSpot.ai 的 MCP 服务——运行 SEO 和 AI 可见度审计、查看审计结果和专家报告，并从任何 MCP 客户端（Claude Desktop、Claude Code、Cursor，……）导入编辑日历。

它将 LightSpot 公共 API（/v1）封装为 MCP 工具，让 AI 助手只需一步就能“审计这个网站，并告诉我 ChatGPT 为什么不引用它”。

要求

• LightSpot API 密钥（lspai_live_…）——在 LightSpot → Integrations → API keys 中创建。Eclat 和 Zenith 套餐包含 API 访问权限。
• 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 查看单个章节。只读——不会触发分析。
get_editorial_calendar	查看某个网站在 ISO 日期范围内的日历，包括导入的内容排期，以及正在准备、已安排或已发布的内容。
create_editorial_calendar	导入或更新最多 50 个带日期的编辑排期。使用 externalId 实现幂等；不会生成或发布内容。

提示词示例

• “审计 https://example.com，并列出提升 AI 可见度最需要修复的 3 个问题。”
• “列出我的 LightSpot 网站，并告诉我哪个评分最低。”
• “获取审计 <id> 的完整结果，并按严重程度对问题分组。”
• “我的网站 <siteId> 检测到了哪些竞争对手？我应该如何应对？”
• “阅读我的网站 <siteId> 的专家报告，并在我的代码库中修复结构化数据专家提出的问题。”
• “为我的网站 <siteId> 制定为期四周的编辑日历，每周安排两篇 LinkedIn 帖子和一篇教育类 Reddit 帖子，然后将其导入 LightSpot。”
• “显示网站 <siteId> 在 2026-08-01T00:00:00+02:00 至 2026-09-01T00:00:00+02:00 期间计划发布或已经发布的所有内容。”

备注

• 配额（审计次数/月、页面数/次审计）和每个密钥的速率限制均遵循你的 LightSpot 套餐。
• 导入编辑排期不会消耗 AI 积分，也绝不会自动生成、排期或发布内容。
• 完整的 REST API 参考文档请访问 lightspot.ai/docs/api。

许可证

MIT