Product Documentation

AI SEO Blog System Docs

Complete guide for users, teams, and internal operators to run multi-website SEO workflows.

User Workflow

1. Login with Admin Token

Open /auth and paste token. Token is saved in localStorage for real admin session flow.

2. Create Tenant + Website

Use /admin/websites to create workspace accounts and connect multiple domains safely.

3. Select Workspace Context

Pick tenant and website in header. Every API call becomes scoped to selected website.

4. Run Content Pipeline

Generate keywords, create draft, publish post, and send content to your website.

5. Connect GSC + Optimize

Connect GSC per website from Websites page, then use metrics to improve CTR and ranking.

Data Isolation Model

Tenant -> Website -> Keyword/Post/SeoMetrics. User data remains isolated per workspace.

Context Resolution

Backend resolves x-tenant-id and x-website-id with token scope checks and RBAC guards.

Distribution Layer

Posts can be consumed via pull APIs or pushed to external CMS/site webhook endpoints.

Access Control

Admin APIs are protected through token auth and role permissions: OWNER, EDITOR, VIEWER.

SEO Ranking Playbook

How to push rankings using this system in production.

- Use intent-matched keyword clusters (informational + comparison + commercial).

- Maintain consistent publishing cadence per website niche.

- Monitor impressions, clicks, CTR, and position weekly.

- Refresh pages with high impressions but low CTR using better title/meta.

- Expand pages stuck at positions 8-25 with deeper sections and internal linking.

Docs Files in Repo

Detailed markdown references for implementation and operations.

- README.md

- API.md

- docs/USER_WORKFLOW.md

- docs/SEO_RANKING_PLAYBOOK.md

- docs/INTEGRATION_GUIDE.md

- docs/MULTI_TENANT_GUIDE.md