LightSite technical documentation: infrastructure, analytics and execution for AI search.

Short answer: LightSite is infrastructure and analytics for the AI-driven web, plus an execution agent. It serves AI bots a structured, queryable version of your website alongside your normal site, measures bot reads, agent actions, AI mentions and AI-referred visitors server-side, and turns those signals into approved content, structured-data fixes and outreach.

1. What LightSite Is

AI assistants are now a front door to every brand. ChatGPT, Gemini, Claude, Perplexity, Copilot, Meta AI and Google's AI experiences read websites, answer questions about them and send customers to them. Most websites were built for human eyes and search engines from ten years ago. They are heavy, script-driven and hard for a machine to understand with confidence.

LightSite fixes that from three directions at once:

The rest of this document explains each part feature by feature: what you see, what happens underneath, and why it matters.

How the pieces connect

2. The AI-Ready Website in Minutes: The Parallel Layer

2.1 The idea: infrastructure, not just rendering

Many tools "render" a page for bots: they take your HTML, execute the JavaScript and hand the bot a flattened copy. That is a copy of the same page, with the same clutter.

LightSite builds something different: a parallel layer of your website designed for machines. It looks like a sitemap from the outside — that is how bots discover it — but behind it is a live, queryable interface, much like an MCP connection for AI agents. A bot can:

The result: AI systems get the facts in a format they are built to consume, in roughly half the data of a full web page.

2.2 What the layer contains

| Component | What it is | Why it matters |

| Mirrored pages | Each page on your site is read, cleaned and rebuilt as a structured page with rich JSON-LD (Organization, WebPage, Article, FAQPage, Service, Product) | Machines get unambiguous facts: who you are, what you sell, who wrote it, when |

| AI sitemaps | Dedicated sitemaps listing the structured pages, URL-encoded so Japanese, Chinese and Korean addresses work cleanly | Bots discover the layer through the standard they already follow |

| AI catalog | A machine-readable index of the brand's offerings, pages and endpoints with absolute URLs | One request tells an agent everything available |

| OpenAPI contract | A formal description of every callable endpoint | Agents and developers can integrate without guesswork |

| Skills manifest | Named capabilities an agent can call: search Q&A, look up products, fetch FAQs, read proof points | Turns the website into something an agent can use , not just read |

| Q&A search ( qa.search ) | A question-and-answer endpoint built from the site's own content | AI asks a question, gets the brand's official answer |

| Status endpoint | Plain JSON health and freshness information | Agents and LightSite itself can verify the layer is live |

All machine endpoints serve plain application/json with absolute URLs, which is exactly what browsing assistants handle best.

2.3 How pages are read: the Page Checker engine

Every page in the layer is produced by the same reader that powers LightSite's page pipeline. It extracts what a machine actually needs:

The reader also identifies pages that are unreadable to machines — blocked, timing out, too large, or JavaScript-only shells — so LightSite knows exactly which pages a bot cannot see on the original site.

2.4 Sync: always fresh

The automatic sitemap sync walks your site's sitemaps (including sitemap index files), discovers new and changed pages and rebuilds their structured versions. The Page Sync panel in the app shows what is synced, what is pending and how fresh each page is. Deterministic page IDs mean a page keeps the same address in the layer across syncs, so bots never chase moving targets.

2.5 Deploying in minutes

LightSite connects to the site you already have. No CMS migration, no rebuild, no new hosting. The app generates copy-paste-ready instructions for the platform you run:

| Platform | How it connects |

| WordPress | LightSite plugin: redirects/proxy rules, tracking and discovery aliases in one place, survives theme updates |

| Cloudflare | A Worker rule at the edge |

| Nginx / Magento | Server rules, including edge reverse-proxy setups |

| Shopify | Native integration: theme, robots.txt and routing |

| Any site | robots.txt sitemap line, discovery redirects and the tracking snippet |

The One-Click Integration screen produces the exact code for your site, and the Page Routing Coverage view shows which rules are live.

LightSite prefers 200 proxy rewrites over 301 redirects for discovery endpoints: the bot gets the content directly at your address, with no extra hop.

2.6 Channeling the bots: edge page routing

For sites that want the strongest setup, LightSite routes AI bots straight to the structured version of a page at the edge, while humans continue to the normal site:

This gives three guarantees by design:

2.7 Why a parallel layer beats a rebuild or a CDN swap

2.8 Zero effect on your regular SEO

The parallel layer is built for AI bots only. It does not replace, compete with or change the website that Google and Bing rank.

Why it cannot affect your rankings

How it works, step by step

What this means for your SEO team: your rankings, traffic, Search Console data and existing SEO work carry on exactly as before. LightSite adds a separate channel for AI assistants on top. You can verify it yourself: request any page as Googlebot and you get your own site; check the LightSite layer and you will see the noindex, nofollow directive.

3. AI Analytics: Measuring What AI Actually Does

LightSite measures AI activity server-side and first-party . Every request a bot makes to the parallel layer is logged by LightSite's own servers. Every human visit referred by an AI assistant is recorded by the tracking snippet on your site. No sampling of third-party panels, no modelled estimates.

3.1 The data foundation

| Data | What it records |

| Bot interactions | Every AI bot request: platform, bot variant, bot category, path, endpoint and skill called, HTTP status, response size in bytes, content type, timestamp |

| AI-referred visits | Every human session arriving from an AI surface: landing page, referrer, first and last AI source, number of AI touches, journey, engagement class (bounce / engaged / converted), conversions |

| Canary signals | Unique trap links planted in the layer, used to prove which agents follow through from reading to acting |

| Visibility scans | What AI assistants answer to real buyer questions about your category |

| Brand mentions | Where your brand appears across the web, with authority, link status and sentiment |

| Search Console | Your uploaded organic search data, for correlation with AI activity |

Source canonicalization

AI vendors use many domains and parameters ( chatgpt.com , chat.openai.com , Gemini grounding redirects and more). LightSite runs every source through one canonicalization table at write time and read time, so each assistant shows up as one clean bucket — ChatGPT, Gemini, Claude, Perplexity, Copilot and others — instead of splitting across a dozen raw strings.

3.2 Bot traffic dashboard

What you see:

How it is measured: directly from the logged bot interactions, aggregated in the database by platform, path and day.

3.3 Extraction depth: how much each AI takes

LightSite records the exact size of every response sent to an AI bot. That turns into a metric no page-tag tool can see: extraction depth.

For marketers, extraction depth answers a simple question: is AI taking just a headline, or is it taking the full story — pricing, proof points and FAQs?

3.4 Crawler behavior signals

Beyond volume, LightSite classifies how bots retrieve:

This reveals intent. When targeted calls on a topic spike, AI systems are actively trying to answer that question about you.

3.5 Skills adoption: measuring what agents use

Every endpoint in the layer carries an endpoint key and group, so LightSite can measure usage per skill :

The Skills Adoption and AI Product Requests views show which capabilities agents adopt — for example, how often qa.search is called and which questions it answers. This is the difference between "a bot visited" and "an agent used our official answer to do its job."

3.6 Agent Activity: when bots act like users

AI is shifting from crawling to acting. ChatGPT agent mode, user-triggered assistants and browser agents visit pages on behalf of a person. LightSite's Agent Activity widget records these sessions on your live site through the tracking snippet:

Canary links add a second proof: when an agent follows a unique planted link, LightSite knows that specific agent moved from reading to acting.

3.7 Signed bot identity

LightSite's own verification bot signs its requests using Web Bot Auth (HTTP Message Signatures with an Ed25519 key). Its public key is published in a signature directory, so networks such as Cloudflare can cryptographically verify that a LightSite check is genuine. LightSite's site checks are therefore recognized and trusted rather than blocked as unknown traffic.

3.8 Human visitors from AI and conversions

This is where AI search meets revenue. The tracking snippet records every human visit that arrives from an AI assistant:

The agent's home screen shows a live status strip: AI visits, mentions, conversion rate and last scan, each with its monthly delta.

3.9 Top pages by AI performance

A page-by-page view combining bot reads by engine, extraction, AI-referred visitors and conversions, compared with the previous period. Marketers see which pages AI reads, which pages AI sends people to, and which pages turn those visitors into customers.

3.10 Health KPI cards

Four live cards summarize how AI interacts with the site: crawl coverage, structured-layer adoption, agent follow-through and sync freshness. A trust-signal widget and signals rail surface anything that needs attention.

3.11 Search Console correlation

Upload a Search Console Performance export and LightSite ingests up to 100,000 queries, in any language, with a lock that prevents overlapping uploads. The agent then correlates organic demand with AI activity:

A badge in the agent shows how many days old the upload is: green while fresh, red after 30 days.

4. Measure What Matters on Every AI

4.1 AI visibility scans

LightSite asks the AI assistants your customers use the questions your customers ask, and records what they answer. Scans cover ChatGPT, Perplexity, Gemini, Claude and Google's AI Mode / AI Overviews.

Each scan records, per question and per assistant:

Query DNA and location awareness

Questions are generated from your business profile across intent layers — discovery, comparison, problem-solving and branded — and run with the country and language of your site, so a Japanese brand is tested the way Japanese customers ask.

Two scan modes

The owner sets the preferred mode once and it applies everywhere: dashboard, agent and scheduled scans. Mixed-mode comparisons are flagged so trends are always like-for-like.

Branded ratio

Owners control what share of questions mention the brand (25% by default). This keeps mention rates honest and comparable over time.

Sentiment guard

AI sentiment labels are checked against the actual answer text. A "positive" label needs real praise in the answer; a "neutral" label is upgraded to "negative" or "mixed" when the answer contains clear criticism. Marketers get sentiment they can act on.

Reliable scoring

Mention rate is computed against the questions that were actually scored. Timeouts or service errors are excluded rather than counted as misses, and partial scans are detected and labelled.

4.2 Position intelligence

LightSite turns scans into strategy:

4.3 Keywords, sources and citation intelligence

Every scan records the sources AI answers draw from. LightSite classifies those domains and shows:

This gives marketers the map of which pages and which publications move AI answers, keyword by keyword and topic by topic.

4.4 Brand mentions and authority

LightSite scans the web for your brand weekly and on demand:

4.5 What consumers ignore, and what marketers should do about it

The combination of layers shows the gaps that matter:

| Signal | What it tells a marketer |

| Bots read a page heavily, but AI sends no visitors to it | The content is consumed but not compelling enough to recommend — strengthen proof and answers |

| AI sends visitors who bounce | The landing page does not match the question that brought them — rework the page |

| Search demand with no AI visibility | A topic customers want and AI does not associate with you — publish for it |

| Competitors appear in answers you are missing from | A displacement opportunity — target the sources that shape those answers |

| Mentions without links | Low-effort authority wins — outreach |

| Bots hitting dead URLs | Lost reads — fix redirects |

4.6 Why this is good for marketers

5. The LightSite AI Agent

5.1 What it is

The LightSite AI agent is an analyst and operator that lives inside the app and works on your data. You talk to it in plain language — in English, Japanese and more — and it answers from your real numbers, prepares work and executes it after your approval. Every week it also works on its own, watching for changes and preparing a plan.

5.2 How a conversation works

Before running a scan, the agent asks which assistant to scan with. Saved-data questions are answered from saved data without triggering new runs.

5.3 The autonomous loop: detectors, signals, brain, plan

data -> DETECTORS -> SIGNALS -> BRAIN -> WEEKLY PLAN -> PROPOSALS -> APPROVAL -> EXECUTORS -> OUTCOMES Detectors are pure functions that scan your data and emit signals, with no side effects:

Scoring. Each signal is scored on business importance, demand, AI visibility gap, fixability and confidence. Signals confirmed by several data sources rank higher than single-source ones. Critical technical blockers (for example a page that serves bots a thin response) always rise to the top.

The brain ranks signals into a weekly plan of moves, each with a reason and a target page, and routes every move to the right kind of work:

Proposals. Each executable move becomes a proposal card in chat. You approve, dismiss or let it expire after seven days.

5.4 Executors: how tasks run end to end

| Executor | What it does end to end |

| Draft brief | Builds a content brief from your real scan, bot and Search Console evidence, suggesting answer formats that are proven to earn AI-referred visits |

| Publish article | Writes a full article in your brand voice for your ICP, with the strategic reasoning saved alongside it |

| Update JSON-LD | Reads the target page, picks the right schema type, builds the structured data from the page's own facts and returns a ready-to-apply draft |

| Run outreach | Discovers placements, qualifies them against your business profile, finds contacts, writes personalized emails and prepares the campaign for approval |

| Refresh scan | Re-runs a visibility scan to confirm whether a change moved the needle |

Each action type has one dedicated worker, and the agent only ever describes a move the way that worker can actually perform it.

5.5 Content creation

The content agent creates articles, briefs, FAQs, comparison pieces, social and community posts in multiple formats, grounded in your Search Console queries, scans and bot questions. It writes in your brand voice for your ideal customer, avoids generic filler, and keeps the data-driven reasoning for every piece. "Create high-impact content" turns the top gaps into ready drafts, with email delivery status reported exactly as it happened.

5.6 Outreach campaigns

Outreach puts your brand on the pages that shape AI answers:

5.7 Weekly rhythm: digests, email and Slack

Every autonomous email goes through a shared daily guard: one message per workspace per day, keyed by message identity, so customers are never flooded or double-sent. Opt-outs are always respected.

5.8 Learning from outcomes

The agent learns only from work that verifiably went live. An action counts once there is recorded evidence it was applied or sent — a receipt or a live page read — and only after the full outcome window from that moment. Opened or copied drafts are treated as preferences, not results. This keeps recommendations tied to what actually works.

6. LightSite in ChatGPT and Claude: The MCP Connector

Customers can connect LightSite directly to ChatGPT or Claude through LightSite's MCP connector at https://mcp.lightsite.ai/ .

Benchmarks come from anonymous aggregates with a minimum cohort of eight customers, so no names, domains or content ever cross accounts.

7. Reports and Exports

| Report | Contents |

| AI SEO report | Executive view with a performance score, AI visits, conversions, bot reads, visibility and prioritized plays |

| Monthly report | Month-in-review by email and Slack, protected against duplicates at the database level |

| Knowledge graph export | Your brand's entities, offerings and relationships in a portable file for your agency or dev team |

| CSV exports | Bot traffic, AI referrals, scans and mentions for your own analysis |

Reports are delivered in the workspace's language, including full Japanese support.

8. Built for the Enterprise

9. Built for Security

9.1 Humans never touch the layer

Edge routing only serves the parallel layer to recognized AI bots on public, cookie-free, unauthenticated requests. Logged-in users, carts, accounts and private paths always go to your own site, and any failure falls back to your own page.

9.2 Data isolation

9.3 Privacy by design

9.4 Authentication and access

9.5 Verified identity for LightSite's own bot

LightSite's checks are signed with Web Bot Auth (Ed25519 HTTP Message Signatures), with a public key directory, so security networks can verify them cryptographically.

9.6 Safe automation

10. End-to-End: A Week with LightSite

11. Summary

| LightSite |

| Infrastructure | A parallel, structured, queryable layer for AI — pages, catalog, skills, Q&A, AI sitemaps — live in minutes on any stack |

| Channeling | Edge routing that gives AI bots the structured page and humans the real site, with automatic fallback and a centrally updated bot list |

| Measurement | Server-side bot reads, extraction depth, skills adoption, agent activity, visibility on every major AI, mentions, AI-referred visitors and conversions |

| Execution | An AI agent that detects, plans, drafts, fixes structured data, runs outreach and refreshes scans — with your approval |

| Enterprise | Multi-site, multi-language, governed, role-based, connectable to ChatGPT and Claude |

| Security | Row-level isolation, hashed IPs, MFA, OAuth 2.1, signed bot identity, fail-safe routing |

LightSite gives AI a working connection to your official answers — and gives marketers the measurement and execution to win in AI search.

Frequently asked questions

What is LightSite?

LightSite is infrastructure and analytics for the AI-driven web, plus an AI agent that executes SEO and AEO work with your approval.

How does LightSite make a website AI-ready without a rebuild?

It builds a parallel, structured layer of your site — clean pages, JSON-LD, an AI sitemap, a catalog and callable skills — that AI bots can read while humans keep seeing your normal site.

Do human visitors ever see the LightSite layer?

No. Edge routing only serves it to recognized AI bots on public, cookie-free requests, and any failure falls back to your own page.

Does LightSite affect my regular SEO or Google rankings?

No. Google and Bing are never routed to the layer, and every layer page is noindex, nofollow for them, so it has zero effect on your rankings, URLs or existing SEO.

What does LightSite measure?

Server-side bot reads, extraction depth, skills calls, agent actions, brand mentions in sampled AI answers, AI-referred human visits and conversions.

Which AI assistants does LightSite cover?

ChatGPT, Gemini, Claude, Perplexity, Copilot, Meta AI and Google's AI experiences, each with its own crawlers.

Does the agent act without approval?

No. Every executable task — content, structured-data fixes, outreach — is proposed as a card and runs only after your team approves it.

Can I use LightSite inside ChatGPT or Claude?

Yes. The LightSite MCP connector lets your team query its AI search data from ChatGPT or Claude under their own permissions.

Related reading

Start free with LightSite