AISEO

A 5-agent autonomous SEO engine.

AISEO is a persistent Node.js runtime. Five cooperating agents — keyword research, content generation, technical audit, authority, and analytics — execute in a continuous loop behind a single control panel and write generated site artifacts to disk.

Run AISEO Engine View Architecture

AISEO is not a static site generator. It is a long-running engine that produces static client sites as output.

Five agents. One loop.

1. Keywords

Discovers seed terms, expands into clusters, ranks by opportunity score.

2. Content

Generates long-form HTML articles per cluster with canonical, OpenGraph, JSON-LD, and breadcrumb schema.

3. Technical

Audits generated pages, emits a site-wide sitemap and robots file, records a technical-health report.

4. Authority

Drafts guest-post material and tracks backlink targets for each top cluster.

5. Analytics

Reads live performance data where credentials are configured; records state across loop cycles.

Orchestrator

Runs the agents in order, persists state, and fires the next cycle on a configurable interval.

Architecture

Three surfaces, deployed to three different targets. They are intentionally decoupled.

Product site

Cloudflare Pages

Public landing page and docs. Static HTML and CSS. This site.

Engine runtime

Node / Docker / VPS / always-on machine

The persistent runtime: five agents, orchestrator, control panel, filesystem state. Must run as a long-lived process with a real filesystem. Not suitable for serverless or static hosting.

Generated client sites

output/{target-slug}/

Every target domain gets its own subdirectory under output/. Pages, sitemap, and robots file are written there. Deployment of generated sites is independent of engine deployment.

Deployment surfaces

Surface	Host	Why
Landing page	Cloudflare Pages	Static. Cacheable. Free tier fits.
Engine	Docker / VPS / Railway / Fly / Render / local host	Persistent process, durable filesystem, outbound HTTP.
Client site output	Any static host (Pages, Netlify, S3, GitHub Pages)	One deploy per target domain.

Run the engine

git clone https://github.com/benheng77-creator/AISEO.git
cd AISEO
npm install
npm run init       # scaffold state if missing
npm run panel      # start control panel + API
npm start          # start orchestrator loop

The control panel exposes the agents, state, reports, and target configuration over a local HTTP API. See the repository README for environment variables and credentials.