sageo

Run SEO, AEO, and GEO website audits with the Sageo CLI and generate reviewed HTML reports.

4|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/willem4130/sageo-cli --skill sageo-willem4130
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sageo
Source: https://github.com/willem4130/sageo-cli/tree/main/.claude/skills/sageo
Command: npx skills add https://github.com/willem4130/sageo-cli --skill sageo-willem4130

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Auditing a website across SEO, answer engines, and generative engines normally requires juggling many tools and browser tabs. This Skill drives the Sageo CLI as one auditable pipeline that crawls a site, pulls Google Search Console, PageSpeed, SERP, backlink, and AI-engine data, then produces evidence-backed recommendations and a client-ready HTML report. ## Core Features & Use Cases - Full audit pipeline: sageo run orchestrates crawl, audit, GSC, PSI, Labs, SERP, backlinks, AEO, and forecasting stages with budget caps, dry-run cost estimates, and resumable state under .sageo/. - AI visibility tracking: Fan prompts across ChatGPT, Claude, Gemini, and Perplexity, scan responses for brand mentions, and detect AI Overview exposure in SERPs. - Forecasting and comparison: Priority-tiered click-impact forecasts calibrated from .sageo/calibration.json, plus snapshot diffs via sageo compare to track whether recommendations worked. - Use Case: An SEO consultant runs sageo run https://client.example --budget 15, reviews LLM-drafted title and meta copy in the mandatory review gate, then hands the client a self-contained HTML report. ## Quick Start Ask the assistant to audit your website with Sageo, for example: "Run a full Sageo audit of https://example.com with a $10 budget and generate the HTML report."

Frequently Asked Questions about sageo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a full website SEO audit with Sageo?▼

Run sageo init with your site URL, authenticate GSC with sageo auth login gsc, select the property with sageo gsc sites use, then run sageo run <url> --budget N. Finish with sageo recommendations review and sageo report html to produce the client report.

How do I check brand mentions across ChatGPT, Claude, Gemini, and Perplexity?▼

Use sageo aeo responses with --all to fan a prompt out to every engine, then run the free sageo aeo mentions scan to detect your brand terms in stored responses. Paid sageo aeo mentions search adds cross-engine domain share data.

Does Sageo require paid API keys to work?▼

No. Crawl, audit, PSI, GSC, compare, snapshots, and reporting are free. Paid tiers cover SERP, Labs, and GEO micro-calls, LLM drafting via Anthropic or OpenAI keys, and backlinks which need a DataForSEO deposit.

Why does sageo run fail with GSC_NOT_CONFIGURED?▼

The pipeline hard-aborts when no Google Search Console property is selected for the project. Fix it by running sageo auth login gsc, sageo gsc sites list, then sageo gsc sites use <property>, or pass --skip gsc to opt out.

Can I trust the forecasted click numbers from Sageo?▼

Treat the priority tier (high, medium, low, unknown) as the primary signal, not a specific click number. Forecasts are uncalibrated until enough observed lift records accumulate in .sageo/calibration.json, and caveats like insufficient_data must be surfaced.

How do I track whether my SEO changes worked over time?▼

Re-run sageo run after shipping changes, then run sageo compare to diff the latest snapshot against the previous one. It infers which recommendations were addressed and appends observed lift to calibration data when paired GSC data exists.