# SEO Intel

Setup Wizard
Dashboard Terminal setup
1 System
2 Models
3 Project
4 GSC
5 Test
6 Done
Free Tier — Crawling & Raw Data

You're set up for free crawling. Data stored in SQLite. Upgrade to Solo for AI analysis and dashboards.

Get Solo at ukkometa.fi/seo-intel

Solo — All Features Unlocked

How SEO Intel Works
Crawl
Playwright fetches pages → SQLite
FREE
Extract
Ollama reads each page locally
SOLO
Analyze
Cloud AI analyzes full dataset
SOLO
Dashboard
Interactive HTML reports
SOLO

## System Check

## Models & Auth

Choose your local extraction engine and your analysis provider, then save them without rerunning the whole setup.
Extraction Hosts

Ollama (port 11434) or LM Studio (port 1234) on any machine. SEO Intel auto-detects both and falls back through configured hosts.

### Extraction Tier

Local model (Ollama or LM Studio) for structured data extraction during crawl

Or use your own model from ollama.com/search

Solo Feature
AI extraction requires a Solo or Agency license
Upgrade to Solo →

### Analysis Tier

Local or cloud model for competitive gap analysis (needs more VRAM than extraction)

Or use your own model from ollama.com/search

Add the API key to your `.env` file:

Or use OpenClaw to manage API keys automatically.

Solo Feature
AI analysis requires a Solo or Agency license
Upgrade to Solo →

### Cloud Analysis

Use cloud frontier models for analysis. Add your API key to .env

gemini-3.1-pro
Google Gemini
BEST
Highest quality Gemini — best for deep competitive analysis
GEMINI_API_KEY
claude-sonnet-4-6
Anthropic
FAST
Best cost/quality balance — fast and reliable
ANTHROPIC_API_KEY
claude-opus-4-6
Anthropic
DEEP
Deepest analysis, highest quality — slower
ANTHROPIC_API_KEY
gpt-5.4
OpenAI
SOLID
Reliable, broad knowledge — solid all-around
OPENAI_API_KEY
deepseek-r1
DeepSeek
BUDGET
Best reasoning model at budget price
DEEPSEEK_API_KEY
API Key

Or use OpenClaw to skip API key management entirely

AI-Powered Analysis
Solo unlocks local AI extraction (Ollama) and cloud-powered competitive analysis. Your data stays on your machine — AI just makes it actionable.
Ollama Extraction
Gap Analysis
Dashboards
Upgrade to Solo →
Skip this step — crawling works without AI. Upgrade anytime.

## Project Configuration

Edit project settings without rerunning the whole setup flow.
Active project
Changes here apply to the selected project.
Project Name
Target Domain
Site Name
Industry
Target Audience
SEO Goal
Competitors & owned surfaces
Manage rival domains and owned subdomains without rebuilding the rest of the project.
Owned Subdomains (optional)
Competitor Domains
Crawl Engine
Playwright — Headless Chromium. Fast (~1.5s/page). Respects robots.txt. Works on most sites. For JS-heavy or blocking sites, use `seo-intel crawl --stealth`

Estimated Throughput

Mode | Speed/page | Pages/day
--- | --- | ---

Estimated Pipeline Time

## Google Search Console

GSC data powers your ranking insights, CTR analysis, and wasted impressions detection. You can skip this step and add it later.
Project
Uploads and status checks apply to the selected project.
Checking for existing GSC data...

### How would you like to connect GSC?

Upload CSV Export
Export data from Google Search Console and upload the CSV files here. Quick and works right away.
Recommended
API Connection
Connect directly via Google service account for automatic data sync.
Coming Soon

### Upload GSC CSV Files

How to export from Google Search Console

1. Go to search.google.com/search-console
2. Select your property (domain)
3. Click Performance in the left sidebar
4. Set your date range (last 3 months recommended)
5. Click the Export button (top right) → Download CSV
6. Unzip the downloaded file — you'll get Chart.csv, Queries.csv, Pages.csv, etc.

Drop CSV files here or browse
Accepts: Chart.csv, Queries.csv, Pages.csv, Countries.csv, Devices.csv

## Pipeline Test

Run validation after model/auth changes and before a full production crawl.
Ollama Connectivity
Pending
API Key Validation
Pending
Test Crawl (1 page)
Pending
Test Extraction
Pending

## Setup Complete

Daily problem notifications
Fires a native macOS / Linux notification each morning for projects with pending criticals or warns.
…

### What's Next

Open Dashboard
Start crawling from the UI
Or via CLI
Agentic Installations
Pick your agent. Copy the prompt. Done.
$ clawhub install ukkometa/seo-intel
Set up SEO Intel (npm package: seo-intel) on my machine. Steps: 1) Verify Node.js ≥22.5 and npm are installed. 2) Install Ollama and pull the gemma4:e4b model (default extraction engine, ~4GB). 3) Run `seo-intel setup` to create a project config — ask me for my website URL and up to 3 competitor URLs. 4) Run a test crawl with `seo-intel crawl <project>` to verify everything works. 5) Run `seo-intel extract <project>` to test local AI extraction. Report any errors with full context.
Set up the npm package `seo-intel` on this machine. Requirements: Node.js ≥22.5, Ollama with gemma4:e4b model (~4GB download). Create a project config for my website — ask me for my URL and competitor domains. Then run a test crawl (`seo-intel crawl <project>`) and extraction (`seo-intel extract <project>`). The tool stores data in SQLite locally. If Ollama isn't installed, install it from ollama.com. After setup, open the dashboard with `seo-intel serve`.
Install and configure the `seo-intel` npm package. Needs: Node.js ≥22.5, Ollama running locally with `gemma4:e4b` pulled. Create a JSON config at configs/<project>.json with target URL + competitor URLs (ask me). Run the full pipeline: `seo-intel crawl <project>` → `seo-intel extract <project>` → `seo-intel serve` to open the dashboard. Needs full disk access for Playwright browser automation.
I want to install SEO Intel (seo-intel on npm), a local-first SEO competitor analysis tool. Walk me through: 1) Installing Node.js 22.5+ if I don't have it. 2) Installing Ollama and downloading the Gemma 4 e4b model for AI extraction. 3) Running `npx seo-intel setup` to configure my first project. I need to provide my website URL and competitor URLs. 4) Testing the crawl pipeline. Ask me for my website URL to get started.

Cloud frontier models for competitive analysis. Add API keys in the Models step, or use OpenClaw for automatic key management.

Checking connections...

Set up API keys in the Models & Auth step, or use OpenClaw to skip key management entirely.

### Agent Setup

Connecting to OpenClaw agent...
Agent is thinking...