GEO AI Core

GEO AI – AI Search Optimization

Universal TypeScript engine for optimizing websites for AI search engines.

A zero-dependency TypeScript engine that optimizes websites for AI search engines like ChatGPT, Claude, Gemini, Perplexity, DeepSeek, Grok, Apple Siri, Amazon Alexa, and more. Works with any framework – Next.js, Nuxt, Astro, SvelteKit, or plain Node.js.

• geo-ai-core – Universal engine (llms.txt generation, bot rules, crawl tracking, caching, encryption, SEO signals, AI descriptions)
• geo-ai-next – Thin Next.js wrapper (~200 lines): middleware + route handler

Try the analyzer at geoai.run/analyze

---

Why GEO AI?

Traditional SEO tools are built for search engines like Google. But AI search engines work differently — they read structured content, not meta keywords.

GEO AI provides infrastructure for AI Search Optimization:

• ✅ llms.txt generation — structured content for AI crawlers
• ✅ AI crawler management — per-bot allow/disallow rules for 16+ bots
• ✅ AI metadata — meta tags, Link headers, JSON-LD signals
• ✅ Structured signals — pricing, availability, variants in machine-readable format

---

Architecture

                         GEO AI
                           │
            ┌──────────────┼──────────────┐
            │              │              │
        WordPress       Shopify        Node.js
            │              │              │
       GEO-AI-Woo   GEO-AI-Shopify   geo-ai-core
            │                             │
       WooCommerce                    geo-ai-next

Ecosystem

Platform	Package
WordPress / WooCommerce	geo-ai-woo
Shopify	geo-ai-shopify
Next.js	geo-ai-next
Any Node.js	geo-ai-core

---

Quick Start

npm install geo-ai-core

import { createGeoAI } from 'geo-ai-core';

const geo = createGeoAI({
  siteName: 'My Site',
  siteUrl: 'https://example.com',
});

// Generate llms.txt
const llmsTxt = await geo.generateLlms();

---

Features

llms.txt Generation

Generates llms.txt and llms-full.txt from any data source via the ContentProvider interface. Standard version includes resource links with descriptions; full version adds content, pricing, availability, and variants.

AI Crawler Management

Built-in registry of 16+ AI crawlers with per-bot allow/disallow rules and robots.txt block generation.

Bot	Provider
GPTBot	OpenAI / ChatGPT
OAI-SearchBot	OpenAI / Copilot Search
ClaudeBot	Anthropic / Claude
claude-web	Anthropic / Claude Web
Google-Extended	Google / Gemini
PerplexityBot	Perplexity AI
DeepSeekBot	DeepSeek
GrokBot	xAI / Grok
meta-externalagent	Meta / LLaMA
PanguBot	Alibaba / Qwen
YandexBot	Yandex / YandexGPT
SputnikBot	Sber / GigaChat
Bytespider	ByteDance / Douyin
Baiduspider	Baidu / ERNIE
Amazonbot	Amazon / Alexa
Applebot	Apple / Siri & Spotlight

TTL Caching

Pluggable cache via CacheAdapter interface with built-in implementations:

• MemoryCacheAdapter — In-memory with TTL and automatic expired entry eviction (configurable maxEntries, default 1 000)
• FileCacheAdapter — File-based with JSON metadata

Crawl Tracking

GDPR-compliant bot visit logging with SHA-256 IP anonymization (Web Crypto API, Edge Runtime compatible). Pluggable storage via CrawlStore interface with built-in MemoryCrawlStore (configurable maxEntries, default 10 000).

AI Description Generation

Optional module (geo-ai-core/ai) for generating AI-optimized descriptions via Claude or OpenAI APIs:

• Customizable prompt templates with {title}, {content}, {type}, {price}, {category} placeholders
• Bulk generation (up to 50 items, batched by 5 concurrently) with progress callback
• Sliding window rate limiter (default 10 req/min)
• Typed error classification (auth, rate limit, server, network)

SEO Signals

• <meta name="llms"> and <meta name="llms-full"> tags
• HTTP Link header for AI content discovery
• JSON-LD Schema.org (WebSite, Product, Article)

Encryption

AES-256-GCM encryption for API keys via node:crypto. Format: base64(IV[12] + authTag[16] + ciphertext).

---

Installation

npm install geo-ai-core
# or for Next.js projects:
npm install geo-ai-next

Basic Usage

import { createGeoAI } from 'geo-ai-core';

const geo = createGeoAI({
  siteName: 'My Site',
  siteUrl: 'https://example.com',
  provider: {
    Products: [
      { title: 'Widget', url: '/products/widget', description: 'A great widget' },
    ],
    Blog: [
      { title: 'Hello World', url: '/blog/hello', description: 'First post' },
    ],
  },
});

// Generate llms.txt
const llmsTxt = await geo.generateLlms(false);

// Generate llms-full.txt
const llmsFullTxt = await geo.generateLlms(true);

// Generate robots.txt block
const robotsTxt = geo.generateRobotsTxt();

// SEO signals
const metaTags = geo.generateMetaTags();
const linkHeader = geo.generateLinkHeader();
const jsonLd = geo.generateJsonLd();

With ContentProvider

import { createGeoAI, type ContentProvider } from 'geo-ai-core';

class StrapiProvider implements ContentProvider {
  async getSections(options?: { locale?: string }) {
    const products = await fetchProducts(options?.locale);
    return [
      { name: 'Products', type: 'product', resources: products },
      { name: 'Blog', type: 'page', resources: await fetchPosts() },
    ];
  }
}

const geo = createGeoAI({
  siteName: 'My Site',
  siteUrl: 'https://example.com',
  provider: new StrapiProvider(),
  crawlTracking: true,
});

Next.js Middleware

// middleware.ts
import { geoAIMiddleware } from 'geo-ai-next';

export default geoAIMiddleware({
  siteName: 'My Site',
  siteUrl: 'https://example.com',
  provider: new MyProvider(),
  cache: '24h',
});

export const config
### Next.js Route Handler

```typescript
// app/llms/route.ts
import { createLlmsHandler } from 'geo-ai-next';

export const { GET } = createLlmsHandler({
  siteName: 'My Site',
  siteUrl: 'https://example.com',
  provider: new MyProvider(),
  cacheMaxAge: 3600, // seconds, default 3600
});
### AI Description Generation

```typescript
import { AiGenerator } from 'geo-ai-core/ai';

const ai = new AiGenerator({
  provider: 'anthropic',
  apiKey: 'sk-...',
  model: 'claude-sonnet-4-20250514',
});

const description = await ai.generate({
  title: 'Premium Widget',
  content: 'A high-quality widget made from...',
  type: 'product',
  price: '$29.99',
});

---

Configuration

interface GeoAIConfig {
  // Required
  siteName: string;
  siteUrl: string;
  provider: ContentProvider | Record<string, Resource[]>;

  // Optional
  siteDescription?: string;
  crawlers?: Record<string, 'allow' | 'disallow'> | 'all';
  cache?: CacheAdapter | string;  // '1h', '24h', '7d' or custom adapter
  crypto?: { encryptionKey: string };  // 64-char hex
  crawlTracking?: { store?: CrawlStore; secret?: string } | true;
}

---

Packages

Package	Description	Entry Points
geo-ai-core	Universal engine	. (main), ./ai (AI generator)
geo-ai-next	Next.js middleware + route handler	.

---

Requirements

• Node.js 20 or higher
• TypeScript 5.5+ (recommended, ships .d.ts)

---

Development

# Clone
git clone https://github.com/madeburo/GEO-AI.git
cd GEO-AI/geo-ai-core

# Install
npm install

# Build all packages
npm run build

# Run tests
npx vitest run

# Type check
npx tsc --noEmit

---

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

---

License

GEO AI Core is open-source software licensed under the GPL v2.

---

Credits

• Author: Made Büro
• Website: geoai.run
• GitHub: @madeburo
• X: @imadeburo