Tengence GEO Agent

Tengence GEO Agent

GEO/SEO content production & publishing engine — full-pipeline automation from content planning → writing & ingest → gate checks → WordPress publishing → search submission → GEO monitoring. Three usage modes: CLI / MCP (AI clients) / built-in agent runtime loop. Default storage is a single-file multi-tenant SQLite (auto-initialized) with optional MySQL; designed for open source and multi-site use.

  AI clients (any MCP-capable harness)        │  MCP (stdio or Streamable HTTP + Bearer)        ▼  @tengence/geo-mcp     29 tools (workspace/site/article/check/publish/plan/image/monitor/db/search/diagnose/util/standards)        ▼  @tengence/geo-cli     21 tengence-geo-* commands        ▼  @tengence/geo-sdk     15-domain capability layer (site/db/wp/content/images/search/…)        ▼  SQLite (auto-init)  or  MySQL (tengence_geo_*, isolated from prod tengence_omni_*)

Packages (monorepo)

Quick start

npm installcp -R examples/site-template ~/tengence/sites/my-sitecd ~/tengence/sites/my-site && cp .env.example .env   # fill in WP credentials / tokens
# Full CLI pipelineexport SITES_ROOT=~/tengence/sitestengence-geo-article-ingest hello-geo ./hello-geo.md --site my-site --research ./hello-geo.research.mdtengence-geo-check-article hello-geo --site my-site
# MCP (any MCP-capable client; see docs/mcp-platforms.md)node packages/geo-mcp/bin/geo-mcp.js                          # stdioGEO_MCP_TOKEN=sk-xxx node packages/geo-mcp/bin/geo-mcp-http.js  # HTTP
# Agent (runs once the API key is set)export DEEPSEEK_API_KEY=sk-xxxnpx -y @tengence/geo-agent

Full onboarding: docs/getting-started.md.

Documentation

• Architecture & design decisions (layering / multi-tenancy / init model / why MCP bridging)
• Generic writing & GEO standards — shipped in @tengence/geo-sdk, consumed via the standards_list / standards_read / article_draft MCP tools (the requirements an article must satisfy)
• Getting started
• MCP integration (stdio / HTTP, any client)
• Release & distribution (npm / Docker)

Development & verification

npm run build          # workspace consistency checknpm test               # 138 tests (all green on SQLite)npm run geo:sdk-smoke  # SDK smoke test

Security boundaries

• Secrets live only in SITES_ROOT/<site>/.env (gitignored); the repo ships only the .env.example template.
• The production MySQL (tengence_omni_*) is never written by this repo; the new repo uniformly uses tengence_geo_*.
• The MCP HTTP transport requires GEO_MCP_TOKEN (Bearer).

License

MIT