Reference

Generated fixes

The three artifacts generate_ai_readiness_fixes produces and their guardrails.

generateFix(url) (lib.js#L125-L163) fetches the live page and pre-fills three starter artifacts from the site's real title and description:

  1. Organization JSON-LD: @type: Organization with name, url, description, and a logo placeholder. The name is derived from the first segment of the page title, capped at 60 chars.
  2. FAQPage JSON-LD: three starter questions (what the business does, the service area, how to contact). The first answer is pre-filled from the real meta description; the other two carry explicit REPLACE placeholders so a human fills in facts the page does not state.
  3. robots.txt: a template that allows all traffic, then explicitly welcomes each of the seven tracked AI crawlers, and declares the sitemap URL.

Guardrails worth knowing:

  • The description used in JSON-LD falls back to a generated one-liner when the page's meta description is shorter than 40 chars, and is capped at 300 chars.
  • Placeholders are loud by design: answers a machine cannot know say REPLACE rather than inventing facts.
  • The same SSRF guard as the checker applies: private and loopback hosts are rejected before any fetch (lib.js#L18-L38).
Built withSourcey