Skip to content

Audit any website's AI-readiness. Score 0-100. Lighthouse for AI. GLINCKER GLINR

License

Notifications You must be signed in to change notification settings

GLINCKER/geokit

Repository files navigation

GeoKit

Open-source toolkit for making websites AI-ready

npm version npm version npm version npm version CI License: MIT GitHub Action


GeoKit is a suite of developer tools for Generative Engine Optimization (GEO) — making your website visible to AI crawlers like ChatGPT, Claude, Perplexity, and Google AI Overviews.

Traditional SEO focused on ranking. GEO focuses on being cited in AI-generated answers.

GeoKit Demo

Packages

Package Description Status
@glincker/geo-audit CLI that scores any website's AI-readiness 0-100 Published
@glincker/geo-seo Generate llms.txt, JSON-LD, robots.txt, sitemap for AI discoverability Published
@glincker/geomark Convert any URL to clean markdown with metadata Published
@glincker/geokit Unified CLI + auto-fix pipeline Published

Framework Adapters (subpath exports in @glincker/geo-seo)

Import Framework
@glincker/geo-seo/next Next.js
@glincker/geo-seo/vite Vite / Vue / Svelte / Remix / SolidStart
@glincker/geo-seo/astro Astro
@glincker/geo-seo/nuxt Nuxt

Quick Start

# Audit any website (no install needed)
npx @glincker/geo-audit https://yoursite.com

# Install globally
npm install -g @glincker/geo-audit
geo-audit https://yoursite.com

# Get a badge snippet for your README
geo-audit https://yoursite.com --badge

Example

🔍 GEO Audit: glincker.com
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Score: 75/100 (B)

AI Discoverability  25/40
  ❌ llms.txt Exists  0/10
  ⚠️  robots.txt AI Crawler Rules  5/10

Structured Data  30/35
  ✅ JSON-LD Schema.org Markup  10/10
  ✅ OpenGraph Tags  10/10

Content Quality  30/38
  ⚠️  Heading Hierarchy  5/10
  ✅ SSR Content  10/10

Technical AI-Readiness  16/21
  ⚠️  Response Time  5/10
  ✅ HTTPS  3/3

📋 Top Recommendations:
  1. Add /llms.txt (+10 points)
  2. Add AI crawler rules to robots.txt (+5 points)
  3. Fix heading hierarchy (+5 points)

What GeoKit Checks

20 rules across 4 categories, normalized to a 0-100 score:

  • AI Discoverability (40 pts) — llms.txt, robots.txt AI rules, sitemap, RSS feeds
  • Structured Data (35 pts) — JSON-LD, OpenGraph, meta tags, canonical URL, identity schema
  • Content Quality (38 pts) — Headings, SSR, FAQ schema, lang tag, alt text, semantic HTML
  • Technical (21 pts) — Response time, content encoding, HTTPS, viewport

GitHub Action

Add AI-readiness checks to your CI/CD pipeline with our Marketplace action:

- uses: GLINCKER/geo-audit-action@v1
  with:
    url: https://yoursite.com
    fail-under: 70
    comment: true

Outputs score, grade, badge, and full result JSON. Posts a PR comment with your AI-readiness report.

Why GEO Matters

  • ChatGPT, Claude, and Perplexity handle millions of searches daily
  • Google AI Overviews appear in 15%+ of search results
  • AI crawlers use different signals than traditional SEO

Development

git clone https://github.com/glincker/geokit.git
cd geokit
npm install
npm run build    # Build all packages
npm run test     # Run all tests (323 passing)

Contributing

See CONTRIBUTING.md for how to add rules, run tests, and submit PRs.

License

MIT - see LICENSE

Links


Made by Glincker

About

Audit any website's AI-readiness. Score 0-100. Lighthouse for AI. GLINCKER GLINR

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •