Skip to main content
Answer engines read clean, structured content more easily than a full HTML page. For each of your pages, Bluemoon prepares an optimized version (also called an artifact): the same content, organized so an answer engine can read and cite it. Verified AI crawlers receive it instead of your HTML page once your serve mode is default.

​
What an optimized page contains

Answer-first markdown

Your page’s content in plain markdown, with the most direct answer at the top, followed by your page’s sections.

Structured data

Article JSON-LD, plus FAQPage JSON-LD when your page has question-and-answer sections.
The drop-ins serve the markdown to verified crawlers.
The optimized version carries the same substance as your page, nothing more. Every claim comes from your page. If Bluemoon can’t build a version that sticks to your page, the page is marked Error and crawlers get your normal page.

​
How it is built

Bluemoon builds optimized pages in the background, from the published version of your pages. When a verified crawler visits, your install fetches a version that is already built. Nothing is generated while the crawler waits. Pages with too little text are marked Error and get no optimized version: crawlers get your normal page.

​
Reading the status

In Agent Analytics, See all pages opens the list of your pages. The Your pages tab lists the pages found in your site’s sitemap, each with a status: A page that is not Optimized is simply passed through: the crawler gets your normal page, and no error is shown to anyone. Generate missing builds every page that is not generated yet or stale. Each Optimized page also shows a citability score.

​
Checking what a crawler received

When your install serves the optimized version, the response carries these headers: The Next.js middleware, the Cloudflare Worker and the WordPress plugin also send cache-control: no-store. In Agent Analytics, the visit shows as Optimized served in Recent activity. In shadow mode, nothing is served and every visit shows as Passthrough. See Serve modes.

​
Regenerating after you update a page

When you change a page’s content, rebuild its optimized version so crawlers get the new content and the score reflects it.
1

Open Agent Analytics

In the Bluemoon app, go to Agent Analytics and select the domain.
2

Find the page

Open See all pages → Your pages. Each page shows its status and citability score. Open the page you changed.
3

Regenerate

Click Regenerate. Bluemoon rebuilds it from the current version of your page, and the status returns to Optimized once it’s done.
If the updated page no longer yields a usable version, it is marked Error and crawlers get your normal page until you fix the page and regenerate.

Serve modes

Control when the optimized version is served.

Agent Analytics

See what was served, and how often served pages are cited.