English Français العربية

Tengence GEO Agent

Registre officiel Marketing et ventes

GEO/SEO content pipeline MCP: plan, write, gate-check, publish, submit, monitor AI visibility.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @tengence/geo-mcp
Claude Code 
claude mcp add tengence-geo-agent -e 'SITES_ROOT=<SITES_ROOT>' -e 'TENGENCE_GEO_HOME=<TENGENCE_GEO_HOME>' -e 'DB_DRIVER=<DB_DRIVER>' -- npx -y @tengence/geo-mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tengence-geo-agent": {
            "command": "npx",
            "args": [
                "-y",
                "@tengence/geo-mcp@0.1.1"
            ],
            "env": {
                "SITES_ROOT": "<SITES_ROOT>",
                "TENGENCE_GEO_HOME": "<TENGENCE_GEO_HOME>",
                "DB_DRIVER": "<DB_DRIVER>"
            }
        }
    }
}

Variables d'environnement

  • SITES_ROOT Root directory holding per-site config and .env files. Optional; the workspace is chosen at runtime via the workspace_use tool.
  • TENGENCE_GEO_HOME Internal runtime data directory (DB, caches). Defaults to ~/.tengence/geo-mcp.
  • DB_DRIVER Storage backend: sqlite (default) or mysql for production.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Tengence GEO Agent
  2. Packages (monorepo)
  3. Quick start
  4. Documentation
  5. Development & verification
  6. Security boundaries
  7. License

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)

PackageFormDescription
@tengence/geo-sdkLibrary15-domain capability layer, lazy-loaded, single require entry
@tengence/geo-cliCLI21 bins (ingest / gate / publish / images / submission / monitor / plan)
@tengence/geo-mcpMCP Server29 tools, stdio + HTTP dual transport, Bearer auth
@tengence/geo-agentAgent launcherRuns once DEEPSEEK_API_KEY is set (HARNESS=dsh\opencode\pi)

Quick start

npm install
cp -R examples/site-template ~/tengence/sites/my-site
cd ~/tengence/sites/my-site && cp .env.example .env   # fill in WP credentials / tokens

# Full CLI pipeline
export SITES_ROOT=~/tengence/sites
tengence-geo-article-ingest hello-geo ./hello-geo.md --site my-site --research ./hello-geo.research.md
tengence-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                          # stdio
GEO_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-xxx
npx -y @tengence/geo-agent

Full onboarding: docs/getting-started.md.

Documentation

Development & verification

npm run build          # workspace consistency check
npm 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

Questions fréquentes

Qu'est-ce que Tengence GEO Agent ?

GEO/SEO content pipeline MCP: plan, write, gate-check, publish, submit, monitor AI visibility.

Comment installer Tengence GEO Agent ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add tengence-geo-agent -e 'SITES_ROOT=<SITES_ROOT>' -e 'TENGENCE_GEO_HOME=<TENGENCE_GEO_HOME>' -e 'DB_DRIVER=<DB_DRIVER>' -- npx -y @tengence/geo-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Tengence GEO Agent ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Tengence GEO Agent est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Tengence GEO Agent ?

Il est publié par tengence-team. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.