Lead scanner embed

What it does

The lead scanner is the same free AI Visibility scanner behind wpclienthub.com/ai-visibility-check — 28 AI-readability checks plus a probe of what ChatGPT, Claude and Gemini say about a business — embedded on your own agency site instead of ours. It carries your name and brand color, not WPClientHub's, and every visitor who runs it lands in your own Prospects list, not a list we keep. It is available on the Studio plan and above; Free plans see an upgrade prompt instead of a snippet.

Turn it on

1. Open Settings → Lead scanner and switch Show the scanner on my site on. This is also the moment your embed key is generated — a long random key nobody else knows, tied to your organization alone.
2. Set a headline, subline and button label if you want copy different from the defaults — the live preview on that page shows exactly what a visitor sees, in your brand color.
3. Choose whether the scanner captures the visitor's email before showing the full report (on by default) or runs with no capture at all — a purely informational tool with nothing landing in your Prospects list.
4. Save. The snippet box on that same page now shows your finished embed code.

The snippet

Two lines — a placeholder div the widget renders into, and a script tag carrying your embed key:

<div data-wpch-scanner></div>
<script src="https://wpclienthub.com/embed/v1/scanner.js?key=YOUR_EMBED_KEY" async></script>

The script is self-contained — no jQuery, no framework, nothing else to load — and renders inside its own isolated style boundary, so it can't clash with your site's theme CSS and your theme's CSS can't reach in and restyle it. Paste it once, anywhere on the page; it finds its own placeholder div automatically, even if you later add a second copy of the div elsewhere on the same page.

Adding it to a WordPress site

The snippet is plain HTML and JavaScript, so any of the usual ways of adding a widget to a WordPress page work:

• Block editor: add a Custom HTML block wherever you want the scanner to appear, and paste both lines into it.
• Classic editor / a code-snippets plugin: paste the snippet into a Text/HTML widget, or use a header-and-footer / code-snippets plugin to place it in a template part (a landing page, a sidebar, a footer CTA).
• A page builder (Elementor, Beaver Builder, etc.): use that builder's own "HTML" or "Custom code" element and paste the same two lines.

There is nothing to install on the WordPress site itself — no plugin, no PHP, no database change. The script is fetched fresh from WPClientHub every time the page loads, so turning the scanner off (or changing its headline) in Settings takes effect immediately, with nothing to re-paste on your site.

What a visitor sees

1. A card with your headline, subline and a single URL field.
2. They type their own site's address and click your button label ("Scan my site" by default). A short animated progress bar runs while the free technical crawl happens (typically a few seconds).
3. Results appear in place: a score ring (0–100), four category bars, and the top few findings worth fixing first.
4. If email capture is on, they enter their email to unlock the full report — this is also the moment they become a prospect in your list (see below). If capture is off, the full report link is shown right away with no email step.
5. A link opens the full, branded report page — your logo/name in the header, your findings, and (when your organization has AI credits available) a "what AI assistants actually say about this business" section under the technical score.

Every page the widget touches — the widget card itself and the full report page — carries one quiet, non-configurable line: "Powered by WPClientHub", linking back to our own free scanner. It is small, it is not your brand color, and it cannot be turned off or resized in this round; everything else on both pages is yours.

Where prospects appear

Every visitor who submits their email lands in Settings → Lead scanner → Prospects — their email, the domain they scanned, the score their site got, and the date, with a link straight to their branded report. Use Export CSV to pull the whole list into your own CRM or spreadsheet. These rows are entirely separate from WPClientHub's own marketing contacts — a prospect your embed captures is yours alone, never visible to us in any list, and never used for our own outreach.

Credits, and the "what AI says" section

The free technical crawl (score, category bars, findings) never costs anything, on any plan, for any number of scans. The AI answers section — what ChatGPT, Claude and Gemini actually say when asked about the business, with no prompting from the report itself — is the one part that spends from your organization's own AI credit balance: one ai_health_scan credit per completed scan, the same price a manual AI Health scan costs inside the app.

That credit is charged the moment the technical crawl finishes, and refunded automatically if the AI step then fails to produce anything usable — you are never charged for a run that came back empty. If your organization is out of credits (or over its own daily AI budget) when a scan completes, the AI section is skipped entirely rather than charging anything: the visitor still gets their free technical score and findings, just without the AI-answers section underneath, until your balance has room again. See AI credits for how the balance itself works and how to top it up.

Daily cap

On top of the same per-visitor and whole-site abuse limits the free public scanner already runs under, your embed has its own per-organization daily cap — 50 scans a day by default. Settings → Lead scanner shows "X of 50 used today" once the scanner is on, so you can see at a glance how close a busy day is to the limit. The count resets at midnight UTC. A visitor who hits the cap sees a polite "try again tomorrow" message rather than a broken widget.

Limits & defaults

Troubleshooting