website:
  metadata:
    name: "Geordy"
    title: "Geordy - Same Site. Understood by AI"
    url: "https://geordy.ai/how-it-works"
    core_info:
      tagline: "Same Site. Understood by AI"
      page: "How it works"
  header:
    primary_elements:
      - type: "heading"
        level: 1
        text: "How it works"
    navigation: []
    actions: []
  content:
    - section:
        title: "Others measure visibility. Geordy creates it."
        description: "Most tools tell you how AI sees your site. Geordy gives AI something clear to see."
        elements:
          - type: "image"
            src: "https://geordy.ai/art/scene-how-it-works.svg"
            alt: "Your page becomes structured files that AI reads"
        actions: []
    - section:
        title: "The problem"
        subtitle: "AI doesn't see your website the way people do."
        description: "Your pages are built for browsers - layouts, styles, interactions. AI systems don't render any of that. They parse text and look for structure. If the structure isn't there, AI has to guess. Sometimes it gets it right. Often it doesn't."
        elements:
          - type: "visual-comparison"
            label: "What AI sees without Geordy"
            preview:
              code: |
                <div class="hdr--lg theme-light">
                  <nav role="banner">…</nav>
                </div>
                <section id="hero-1">
                  <h1>Acme Inc</h1>
                  // 12 tracking scripts
                  // 3 cookie banners
                  // ARIA wrappers, grid cells…
                </section>
            controls:
              - type: "select"
                label: "Select a page"
            examples:
              - label: "What AI sees in raw HTML"
                summary: "Nested tags. Class names. Scripts. Styles. Noise."
                code: |
                  <div class="hdr--lg theme-light"><nav role="banner">…</nav></div><section id="hero-1"><h1>Acme Inc</h1>// 12 tracking scripts// 3 cookie banners// 8 promo pop-ups<p class="sub--xl">Office chairs.</p></section>// + 38 ARIA wrappers, 23 grid cells…
              - label: "What AI sees with Geordy"
                summary: "Title. Description. Entities. Signal."
                code: |
                  # Acme Inc Office chairs for hybrid teams.## Summary Ergonomic seating, made to last.## Entities brand:Acme geo:US, EU type:Manufacturer## Pages/aero:Mesh task chair/forge:Heavy-duty stool
        actions: []
    - section:
        title: "Steps"
        subtitle: "Three steps. That's it."
        description: "No code changes. No CMS plugins. No ongoing maintenance."
        elements:
          - type: "step"
            order: 1
            marker: "i"
            title: "Share a URL."
            description: "Drop a page URL into Geordy. Homepage, product page, blog post - any public page works. Or paste your sitemap and onboard hundreds of pages at once."
            code: |
              # In the dashboard:
              > add https://your-site.com/about
              ✓ added (1 page · scan queued)

              > import https://your-site.com/sitemap.xml
              ✓ imported 247 pages
          - type: "step"
            order: 2
            marker: "ii"
            title: "Geordy generates structured files."
            description: "Up to 16 formats. One scan. Per page, the right shape: llms.txt, schema.json, clean Markdown, YAML, RSS, OG, manifest, humans - plus eight enterprise formats for knowledge graphs."
            formats:
              - "llms.txt"
              - "schema.json"
              - "index.md"
              - "index.yaml"
              - "feed.xml"
              - "og.json"
              - "manifest.json"
              - "humans.txt"
            enterprise_formats: "+ 8 enterprise"
          - type: "step"
            order: 3
            marker: "iii"
            title: "Point AI to them."
            description: "Add link tags to your <head> pointing at the structured versions. AI crawlers find them. Done. No JavaScript on your pages, no CMS rebuild, no impact on what your visitors see."
            code: |
              <!-- once in <head>, sitewide -->
              <link rel="alternate"
                    type="text/markdown"
                    href="https://ai.your-site.com" />

              <link rel="alternate"
                    type="application/llms.txt"
                    href="https://ai.your-site.com/llms.txt" />
        actions: []
    - section:
        title: "Why"
        subtitle: "Monitoring tells you what happened."
        description: "Geordy changes what happens next. Most GEO tools watch how AI treats you. Useful, but reactive. Geordy actually shapes what AI reads."
        elements:
          - type: "comparison"
            items:
              - label: "Traditional GEO tools"
                subtitle: "Tracking and alerts"
                description: "Useful, but reactive."
                features:
                  - "Track where you appear in AI answers"
                  - "Show competitor citation rankings"
                  - "Alert when visibility drops"
                  - "Suggest improvements you have to ship yourself"
                  - "Give you reports, not new outcomes"
              - label: "Geordy"
                subtitle: "Generates and serves the layer itself"
                description: "Proactive. You're shaping, not watching."
                features:
                  - "Generates the structured files AI actually reads"
                  - "Serves them from your subdomain"
                  - "Refreshes them on the cadence you choose"
                  - "Gives AI a clear picture of your site, by design"
                  - "Tracks who reads what - bot, format, page"
        actions: []
    - section:
        title: "Ready to be seen?"
        description: "Drop a URL. See what Geordy generates. Decide from there."
        elements: []
        actions:
          - type: "cta"
            label: "Drop a URL"
            description: "Drop a URL. See what Geordy generates. Decide from there."
            url: null
  footer:
    links: []
    info: []
    social: []