seo-intel 1.0.0

package/.env.example

@@ -0,0 +1,41 @@
+# SEO Intel Configuration
+# Run `node cli.js setup` to configure interactively
+
+# ── License (Pro features) ───────────────────────────────────────────────
+# Get your key at https://froggo.pro/seo-intel
+# SEO_INTEL_LICENSE=SI-xxxx-xxxx-xxxx-xxxx
+
+# ── Analysis Model (cloud, pick one) ──────────────────────────────────────
+# Gemini: Best value — 1M context, cheapest (~$0.01-0.05/analysis)
+GEMINI_API_KEY=
+
+# Claude: Best quality — nuanced strategic reasoning (~$0.10-0.30/analysis)
+# ANTHROPIC_API_KEY=
+
+# OpenAI: Solid all-around (~$0.05-0.15/analysis)
+# OPENAI_API_KEY=
+
+# DeepSeek: Budget cloud option (~$0.02-0.08/analysis)
+# DEEPSEEK_API_KEY=
+
+# ── OAuth (Google Search Console, Analytics) ─────────────────────────────
+# Create at: https://console.cloud.google.com/apis/credentials
+# Type: OAuth 2.0 Client ID → Desktop app
+# GOOGLE_CLIENT_ID=
+# GOOGLE_CLIENT_SECRET=
+
+# ── Extraction Model (local Ollama) ───────────────────────────────────────
+# Recommended: qwen3.5:9b (balanced), qwen3.5:4b (budget), qwen3.5:27b (quality)
+OLLAMA_URL=http://localhost:11434
+OLLAMA_MODEL=qwen3.5:9b
+OLLAMA_CTX=8192
+OLLAMA_TIMEOUT_MS=60000   # 60s default — increase to 120000 on slow hardware (BUG-008)
+
+# Fallback Ollama host (optional — for LAN setups)
+# OLLAMA_FALLBACK_URL=http://192.168.0.xxx:11434
+# OLLAMA_FALLBACK_MODEL=qwen3:4b
+
+# ── Crawler Settings ──────────────────────────────────────────────────────
+CRAWL_DELAY_MS=1500
+CRAWL_MAX_PAGES=50
+CRAWL_TIMEOUT_MS=15000

package/LICENSE

@@ -0,0 +1,75 @@
+SEO Intel — Dual License
+
+Copyright (c) 2024-2026 froggo.pro
+
+This project uses a dual license structure:
+
+================================================================================
+PART 1 — MIT License (Open Source Layer)
+================================================================================
+
+The following directories and their contents are licensed under the MIT License:
+
+  crawler/
+  db/
+  setup/
+  lib/
+  config/example.json
+  config/setup-wizard.js
+  cli.js (command routing and setup commands only)
+  server.js
+  .env.example
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the above software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+================================================================================
+PART 2 — Commercial License (Proprietary Layer)
+================================================================================
+
+The following directories and their contents are proprietary and require a
+valid SEO Intel Solo license for use:
+
+  analysis/
+  extractor/
+  reports/generate-html.js
+  reports/gsc-loader.js
+
+These files contain the competitive analysis prompts, intelligence logic,
+and report generation code that form the core intellectual property of
+SEO Intel.
+
+You MAY NOT:
+  - Copy, modify, or redistribute these files
+  - Reverse-engineer the analysis prompts or logic
+  - Include these files in derivative works without a license
+
+You MAY:
+  - Use these files as part of a validly licensed SEO Intel installation
+  - Run analyses and generate reports for your own use or client work
+  - Share generated reports and dashboards (outputs are yours)
+
+License:
+  Solo — €19.99/month or €199/year — full AI analysis, all commands
+  Also available at $9.99/month via froggo.pro marketplace
+
+Purchase at: https://ukkometa.fi or https://froggo.pro/seo-intel
+
+================================================================================
+
+For questions: hello@froggo.pro

package/README.md

@@ -0,0 +1,243 @@
+# SEO Intel
+
+Local-first competitive SEO intelligence. Point it at your site + competitors, get keyword gaps, content audits, and visual dashboards. All data stays on your machine.
+
+**Crawl → Extract (local AI) → Analyze (cloud AI) → Dashboard**
+
+```
+Your site + competitors (Playwright crawler)
+    ↓ structured extraction
+Qwen 3.5 via Ollama (local, free)
+    ↓ stored in
+SQLite database (WAL mode)
+    ↓ competitive analysis
+Gemini / Claude / GPT (your API key)
+    ↓ visual reports
+Self-contained HTML dashboards (Chart.js)
+```
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g seo-intel
+
+# Run the setup wizard (auto-detects OpenClaw for agent-powered setup)
+seo-intel setup
+```
+
+The setup wizard handles everything: dependency checks, model selection, API keys, project configuration, and pipeline validation.
+
+### Requirements
+
+- **Node.js 22.5+** (uses built-in SQLite)
+- **Ollama** with a Qwen model (for local extraction)
+- **One API key** for analysis: Gemini (recommended), Claude, OpenAI, or DeepSeek
+
+### Manual Setup
+
+```bash
+npm install -g seo-intel
+seo-intel setup --classic    # traditional CLI wizard
+# or
+seo-intel setup              # agent-powered if OpenClaw is running
+```
+
+## Usage
+
+```bash
+# Full pipeline
+seo-intel crawl myproject       # crawl target + competitors
+seo-intel extract myproject     # local AI extraction (Ollama)
+seo-intel analyze myproject     # competitive gap analysis
+seo-intel html myproject        # generate dashboard
+seo-intel serve                 # open dashboard at localhost:3000
+
+# Agentic exports — turn data into implementation briefs
+seo-intel export-actions myproject --scope technical   # free: broken links, missing schemas, orphans
+seo-intel export-actions myproject --scope all         # full: technical + competitive + suggestive
+seo-intel competitive-actions myproject --vs rival.com # what competitors have that you don't
+seo-intel suggest-usecases myproject --scope docs      # infer what pages/docs should exist
+```
+
+## Commands
+
+### Free
+
+| Command | Description |
+|---------|-------------|
+| `setup` | First-time wizard — auto-detects OpenClaw for agent-powered setup |
+| `crawl <project>` | Crawl target + competitor sites |
+| `status` | System status, crawl freshness, license info |
+| `html <project>` | Generate crawl-only dashboard |
+| `serve` | Start local dashboard server (port 3000) |
+| `export-actions <project> --scope technical` | Technical SEO audit from crawl data |
+| `schemas <project>` | Schema.org coverage analysis |
+| `update` | Check for updates |
+
+### Solo (€19.99/mo · [ukkometa.fi/seo-intel](https://ukkometa.fi/seo-intel))
+
+| Command | Description |
+|---------|-------------|
+| `extract <project>` | Local AI extraction via Ollama |
+| `analyze <project>` | Full competitive gap analysis |
+| `export-actions <project>` | All export scopes (technical + competitive + suggestive) |
+| `competitive-actions <project>` | Competitive gap export with `--vs domain` filter |
+| `suggest-usecases <project>` | Infer what pages/features to build from competitor data |
+| `keywords <project>` | Keyword gap matrix |
+| `run <project>` | Full pipeline: crawl → extract → analyze → report |
+| `brief <project>` | AI content briefs for gap topics |
+| `velocity <project>` | Content publishing velocity tracker |
+| `shallow <project>` | Find "shallow champion" pages to outrank |
+| `decay <project>` | Find stale competitor content |
+| `headings-audit <project>` | H1-H6 structure analysis |
+| `orphans <project>` | Orphaned pages detection |
+| `entities <project>` | Entity coverage gap analysis |
+| `friction <project>` | Conversion friction detection |
+| `js-delta <project>` | JS-rendered vs raw HTML comparison |
+
+## Project Configuration
+
+Create a project config in `config/`:
+
+```json
+{
+  "project": "myproject",
+  "context": {
+    "siteName": "My Site",
+    "url": "https://example.com",
+    "industry": "Your industry description",
+    "audience": "Your target audience",
+    "goal": "Your SEO objective"
+  },
+  "target": {
+    "domain": "example.com",
+    "maxPages": 200,
+    "crawlMode": "standard"
+  },
+  "competitors": [
+    { "domain": "competitor1.com", "maxPages": 100 },
+    { "domain": "competitor2.com", "maxPages": 100 }
+  ]
+}
+```
+
+Or use the setup wizard: `seo-intel setup`
+
+### Managing Competitors
+
+```bash
+seo-intel competitors myproject                    # list all
+seo-intel competitors myproject --add new-rival.com
+seo-intel competitors myproject --remove old-rival.com
+```
+
+## Web Setup Wizard
+
+```bash
+seo-intel serve
+# Open http://localhost:3000/setup
+```
+
+The 6-step web wizard guides you through:
+1. **System Check** — Node, Ollama, Playwright, GPU detection
+2. **Models** — VRAM-based model recommendations
+3. **Project** — Target domain + competitors
+4. **Search Console** — CSV upload or OAuth API
+5. **Pipeline Test** — Validates the full pipeline
+6. **Done** — Your first CLI commands
+
+If [OpenClaw](https://openclaw.ai) is running, you'll see an option for **agent-powered setup** that handles everything conversationally — including troubleshooting, dependency installation, and OAuth configuration.
+
+## Model Configuration
+
+### Extraction (local, free)
+
+SEO Intel uses Ollama for local AI extraction. Edit `.env`:
+
+```bash
+OLLAMA_URL=http://localhost:11434
+OLLAMA_MODEL=qwen3.5:9b        # recommended (needs 6GB+ VRAM)
+OLLAMA_CTX=16384
+```
+
+Model recommendations by VRAM:
+- **3-4 GB** → `qwen3.5:4b`
+- **6-8 GB** → `qwen3.5:9b` (recommended)
+- **16+ GB** → `qwen3.5:27b`
+
+### Analysis (cloud, user's API key)
+
+You need at least one API key in `.env`:
+
+```bash
+GEMINI_API_KEY=your-key          # recommended (~$0.01/analysis)
+# or
+ANTHROPIC_API_KEY=your-key       # highest quality
+# or
+OPENAI_API_KEY=your-key          # solid all-around
+# or
+DEEPSEEK_API_KEY=your-key        # budget option
+```
+
+## Google Search Console
+
+Upload your GSC data for ranking insights:
+
+1. Go to [Google Search Console](https://search.google.com/search-console)
+2. Export Performance data as CSV
+3. Upload via the web wizard or place CSVs in `gsc/<project>/`
+
+## License
+
+### Free Tier
+- 1 project, 500 pages/domain
+- Crawl, extract, setup, basic reports
+
+### Pro Tier ($49 one-time)
+- Unlimited projects and pages
+- All analysis commands, GSC insights, scheduling
+
+```bash
+# Set your license key
+echo "SEO_INTEL_LICENSE=SI-xxxx-xxxx-xxxx-xxxx" >> .env
+```
+
+Get a key at [froggo.pro/seo-intel](https://froggo.pro/seo-intel)
+
+## Updates
+
+```bash
+seo-intel update              # check for updates
+seo-intel update --apply      # auto-apply via npm
+```
+
+Updates are checked automatically in the background and shown at the end of `seo-intel status`.
+
+## Security
+
+- All data stays local — no telemetry, no cloud sync
+- Scraped content is HTML-stripped and sanitized before reaching any model
+- Extraction outputs are validated against schema before DB insert
+- API keys are stored in `.env` (gitignored)
+- OAuth tokens stored in `.tokens/` (gitignored)
+
+## OpenClaw Integration
+
+If you have [OpenClaw](https://openclaw.ai) installed:
+
+```bash
+seo-intel setup              # auto-detects gateway, uses agent
+seo-intel setup --agent      # require agent setup
+seo-intel setup --classic    # force manual wizard
+```
+
+The OpenClaw agent provides:
+- Conversational setup with real-time troubleshooting
+- Automatic dependency installation
+- Smart model recommendations
+- Security update notifications
+
+---
+
+Built by [froggo.pro](https://froggo.pro) — local-first SEO intelligence.

package/Start SEO Intel.bat

@@ -0,0 +1,9 @@
+@echo off
+title SEO Intel
+echo.
+echo   Starting SEO Intel...
+echo   Dashboard will open in your browser.
+echo.
+cd /d "%~dp0"
+node cli.js serve --open
+pause

package/Start SEO Intel.command

@@ -0,0 +1,8 @@
+#!/bin/bash
+# Double-click this file to launch SEO Intel dashboard
+cd "$(dirname "$0")"
+echo ""
+echo "  Starting SEO Intel..."
+echo "  Dashboard will open in your browser."
+echo ""
+node cli.js serve --open