Geordy, in plain English

Geordy takes a page from your site and produces extra machine-readable versions of it — so AI systems can understand what the page means without guessing.

Your site looks the same to visitors. You're just adding a clean, structured layer for machines.

What you get (the practical output)

Not advice. Not a report. You get files you can actually use:

Markdown (.md)A clean page version for AI
Schema JSONStructured "meaning" data
llms.txtClear site rules for LLMs
YAMLLightweight structured data
OG.jsonOpen Graph metadata as JSON
RSS (.xml)Feed format for updates
manifest.jsonApp manifest metadata
humans.txtHuman-readable credits file

Full format reference

The shortest path to value

10-15 minutes. One page. One win.

  1. 1. Pick one page

    Choose your homepage, a top landing page, pricing, or your best product/category page. Drop that URL into Geordy and generate the formats.

    Why: You want one clean win before scaling.

  2. 2. Enable the right formats

    Start with Schema JSON, Markdown, and llms.txt (homepage only). Add OG.json, YAML, RSS, manifest, and humans.txt when ready.

    Rule: Enable what you'll actually deploy.

  3. 3. Put files somewhere accessible

    You have two options — either works:

    Option A — use Geordy's URL (no DNS setup needed)

    Your files are already live at Geordy's address the moment they're generated. You can reference them directly: files.geordy.ai/yourdomain.com/llms.txt. No configuration required. Good for getting started quickly, or for sites where adding a subdomain isn't practical.

    Option B — your own subdomain (recommended)

    Pick a subdomain (e.g. ai.yourdomain.com). Add one DNS A record pointing to:

    178.156.151.211

    This keeps files under your own domain, which is better for brand trust and SEO signals.

  4. 4. Verify it works

    Open ai.yourdomain.com/llms.txt in your browser. If it loads, you're done.

  5. 5. Add reference tags

    On each original page, add <link rel="alternate"> tags in the <head> pointing to the matching files on your subdomain.

    Files that exist but aren't referenced are like a great book left in a drawer.

Detailed setup walkthrough

How URLs map

Two files live only on the homepage: /llms.txt and /humans.txt. Everything else mirrors your site paths.

Homepage

/index.md
/index.schema.json
/index.yaml
/index.og.json
/index.xml
/index.manifest.json

Inner page: /about/team

/about/team.md
/about/team.schema.json
/about/team.yaml
/about/team.og.json
/about/team.xml
/about/team.manifest.json

Scaling up

  1. Do the Top 5 rollout. Homepage, pricing, top category, top product, about/credibility page. This gives AI a complete picture fast.
  2. Use sitemap import. Once the pipeline works, import your XML sitemap and process in batches. Prioritize money pages first.
  3. Add dynamic link tags to your sitewide head. Instead of manually adding <link rel> tags to each page individually, add a single dynamic template to your site's global <head> that constructs the file URL from the current page path and your subdomain prefix automatically. This way, every page on your site already points to its own tailored Geordy files — even pages you haven't generated yet. See the link-rel guide for implementation details.
  4. Keep auto-updates on for pages that change. Products, categories, frequently edited marketing pages. Pause auto-updates if you manually edit a format and want to lock it.
  5. When something looks off, fix the source page first. If a generated format feels wrong, the original page is usually unclear to machines. Fix the page, regenerate.
Continue to Setup