aeo-graph-engine
Generates an AeoHead.astro component and astro.config.mjs integration for Astro projects.
Generates clean HTML partials for Hugo static sites to embed Schema.org and AI directives.
Generates clean HTML partials for Jekyll static sites to embed Schema.org and AI directives.
Generates framework-native integration code for Next.js App Router, including layout with JSON-LD injection, robots.ts, sitemap.ts, and an llms.txt route.
Generates nuxt.config.ts and app.vue useHead() integration code for Nuxt 3 projects.
Allows connecting to local Ollama LLM endpoints for private, free AI-powered generation of AEO configurations and content.
Enables using OpenAI models (e.g., GPT-4o, GPT-4o-mini) for AI-powered generation of AEO configurations and content within the AEO Studio.
Enables using Perplexity AI models for AI-powered generation and answer engine perception simulation within the AEO Studio.
Generates an app/root.tsx meta export integration for Remix applications.
Generates SvelteKit layout and robots.txt server route integration code for Svelte-based projects.
Generates index.html injection and a vite-plugin-aeo.ts for Vite + React SPA projects.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
AEO Graph Engine
Zero-dependency Answer Engine Optimization (AEO/GEO) toolkit, Schema.org JSON-LD @graph compiler, llms.txt and ai.txt manifest generator, AI crawler directive auditor, claim-evidence quotability analyzer, and Model Context Protocol (MCP) server.
Local Workstation:
http://127.0.0.1:8127Zoth Studio v2 Dossier: https://zoth.nullai.tech/tools/aeo-graph-engine
Repository: https://github.com/1nc0gn30/aeo-graph-engine
Overview
AEO Graph Engine runs on Python 3.9+ using only the standard library (json, urllib, html.parser, xml.etree.ElementTree, http.server) alongside a standalone in-browser Studio UI. It compiles linked Schema.org entity graphs, machine-readable LLM context files, and crawler access policies for AI search and citation systems (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, Google-Extended, Applebot-Extended).
Core capabilities:
Linked Schema.org
@graphCompiler: Emits cross-referenced@idgraphs (Organization,WebSite,WebApplication/SoftwareApplication,FAQPage,BreadcrumbList,TechArticle,ClaimReview) with deterministic JSON-LD validation.Machine Context Manifests: Generates
llms.txt,llms-full.txt,ai.txt, and RFC 9309robots.txtpolicies from project metadata, live URLs, or natural-language prompts.Live Multi-Page Crawler & Bot Shield: Audits live domains, sitemaps, structured data coverage, canonical headers, and per-bot crawler directives with competitor delta benchmarking.
Claim-Evidence & Citation Simulator: Extracts factual claims, scores empirical quotability, generates W3C
#:~:text=scroll-to-text fragment anchors, and simulates RAG citation retrieval.Multi-Framework Code Exporter: Outputs drop-in structured data components for Next.js (App and Pages Router), Astro, Vite + React, SvelteKit, Remix, Nuxt 3, and Hugo/Jekyll.
Related MCP server: Crawl Readiness MCP Server
Architecture
aeo-graph-engine/
├── server.py # Standalone loopback workstation entrypoint (127.0.0.1:8127)
├── bin/
│ ├── aeo-graph.js # Unified CLI, Web UI, and Electron desktop launcher
│ └── aeo-graph-engine-tui # Terminal dashboard launcher
├── public/ # Zero-egress browser AEO Studio UI
├── docs/ # Architecture, MCP, AI agent, and platform guides
├── src/aeo_graph_engine/
│ ├── core.py # Schema.org @graph, llms.txt, ai.txt & robots.txt compiler
│ ├── validator.py & injector.py # Bundle validator and idempotent HTML <head> injector
│ ├── scanner.py & crawler.py # Live HTTP/HTML scanner and multi-page sitemap crawler
│ ├── bot_inspector.py # AI crawler User-Agent registry and robots.txt evaluator
│ ├── knowledge_graph.py # Subject-predicate-object triplet & entity extractor
│ ├── claim_evidence_matrix.py # Claim-evidence scoring, ClaimReview & text-fragment builder
│ ├── citation_simulator.py # Answer engine retrieval & citation readiness simulator
│ ├── framework_exporter.py # Next.js, Astro, SvelteKit, Nuxt, Remix, React exporters
│ ├── ci_gate.py # CI/CD readiness score gate (text, JSON, GitHub annotations)
│ ├── mcp_server.py # JSON-RPC 2.0 stdio MCP server (12 tools)
│ ├── ui_server.py # Threading HTTP REST API & Studio server (:8127)
│ └── cli.py # aeo CLI router
└── tests/ # 237-test pytest verification suiteQuickstart
git clone https://github.com/1nc0gn30/aeo-graph-engine.git
cd aeo-graph-engine
pip install -e .
# Launch the local AEO Studio UI and REST API on 127.0.0.1:8127
python3 server.py --port 8127Open http://127.0.0.1:8127 in your browser, or serve the static client workstation directly:
python3 -m http.server 8127 --directory publicCLI & MCP Usage
Installing via pip install -e . registers the aeo CLI binary (and ZothOS v3.4.0 exposes aeo and aeo-graph on $PATH).
# Check status, platform info, and JSON telemetry
aeo --help
aeo --json
aeo --platform
# Generate a complete AEO bundle (schema.jsonld, llms.txt, llms-full.txt, ai.txt, robots.txt)
aeo --generate-all --site-name "NullAI" --domain "nullai.tech" --niche developer_tools --output-dir ./dist_aeo
aeo --validate ./dist_aeo
# Synthesize an AEO bundle from a natural-language project description
aeo prompt "Open-source Rust vector database on vectordb.dev" --output-dir ./dist_prompt
# Scan a live URL or local directory and run the CI quality gate
aeo scan https://example.com --format json
aeo check . --min-score 80 --fail-on-missing-llms
aeo bot-audit https://example.com
# Extract knowledge graph triplets, claim-evidence matrix, and citation simulation
aeo knowledge-graph ./public/index.html --format json
aeo claims ./public/index.html --format json
aeo simulate https://example.com --query "What is example.com?"
# Export framework-native components (nextjs_app, nextjs_pages, astro, vite_react, sveltekit, remix, nuxt3, hugo)
aeo framework nextjs_app --output-dir ./aeo_nextjs
# Launch the interactive Studio server on 127.0.0.1:8127
aeo serve --host 127.0.0.1 --port 8127MCP Server Integration
Start the JSON-RPC 2.0 stdio MCP server or export client configurations for Claude Desktop, Cursor, Cline, or Zed:
aeo mcp
aeo mcp --config claude_desktop
aeo mcp --config cursorRegistered MCP tools (12):
aeo_scan_site— Audit a URL or local path for Schema.org,llms.txt, and crawler readiness.aeo_synthesize_prompt— Synthesize a complete AEO configuration from a text description.aeo_generate_bundle— Compile JSON-LD@graph,llms.txt,llms-full.txt,ai.txt, androbots.txt.aeo_inject_html— Inject JSON-LD and discovery<link>tags into HTML<head>.aeo_validate— Validate JSON-LD graph integrity andllms.txtstructure.aeo_get_framework_snippets— Export framework-specific structured data components.aeo_simulate_citation— Simulate LLM RAG retrieval and citation scoring for a query.aeo_visualize_schema— Build entity-relationship node/edge graphs from JSON-LD.aeo_crawl_sitemap— Crawl sitemaps and multi-page structured data graphs.aeo_extract_knowledge_graph— Extract subject-predicate-object triplets from HTML or Markdown.aeo_analyze_claims— Score factual claims and empirical evidence density.aeo_generate_claim_matrix— EmitClaimReviewJSON-LD and#:~:text=deep-link anchors.
REST API Endpoints
Bound by default to http://127.0.0.1:8127:
Method | Endpoint | Description |
|
| Service health and runtime configuration |
|
| Compile Schema.org |
|
| Audit a live URL or HTML document for AEO readiness |
|
| Validate JSON-LD and AEO bundle artifacts |
|
| Inject structured data and discovery tags into HTML |
|
| Evaluate |
|
| Crawl sitemap URLs and aggregate structured data coverage |
|
| Extract entity-relationship triplets from page content |
|
| Analyze claims, quotability, and |
|
| Run deterministic RAG citation readiness simulation |
|
| Return node/edge topology for Schema.org |
|
| Benchmark AEO scores across multiple domains |
|
| Generate Next.js, Astro, SvelteKit, Nuxt, or React snippets |
|
| Export Markdown/HTML audit reports or full ZIP bundles |
|
| Export MCP client configuration JSON |
Testing & Verification
# Run the 237-test pytest suite
PYTHONPATH=src python3 -m pytest -q
# Run built-in CLI self-tests and CI quality gate
PYTHONPATH=src python3 -m aeo_graph_engine.cli --test
PYTHONPATH=src python3 -m aeo_graph_engine.cli check . --min-score 80 --fail-on-missing-llms
# Secret hygiene verification
gitleaks detect --source . --no-banner --redactSupport
AEO Graph Engine is 100% free and open-source software with zero paywalls or feature gates. Optional community support:
Stripe: Buy Us a Coffee (Stripe)
Solana Tip:
GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK(solana:GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK)
License
MIT License — Copyright (c) 1nc0gn30 (https://1nc0gn30.si) & NullAI (https://nullai.tech).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Live AEO, GEO, JSON-LD Schema, robots.txt AI crawler, and Agent Readiness diagnostic auditor.
Audit any website for AI agents and AI search (AEO): llms.txt, AI bots, schema. Score plus fixes.
Live SEO intelligence, rank tracking, site audits, and backlink analysis for AI agents.
Autonomous AI agent readiness, crawler reachability, and 30-point audit specification engine.
Related MCP Servers
AlicenseAqualityCmaintenanceLets any AI agent audit any website for SEO, GEO/AEO, and speed problems, reporting issues and recommendations without modifying the site.4MIT- AlicenseAqualityBmaintenanceChecks what GPTBot, ClaudeBot, PerplexityBot and 50+ other AI crawlers can read on a site and what its access policy allows, checks whether a page permits search, answers, training or agent use (with a signed receipt), generates llms.txt, robots.txt and JSON-LD, and reads your Answer Analysis. Nine tools for Claude Desktop, Cursor and other MCP clients.9139 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants and coding agents to audit, compare, and optimize websites for performance, SEO, AEO, GEO, and AI crawler accessibility directly from chat or development workflows.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to run evidence-first technical SEO and GEO audits, inspect HTML, structured data, robots policies and sitemaps, and compare before/after reports to verify fixes.51MIT