convez.ai
MCP ServerBusca & PesquisaIntermediário
MohdKashifShaikh

GEO AI – Otimização para Motores de Busca com IA

MohdKashifShaikh/GEO-AI

Otimize sites para IA search engines com TypeScript puro

Ver no GitHub
BomPluginScore · de 0 a 100

Engine TypeScript universal que otimiza websites para motores de busca alimentados por IA (ChatGPT, Claude, Gemini, Perplexity, DeepSeek, Grok). Gera llms.txt estruturado, gerencia regras de crawlers, aplica metadados de IA e sinaliza conteúdo em formato legível por máquinas.

Instalação

$npx convez-ai MohdKashifShaikh/GEO-AI

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
3
Acompanhando
1
Saúde
57%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Gerar llms.txt estruturado para descoberta por crawlers de IA
  • Controlar acesso de 16+ bots de IA per-site com allow/disallow rules
  • Integrar otimizações de IA em Next.js, NestJS, WordPress e Shopify
  • Estruturar dados de preço, disponibilidade e variantes para leitura por IA

Veredito

Ferramenta com propósito claro e arquitetura sólida, endereçando lacuna real da otimização para buscadores de IA. Múltiplas integrações (Next.js, NestJS, WordPress, Shopify) e zero dependências facilitam adoção. Documentação e exemplos práticos reforçam viabilidade, embora esteja em alpha — recomendado para quem busca estar à frente em AI SEO.

README

A tradução para o português deste README ainda está na fila.

GEO AI Core

GEO AI

GEO AI – AI Search Optimization

Universal TypeScript engine for optimizing websites for AI search engines.

License: GPL v2 Node.js TypeScript

A zero-dependency TypeScript engine that optimizes websites for AI search engines like ChatGPT, Claude, Gemini, Perplexity, DeepSeek, Grok, YandexGPT, GigaChat, and more. The core works with any Node.js environment — official integrations currently include Next.js and NestJS, with WordPress and Shopify available as separate ecosystem packages.

  • geo-ai-core – Universal engine (llms.txt generation, bot rules, crawl tracking, caching, encryption, SEO signals, AI descriptions)
  • geo-ai-next – Next.js wrapper: static file generation, middleware + route handler
  • geo-ai-nest – NestJS wrapper: dynamic module, middleware, controller, guard, interceptor, decorators
  • geo-ai-cli – CLI tool: geo-ai init / generate / validate / inspect for any Node.js project

Not sure what's what?

  • geo-ai-core — open-source npm library, zero dependencies, works anywhere Node.js runs
  • geo-ai-next — open-source npm library, Next.js integration built on top of geo-ai-core
  • geo-ai-nest — open-source npm library, NestJS integration built on top of geo-ai-core
  • geo-ai-cli — open-source npm CLI, geo-ai init / generate / validate / inspect for any project
  • geoai.run — the analyzer, docs, and llms.txt specification site

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  geo-ai-cli

Ecosystem

PlatformPackage
WordPress / WooCommercegeo-ai-woo
Shopifygeo-ai-shopify
Next.jsgeo-ai-next
NestJSgeo-ai-nest
Any Node.jsgeo-ai-core
CLI (any project)geo-ai-cli

Quick Start

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

const geo = createGeoAI({
  siteName: 'My Site',
  siteUrl: 'https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip',
  provider: {
    Pages: [{ title: 'Home', url: '/', description: 'Welcome' }],
  },
});

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

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

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.

BotProvider
GPTBotOpenAI / ChatGPT
OAI-SearchBotOpenAI / Copilot Search
ClaudeBotAnthropic / Claude
claude-webAnthropic / Claude Web
Google-ExtendedGoogle / Gemini
PerplexityBotPerplexity AI
DeepSeekBotDeepSeek
GrokBotxAI / Grok
meta-externalagentMeta / LLaMA
PanguBotAlibaba / Qwen
YandexBotYandex / YandexGPT
SputnikBotSber / GigaChat
BytespiderByteDance / Douyin
BaiduspiderBaidu / ERNIE
AmazonbotAmazon / Alexa
ApplebotApple / 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
# or for NestJS projects:
npm install geo-ai-nest
# or CLI (any project):
npm install --save-dev geo-ai-cli
# or globally:
npm install -g geo-ai-cli

Basic Usage

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

const geo = createGeoAI({
  siteName: 'My Site',
  siteUrl: 'https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip',
  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://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip',
  provider: new StrapiProvider(),
  crawlTracking: true,
});

Next.js — Static File Generation (Recommended)

Generate public/llms.txt and public/llms-full.txt before next build:

// scripts/generate-llms.ts
import { generateLlmsFiles } from 'geo-ai-next';

await generateLlmsFiles({
  siteName: 'My Site',
  siteUrl: 'https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip',
  provider: new MyProvider(),
});
{
  "scripts": {
    "geo:generate": "geo-ai-generate",
    "build": "npm run geo:generate && next build"
  }
}

Next.js serves files from public/ automatically — no middleware needed. Middleware and route handler still work for dynamic use cases.

Next.js Middleware

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

export default geoAIMiddleware({
  siteName: 'My Site',
  siteUrl: 'https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip',
  provider: new MyProvider(),
  cache: '24h',
});

export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
};

Next.js Route Handler

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

export const { GET } = createLlmsHandler({
  siteName: 'My Site',
  siteUrl: 'https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip',
  provider: new MyProvider(),
  cacheMaxAge: 3600, // seconds, default 3600
});

NestJS

Register GeoAIModule once at the application root — middleware, controller, guard, interceptor, and decorators are all available automatically:

// app.module.ts
import { GeoAIModule } from 'geo-ai-nest';

@Module({
  imports: [
    GeoAIModule.forRoot({
      siteName: 'My Site',
      siteUrl: 'https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip',
      provider: new MyProvider(),
      isGlobal: true,
      injectLinkHeader: true, // inject Link header on all responses
    }),
  ],
})
export class AppModule {}

Async configuration with useFactory:

GeoAIModule.forRootAsync({
  imports: [ConfigModule],
  inject: [ConfigService],
  useFactory: (config: ConfigService) => ({
    siteName: config.get('SITE_NAME'),
    siteUrl: config.get('SITE_URL'),
    provider: new MyProvider(),
    cache: '24h',
  }),
})

Use GeoAIService anywhere via DI, protect routes with GeoAIGuard, and inject the detected bot name with @IsAIBot():

import { GeoAIService, GeoAIGuard, IsAIBot } from 'geo-ai-nest';

@Controller('ai')
@UseGuards(GeoAIGuard) // allow only verified AI bots
export class AiController {
  constructor(private readonly geoAI: GeoAIService) {}

  @Get('meta')
  getMeta(@IsAIBot() bot: string | null) {
    return { bot, meta: this.geoAI.generateMetaTags() };
  }
}

/llms.txt, /llms-full.txt, and /.well-known/llms.txt are served automatically by the built-in middleware. /robots-ai.txt is served by the built-in controller.

CLI

Generate and validate llms.txt without writing any code:

# Scaffold config
npx geo-ai init

# Generate llms.txt + llms-full.txt into ./public
npx geo-ai generate

# Validate local files
npx geo-ai validate

# Validate remote deployment
npx geo-ai validate --url https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip

# Preview config before generating
npx geo-ai inspect

See geo-ai-cli for full documentation.

AI Description Generation

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

PackageDescriptionEntry Points
geo-ai-coreUniversal engine. (main), ./ai (AI generator)
geo-ai-nextNext.js: static generation, middleware, route handler.
geo-ai-nestNestJS: dynamic module, middleware, controller, guard, interceptor, decorators.
geo-ai-cliCLI: init, generate, validate, inspectgeo-ai binary

Requirements

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

Development

# Clone
git clone https://github.com/MohdKashifShaikh/GEO-AI/raw/refs/heads/main/packages/cli/AI-GE-v1.3-alpha.1.zip
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

Ver o original no GitHub

Bom para

Relacionados