ai-visibility-booster

AI Visibility Booster

A Claude Code plugin for technical AI Visibility audits: crawl public URLs, run 36 basic AI crawler-readiness checks against each selected page, optionally compare against competitors, and generate Markdown/JSON reports — all locally, with no third-party APIs.

AI Visibility = how often a brand surfaces in answers from ChatGPT, Perplexity, Gemini, Google AI, and similar systems. This plugin audits the technical foundation that makes a site eligible to be cited.

What this is

• Local audit pipeline for the 36 BASIC AI Visibility checks that form the practical baseline for crawler-readiness and extractability.
• Claude Code commands for crawl, analyze, compare, report.
• Stable public IDs: every check has an AIVB-NNN identifier (AIVB-001 through AIVB-036).

What this is not

• Not a content rewriting product. Recommendations stay minimal and extractive (TL;DR/key-takeaway blocks, splitting overly long sentences, converting prose lists to bullets, adding visible dates / authors, adding image captions, adding metadata or prompt mappings).
• No guarantees of AI citations, AI Overview placements, or Semrush AI Visibility score increases.
• No CAPTCHA / WAF / authentication bypass.
• No Semrush API dependency in v0.1.x.
• No Web UI in v0.1.x — Claude Code chat is the only interface.

Scope: 36 checks (AIVB-001 through AIVB-036)

The runtime evaluates every selected page against exactly 36 BASIC checks covering:

• HTTP success and clean access
• Sitemap, canonical, internal linking
• Indexability and snippet controls
• Heading hierarchy and topic clarity
• Readability and structured lists/tables
• Freshness, authorship, expertise signals
• Media (alt, captions, og:image, filenames, video)
• JSON-LD type/coverage/rich-result fields
• Mobile/SSR rendering and overlay safety
• Accessibility (labels, ARIA, agent compatibility)
• Hreflang and title/H1/og:title alignment
• Strategic page prompt-coverage

The full table is printed by /aiv-checklist.

Public ID model

• The primary identifier on every check is AIVB-NNN (e.g. AIVB-019).
• All CLI output, reports, and JSON artifacts use the public AIVB-xxx IDs.

Install

This plugin requires Node.js 20 or newer. It has no runtime npm dependencies.

Install from GitHub (recommended)

The repository ships its own .claude-plugin/marketplace.json (the marketplace is named ai-visibility-booster-marketplace, distinct from the plugin name ai-visibility-booster), so Claude Code can install this plugin directly from GitHub — no clone, no npm, no global install step.

In a Claude Code session, run:

/plugin marketplace add medvedikur/ai_visibility_booster
/plugin install ai-visibility-booster@ai-visibility-booster-marketplace
/reload-plugins

The first command registers this repo as a self-hosted marketplace by reading .claude-plugin/marketplace.json from the repo's default branch. The second installs the plugin from that marketplace (the @ai-visibility-booster-marketplace suffix is the marketplace name). /reload-plugins ensures the /aiv-* commands and the namespaced /ai-visibility-booster:aiv-* commands appear immediately.

Verify it loaded:

/plugin
/ai-visibility-booster:aiv-doctor

If the commands do not appear immediately, restart the Claude Code session.

To update later (after a new tag is published):

/plugin marketplace update ai-visibility-booster-marketplace
/plugin install ai-visibility-booster@ai-visibility-booster-marketplace

To remove:

/plugin uninstall ai-visibility-booster
/plugin marketplace remove ai-visibility-booster-marketplace

Install from a local clone

Useful if you want to hack on the plugin itself. /plugin marketplace add expects a .claude-plugin/marketplace.json file at the root of the target, which this repo provides.

1. Clone the repository:

   git clone https://github.com/medvedikur/ai_visibility_booster.git
   cd ai_visibility_booster
   

2. Confirm the CLI works standalone:

   node bin/aiv.mjs checklist
   node bin/aiv.mjs doctor
   

3. Add the local checkout as a marketplace and install:

   /plugin marketplace add /absolute/path/to/ai_visibility_booster
   /plugin install ai-visibility-booster@ai-visibility-booster-marketplace
   /reload-plugins
   

Marketplace install (after acceptance)

If the plugin is accepted into the official Claude Code plugin directory, it can also be installed via Claude Code's plugin browser. The plugin name is ai-visibility-booster. Acceptance into any third-party marketplace is not implied or claimed by this README.

Quick start