LightSpot
Audit a website for SEO and AI search visibility (ChatGPT, Perplexity, Gemini) and read the fixes.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@lightspot/mcpclaude mcp add lightspot -e 'LIGHTSPOT_API_KEY=<your lightspot_api_key>' -e 'LIGHTSPOT_BASE_URL=<LIGHTSPOT_BASE_URL>' -- npx -y @lightspot/mcp@0.6.0{
"mcpServers": {
"lightspot": {
"command": "npx",
"args": [
"-y",
"@lightspot/mcp@0.6.0"
],
"env": {
"LIGHTSPOT_API_KEY": "<your lightspot_api_key>",
"LIGHTSPOT_BASE_URL": "<LIGHTSPOT_BASE_URL>"
}
}
}
}Variables d'environnement
LIGHTSPOT_API_KEYobligatoire secret LightSpot API key (lspai_live_…), created in the LightSpot appLIGHTSPOT_BASE_URLOptional API base URL, defaults to https://lightspot.ai
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
@lightspot/mcp
MCP server for LightSpot.ai — run SEO and AI-visibility 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 Eclat and Zenith plans. - 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:
{
"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 addor your project's.mcp.json - Cursor →
~/.cursor/mcp.json
Environment variables
| Variable | Required | Description |
|---|---|---|
LIGHTSPOT_API_KEY | yes | Your API key (lspai_live_…). |
LIGHTSPOT_BASE_URL | no | Override the API base URL (defaults to https://lightspot.ai). For self-hosted/testing only. |
Claude plugin
The plugin/ folder packages this server as a Claude plugin: it pins @lightspot/mcp, asks for your API key once and stores it in your system's secure credential store, and adds an ai-visibility-audit skill. See plugin/README.md.
Tools
| Tool | What it does |
|---|---|
audit_and_wait | Run 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_audit | Start an audit without waiting (returns the audit id). |
get_audit_status | Lightweight status of an audit (PENDING/RUNNING/DONE/FAILED + progress 0–1). |
get_audit | Audit results — a trimmed summary by default, or the full payload with full: true. |
list_sites | List the sites in your team (with their latest score). |
get_site | A site's metadata and recent audits. |
list_site_audits | A site's paginated audit history. |
get_competitors | Get a site's latest competitor analysis (detected competitors, tiers, citations, recommendations). Read-only — does not trigger a new analysis. Requires the Zenith plan. |
get_expert_report | Read the latest report from our 8 experts (technical SEO, content, AI visibility, 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_calendar | Read a site's calendar over an ISO date range, including imported slots and content already preparing, scheduled, or published. |
create_editorial_calendar | Import 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
Questions fréquentes
Qu'est-ce que LightSpot ?
Audit a website for SEO and AI search visibility (ChatGPT, Perplexity, Gemini) and read the fixes.
Comment installer LightSpot ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add lightspot -e 'LIGHTSPOT_API_KEY=<your lightspot_api_key>' -e 'LIGHTSPOT_BASE_URL=<LIGHTSPOT_BASE_URL>' -- npx -y @lightspot/mcp@0.6.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour LightSpot ?
Oui. Il attend LIGHTSPOT_API_KEY, à renseigner dans sa configuration.
LightSpot est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient LightSpot ?
Il est publié par nmarijane. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.