Tengence GEO Agent

Tengence GEO Agent

GEO／SEO コンテンツの制作・公開エンジンです。コンテンツ計画 → 執筆・取り込み → ゲートチェック → WordPress への公開 → 検索エンジンへの送信 → GEO モニタリングまで、パイプライン全体を自動化します。利用モードは 3 つです。CLI／MCP（AI クライアント）／組み込みエージェントのランタイムループ。デフォルトのストレージは、単一ファイルのマルチテナント SQLite（自動初期化）で、オプションで MySQL も利用できます。オープンソースおよびマルチサイトでの利用を想定して設計されています。

  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_*)

パッケージ（モノレポ）

パッケージ	形式	説明
@tengence/geo-sdk	ライブラリ	15 ドメインの機能レイヤー。遅延読み込みに対応し、単一の require エントリを提供
@tengence/geo-cli	CLI	21 個のバイナリ（取り込み／ゲート／公開／画像／送信／モニタリング／計画）
@tengence/geo-mcp	MCP Server	29 個のツール、stdio と HTTP のデュアルトランスポート、Bearer 認証
@tengence/geo-agent	エージェントランチャー	DEEPSEEK_API_KEY が設定されると実行します（HARNESS=dsh|opencode|pi）

クイックスタート

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

導入手順の全体については、docs/getting-started.md をご覧ください。

ドキュメント

• アーキテクチャと設計上の決定事項（レイヤー構成／マルチテナント／初期化モデル／MCP ブリッジングの理由）
• 一般的な執筆および GEO 標準 — @tengence/geo-sdk に同梱されています。MCP リソース geo://standard-index／geo://standard/{name} と article_draft ツールから利用できます（記事が満たすべき要件）
• はじめに
• MCP 統合（stdio／HTTP、任意のクライアント）
• リリースと配布（npm／Docker）

開発と検証

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

セキュリティ境界

• シークレットは SITES_ROOT/<site>/.env にのみ保存します（gitignore 対象）。リポジトリには .env.example テンプレートのみを同梱しています。
• 本番用 MySQL（tengence_omni_*）にこのリポジトリから書き込むことはありません。新しいリポジトリでは、すべて tengence_geo_* を使用します。
• MCP の HTTP トランスポートでは GEO_MCP_TOKEN（Bearer）が必要です。

ライセンス

MIT