lumar-analytics

Lumar plugins for Claude Code, Cursor, and Codex

Lumar analytics as a plugin for Claude Code, Cursor, and OpenAI Codex. Covers both AI Visibility (audit, competitor benchmark, topic bootstrap, prompt investigation, trend) and Lumar Analyze (crawl health, report deep-dive, URL investigation, export, task review). Backed by the unified Lumar MCP server at https://mcp.lumar.io/mcp.

The same skills/ tree is shared across all three hosts — each host reads its own manifest (.claude-plugin/, .cursor-plugin/, or .codex-plugin/) and points at the same skill files.

Plugins

Plugin	Description
lumar-analytics	Lumar analytics skills — AI Visibility and Lumar Analyze; Content Relevance to follow

Quickstart — Claude Code

Option A: Install from Marketplace (recommended)

1. Add the marketplace inside Claude Code:

   /plugin marketplace add deepcrawl/lumar-plugins
   

2. Install the plugin — run /plugin, open the Marketplaces section, select lumar-plugins, and install lumar-analytics.

3. Authenticate the Lumar MCP server — run /mcp inside Claude Code and follow the browser auth flow. The plugin wires up https://mcp.lumar.io/mcp; on first connect you'll be sent to log in with your Lumar account.

4. Use a skill — skills auto-trigger from natural language. Just describe what you want.

   AI Visibility

   • "Audit AI Visibility for <brand>" → ai-visibility-audit
   • "How does <brand> compare to its competitors in AI search?" → competitor-benchmark
   • "Set up AI Visibility tracking for <brand>" → topic-bootstrap
   • "Why did prompt <id> score low? What did ChatGPT actually say?" → prompt-investigation
   • "Why did our visibility drop last week? Trend the score over 90 days" → visibility-trend

   Lumar Analyze

   • "How is my last crawl doing? Show me the top issues" → analyze-crawl-health
   • "Drill into duplicate pages — filter by status 200 and create a task" → analyze-report-deep-dive
   • "What's wrong with <url>? Show me the resource detail" → analyze-url-investigation
   • "Export the broken links report as CSV" → analyze-export
   • "What SEO tasks are open and what's overdue?" → analyze-task-review

Option B: Install from a local clone

git clone https://github.com/deepcrawl/lumar-plugins.git

Then inside Claude Code:

/plugin marketplace add /path/to/lumar-plugins

and install lumar-analytics from the Marketplaces view. Run /mcp to authenticate.

Quickstart — Cursor

Cursor reads .cursor-plugin/marketplace.json at the repo root and the per-plugin manifest at plugins/lumar-analytics/.cursor-plugin/plugin.json.

1. Add the plugin marketplace in Cursor — open the Cursor plugin manager and add deepcrawl/lumar-plugins as a marketplace source (or point Cursor at a local clone of this repo).

2. Install lumar-analytics from the marketplace listing.

3. Authenticate the Lumar MCP server — open Cursor's MCP settings, find the lumar server provisioned by the plugin, and complete the OAuth flow in your browser.

4. Use a skill — same natural-language triggers as Claude Code (see the prompt examples above and the skills table below).

Quickstart — Codex

Codex reads .agents/plugins/marketplace.json at the repo root and the per-plugin manifest at plugins/lumar-analytics/.codex-plugin/plugin.json.

1. Add the marketplace from your shell:

   codex plugin marketplace add deepcrawl/lumar-plugins
   

   (Or point at a local clone: codex plugin marketplace add /path/to/lumar-plugins.)

2. Install lumar-analytics — inside Codex CLI run /plugins, open the marketplace, and install.

3. Authenticate the Lumar MCP server — Codex will prompt on first install (ON_INSTALL policy) and run the browser OAuth flow against https://mcp.lumar.io/mcp.

4. Use a skill — same natural-language triggers as Claude Code and Cursor.

Skills