Pure ESM cores, a two-seam adapter contract, and a trusted/untrusted split that keeps provider keys server-side. Architecture, integration surfaces, the operational contract and a safe adoption path.
| Property | Statement |
|---|---|
| Module system | Pure ESM; no build step |
| Dependencies | Zero runtime dependencies |
| Runtimes | Node, Deno, edge and browser |
| Verification | node --test; 560+ tests |
| Core facade | createSeoAgent() |
| Integration seams | Content and storage adapters |
| Surface | Use when | Operational boundary |
|---|---|---|
| SDK | Embedding inside a trusted service | Facade over the cores; secrets server-side |
| HTTP service | Language-neutral / centralised | Request→Response router; bearer-licensed |
| MCP server | Giving AI clients SEO tools | Zero-dep stdio server; six SEO tools |
| Claude skill | Assistant-native workflow | MCP-preferred with script fallback |
| Browser widgets | Showing ranks, potential, results | Pure build/mount presentation components |
| Admin cockpit | Operating proposals, keywords, rankings | Host controls persistence through onAction |
| Stage | Policy | Exit criterion |
|---|---|---|
| Observe | All task types off; collect proposals + costs | Stable signal collection, trusted baselines |
| Approve | Human review for every action | Repeated acceptance + safe verification by task type |
| Graduate | Auto only for high-confidence, reversible tasks | Low regression rate within spend + brand thresholds |
| Operate | Scheduled loop with alerts + periodic review | SLOs, audit retention, rollback rehearsed |
SDK, service, MCP, skill, widgets, admin cockpit; scheduled runs; publishing; self-healing; budget controls; multilingual; GEO readiness; and measured AI-answer citations (Perplexity). Card billing (MIPS) + admin back-office live; free beta open.
Marketplace identity & billing (I-Novanet Software Ltd); broader measured AI-citation coverage across engines; pooled cross-site learning (foundation shipped; model pending data); broader packaged connectors and enterprise controls.
Use the SDK for in-process control, the HTTP service for organisational reuse, MCP/skills for agent ecosystems, widgets for embedded evidence, and the cockpit for human governance.