dokeo 3.0.0

Pre-publish content quality gate (SEO, AEO, GEO) - API, CLI, MCP

Dokeo — Content Quality Gate

Pre-publish content quality gate for SEO, AEO, and GEO. Scores every post, email, video script, and AI output against 8 core checks before it ships.

Surfaces

Dokeo ships as four parallel surfaces that all hit the same gate engine:

Surface	Port / Transport	Best for
FastAPI service	http://host:8000/api/v1/*	Programmatic integrations, webhooks
Next.js web app	https://host/web/*	End-user UI with Clerk auth
Streamlit UI	https://host/	Legacy dashboard, single-user password
MCP server	stdio	Claude / Cursor / any MCP client
CLI	dokeo in your shell	Pipelines, n8n, Claude Code

The legacy webhook (port 8502, /check, /check-url, etc.) is kept for backward compatibility with existing n8n / Zapier / Make integrations.

Quickstart

# 1. Install
pip install -e .

# 2. Run the API
uvicorn api.main:app --reload --port 8000
# → http://localhost:8000/docs for OpenAPI

# 3. Run the web app (separate terminal)
cd web && bun install && bun run dev

# 4. Run the Streamlit UI (separate terminal)
streamlit run app.py

# 5. Try the CLI
echo "# My post\n\n## Question?\n\n..." | dokeo pipe

# 6. Try the MCP server (Claude Desktop / Cursor will spawn it for you)
dokeo-mcp-server

Self-hosted with Docker

cp .env.example .env
# Edit .env - set DOKEO_API_KEY, DOKEO_PASSWORD, Clerk keys
docker compose up -d

Routes (via Caddy at ports 80/443):

• / → Streamlit (port 8501)
• /web/*, /sign-in, /sign-up → Next.js (port 3000)
• /api/v1/* → FastAPI (port 8000)
• /check*, /check-url*, /check-blog*, /health*, etc. → legacy webhook (port 8502)

Auth model

Surface	Auth
FastAPI (/api/v1/*)	Bearer token: DOKEO_API_KEY or DOKEO_API_KEYS=key:tenant,...
Legacy webhook	Same Bearer token
Streamlit	Cookie session via DOKEO_PASSWORD
Next.js	Clerk (hosted)
MCP	Filesystem only; no network exposure
CLI	None (local)

DOKEO_API_KEY is required in any non-dev environment. Streamlit refuses to boot in production without DOKEO_PASSWORD.

Documentation

• API: OpenAPI at /docs or /redoc when running
• MCP: docs/mcp.md
• Engine config: config.yaml
• Content-type definitions: gate/content_types.py

Tests

pytest                  # all tests
pytest tests/test_mcp_server.py   # MCP only