Docs
Docs Quick Start

Quick Start

Get Contento pSEO generating pages in under five minutes.

What is Contento pSEO?

Contento pSEO is a local CLI tool that generates high-quality, niche-targeted pages using AI and structured content schemas. You define a content schema (e.g., "10 Best Tools for {subtopic}"), select your target niches, and the engine cross-multiplies niches with subtopics to produce unique, validated pages — built as static HTML and deployed to your own site on direct, on-domain paths.

Contento is not a CMS. It is a purpose-built tool for safe programmatic SEO. Every generated page includes structured JSON-LD, deterministic title patterns for SERP targeting, custom chrome (your branding header/footer), and a feedback loop from Google Search Console analytics. Every operation runs through the contento CLI on your machine, with a --json flag on every command for AI agent integration.

Prerequisites

Dependency Version Notes
Node.js 18 or later Required for the CLI
npm 9+ Included with Node.js

Install the CLI

# Install the Contento CLI globally
npm install -g contento-cli

# Verify the installation
contento --version
contento v0.1.0

Configure Your AI Provider (BYOK)

Contento has no login or central account. The CLI generates pages by talking directly to your chosen AI provider with your own API key — OpenAI, Anthropic, Groq, OpenRouter, or any OpenAI-compatible endpoint (including local models via Ollama).

# Interactive setup — pick a provider, model, and paste your key
contento config set

  ? AI Provider: OpenAI
  ? Model: gpt-4o-mini (default)
  ? API Key: ************************************
  ✓ AI configuration saved to ~/.contento/config.json
Tip: One-time setup. For CI and agents, set the provider's environment variable directly (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.) and skip config set. See CLI Reference for all supported providers and models.

First Project Setup

# Initialize a project
contento init \
    --name "DevTools Resources"

  ✓ Project created
  Project "DevTools Resources" created with ID: proj_8f3a...

# Browse niches
contento niches list --category "Software / SaaS"

# Create a collection and generate pages
contento collections create \
    --project proj_8f3a... \
    --schema "idea-list" \
    --niches "niche_01...,niche_02..."

# Generate content for the collection
contento collections generate col_9d2f...

# Build static HTML
contento build proj_8f3a... --output ./dist/articles

The generation pipeline expands subtopics, deduplicates, queues AI generation jobs, validates the output, and builds static HTML. You can monitor real-time progress directly in the terminal, then deploy with your existing pipeline.

Configuration

The CLI stores AI configuration in ~/.contento/config.json and per-project state in a contento.config.json next to your site code. See Install CLI → Configuration Files for the full layout and all environment variables.

Next Steps