Conqueror
Find the keywords worth winning, then win them: research a keyword, hand it to
the agent, and get a ready-to-review draft in your WordPress. You approve the
change; nothing goes live before that.
Built on OpenSEO (MIT), an open-source
SEO platform with keyword research, rank tracking, site audits, and an MCP
server for AI agents. Conqueror adds the WordPress "Conquer" flow on top.
How it works
- Research — keyword research backed by DataForSEO.
- Conquer — the SAM agent turns a keyword into an article draft.
- Approve & publish — the draft lands in your connected WordPress site. You
review it and approve; publishing only ever follows your approval.
Development
New to the project? Start with
docs/ONBOARDING.md — running app plus the Conquer loop
in about fifteen minutes. Requires Node 22.18+ and pnpm.
Secrets are managed with Phase: run phase auth once, and
pnpm dev injects everything the app needs — no .env file to fill in by hand.
Without Phase it falls back to .env.local, which is how self-hosting works.
| Doc | What it covers |
|---|
| ONBOARDING.md | Day one: access to request, setup, the Conquer test loop |
| PRODUCT.md | What we're building, the north star, the trust boundary |
| ARCHITECTURE.md | Code map: request path, two DB dialects, agents, deploys |
| CONTRIBUTING.md | Branches, migrations, review, conventions |
| LOCAL_DEVELOPMENT.md | Dev server, database commands, auth modes |
| PREVIEW_DEPLOYMENTS.md | Previews, staging, production, migration safety |
| CONQUER_POC.md | Every file the Conquer flow touches |
| LOCAL_POSTGRES.md | Running the Postgres path locally (optional) |
| DATAFORSEO_API_KEY.md | Getting and setting the keyword-data key |
| SELF_HOSTING_CLOUDFLARE.md | Self-hosting on Cloudflare (also _MANUAL, _OPERATIONS) |
| SELF_HOSTING_DOCKER.md | Self-hosting with Docker |
| MAINTAINERS.md | Release notes workflow |
A local WordPress target for testing lives in
dev/wordpress/ (Docker).
Deployment
Deploys run on Cloudflare Workers via Alchemy, with
Postgres on Neon:
- Production — copy
.env.production.example → .env.production, then
pnpm deploy:postgres
- Staging — copy
.env.staging.example → .env.staging, then
pnpm deploy:staging
- PR previews — deployed automatically per pull request behind a
Cloudflare Access gate (see
.github/workflows/pr-preview.yml)
Full model: docs/PREVIEW_DEPLOYMENTS.md
License
MIT — see LICENSE. Based on OpenSEO, © Ben Senescu.