searchstack-aeo

Searchstack — AEO/GEO/SEO for AI-native founders

Open-source AEO / GEO / SEO tech stack for AI-native founders.

Monitor your visibility across Google, AI Overviews, ChatGPT, Perplexity & Claude — from one CLI.

Who is this for

• AI-native founders — you’re building a product and need to be visible in both Google AND AI search, but don’t have $400/mo for Semrush
• Indie hackers & solo devs — you ship content, want to know if it’s working, and prefer CLI over dashboards
• SEO-aware engineers — you understand technical SEO but need a tool that also covers the new AEO/GEO landscape
• Agency operators — you manage SEO for multiple clients and need automated reports you can schedule and pipe to Slack

If you’ve ever wondered “Does ChatGPT know my product exists?” — this tool answers that question.

searchstack vs The Rest

The bold rows are what traditional SEO tools (Ahrefs/Semrush) don’t do at all. That’s why searchstack exists.

What’s inside

• AEO Monitor — check if ChatGPT, Perplexity, Claude, Grok, and local models (Ollama/Qwen/Llama) cite your site when users ask about your niche
• GEO Monitor — track Google AI Overview: who gets cited for your target keywords (and whether it’s you)
• Google Search Console — rankings, clicks, impressions, CTR, indexing status, sitemap health
• Keyword Research — suggestions, volumes, competitor overlap, keyword gaps (DataForSEO)
• Position Tracking — compare rankings over time, detect improvements and drops
• Backlink Analysis — your profile + competitor backlinks, referring domains, domain rank
• Technical Audit — meta tags, JSON-LD validation, internal linking, orphan pages, on-page scoring
• Traffic Analytics — Plausible integration with AI referral breakdown (chatgpt.com, perplexity.ai, claude.ai)
• Search Submission — IndexNow (instant Bing/Yandex), Bing Webmaster, GSC sitemap resubmit
• llms.txt Generator — searchstack llms generate creates llms.txt + llms-full.txt from your sitemap following the llmstxt.org spec. Validate with searchstack llms validate.
• Content Monitor — searchstack monitor shows per-page performance: rankings, clicks, indexing status, keyword tracking, changes since last check.
• SEO Audit — searchstack audit combines GSC data with keyword volumes, calculates opportunity scores, finds content gaps.
• Doctor & Health Diagnostics — searchstack doctor tests and verifies API credentials and connectivity across all 12 services in one go.
• Visual Diff — searchstack diff tracks citation gains/losses, rank changes, and service health across consecutive snapshots.
• People Also Ask & Questions — searchstack questions extracts Google PAA questions, direct answers, and source URLs at zero extra API cost.
• Brand Entity Authority — searchstack entity inspects how Google’s Knowledge Graph categorizes your brand and evaluates authority scores.
• Markdown Reports — searchstack report generates a full 14-section .md file with executive summary and auto-recommendations. Run it monthly, diff the results, track progress over time.
• Local LLM Support — run AEO checks against Ollama, LM Studio, vLLM, or any OpenAI-compatible local model. Test how open-source models (Qwen, Llama, Mistral, Gemma) represent your brand — completely free, no API keys, runs offline.
• Google Gemini Grounding — check citations in Gemini with Google Search Grounding to inspect internal web search queries and citation sources.
• Industry Presets — launch immediately with built-in templates (--preset saas-starter, --preset developer-tools, --preset ecommerce).
• Cron-ready — pure CLI, no GUI, no browser. Deploy on any server, schedule via cron (0 8 * * 1 searchstack report), pipe output to Slack/email. Built for automation.

26+ commands. 12 API integrations (6 AI providers + local LLMs + Google/Bing). One config file. Runs anywhere Python runs.

$ searchstack ai

  Checking AI citations for example.com...

  ChatGPT (gpt-4o-mini):
    "What is the best tool for X?"      ✅ CITED
    "How to solve Y?"                    ❌ not cited
    "Top Z software in 2026"             ✅ CITED

  Perplexity (sonar):
    "What is the best tool for X?"      ✅ CITED  → https://example.com/guide
    "How to solve Y?"                    ✅ CITED  → https://example.com/docs
    "Top Z software in 2026"             ❌ not cited

  Claude (haiku):
    "What is the best tool for X?"      ❌ not cited
    "How to solve Y?"                    ❌ not cited
    "Top Z software in 2026"             ❌ not cited

  Gemini (gemini-2.5-flash):
    "What is the best tool for X?"      ✅ CITED  [searched: "best tool X 2026"]
    "How to solve Y?"                    ❌ not cited
    "Top Z software in 2026"             ✅ CITED  [searched: "top z software comparison"]

  Summary: ChatGPT 2/3 | Perplexity 2/3 | Claude 0/3 | Gemini 2/3
  Saved: ~/.searchstack/snapshots/ai_citations_20260401_1200.json

Try it free (no API keys needed)

These commands work with zero configuration — they just crawl your sitemap:

pip install searchstack

# Check meta tags on all your pages
searchstack meta

# Validate JSON-LD structured data
searchstack schema

# Find orphan pages (no internal links)
searchstack links

# Full on-page SEO score for any URL
searchstack onpage https://yoursite.com/pricing

No API keys. No accounts. No config file. Just install and run.

The Problem

Google page 1 isn’t enough anymore. 60% of Google searches now show an AI Overview that answers the query directly. ChatGPT and Perplexity are becoming primary search tools for millions of users.

Ahrefs and Semrush cost $100-400/mo and track none of this.

searchstack covers all three search layers for ~$5/mo:

Quick Start

pip install searchstack

Create .searchstack.toml:

domain = "yoursite.com"
sitemap = "https://yoursite.com/sitemap.xml"

[dataforseo]
login = "[email protected]"
password = "api-password"

[openai]
api_key = "sk-..."

[perplexity]
api_key = "pplx-..."

Run:

searchstack ai          # are AI chatbots citing you?
searchstack geo         # does Google AI Overview cite you?
searchstack gsc         # your Google rankings
searchstack report      # full 14-section Markdown report

# Or run instantly with built-in industry presets (zero manual setup):
searchstack --preset saas-starter report

See Services Setup Guide for connecting all 12 services step by step.

Commands

AEO / GEO — AI Search Visibility

searchstack ai                       # citation check: Gemini + ChatGPT + Perplexity + Claude + Grok
searchstack ai gemini                # Google Gemini (with Search Grounding)
searchstack ai chatgpt               # ChatGPT only
searchstack ai perplexity            # Perplexity only
searchstack ai claude                # Claude only
searchstack ai grok                  # Grok (xAI) only
searchstack ai ollama                # local model (Ollama/LM Studio/vLLM)
searchstack geo                      # Google AI Overview for all target keywords
searchstack geo "your keyword"       # single keyword check
searchstack entity "brand or query"  # Google Knowledge Graph entity & authority check
searchstack llms generate            # generate llms.txt + llms-full.txt from your sitemap
searchstack llms validate            # validate existing llms.txt against spec
searchstack llms check               # check if your site has AI-ready files

SEO — Google Rankings & Research

searchstack gsc                      # top queries with clicks, impressions, CTR, position
searchstack gsc discover             # Google Discover feed queries and clicks
searchstack gsc pages-perf           # top pages
searchstack gsc devices              # device breakdown (desktop, mobile, tablet)
searchstack gsc countries            # country breakdown by impressions & clicks
searchstack gsc trend                # daily trend
searchstack gsc sitemaps             # list submitted sitemaps & crawl status
searchstack gsc inspect <url>        # check if URL is indexed
searchstack questions "phrase"       # People Also Ask (PAA) questions with answers (0 cost)
searchstack keywords "phrase"        # keyword suggestions with volumes
searchstack competitors              # your ranked keywords vs competitors
searchstack competitor study <url>   # deep competitor research & propose keyword candidates
searchstack gaps                     # high-volume keywords where you rank poorly
searchstack serp "query"             # live SERP top-10 + forums/Reddit + PAA
searchstack track                    # position changes since last check
searchstack bulk domain1 domain2     # competitor traffic comparison
searchstack backlinks                # your backlink profile (DataForSEO + Bing fallback)
searchstack backlinks competitor.com # competitor's backlinks

Technical Audit — Site Health

searchstack meta                     # title/description length check
searchstack schema                   # JSON-LD structured data validation
searchstack links                    # internal linking + orphan page detection
searchstack onpage <url>             # full on-page SEO score
searchstack pages                    # indexing status of all sitemap URLs

Traffic & Submission

searchstack traffic                  # Plausible analytics + AI referral tracking
searchstack indexnow                 # submit URLs to Bing + Yandex instantly
searchstack bing                     # Bing Webmaster stats
searchstack bing submit              # submit URLs to Bing
searchstack gsc resubmit             # resubmit sitemap to Google

Diagnostics, Diff & Reporting

searchstack doctor                   # live capability check for all 12 services
searchstack diff ai                  # diff latest AI citation snapshots (+ GAINED, - LOST)
searchstack diff doctor              # diff provider health & credentials status
searchstack diff geo                 # diff Google AI Overview changes
searchstack monitor                  # site health: traffic + rankings + indexing per page
searchstack audit                    # full SEO audit with keyword volumes + opportunity scores
searchstack report                   # full Markdown report (14 sections)
searchstack --preset saas-starter report  # run with preset config

Services

12 integrations. None required — each command gracefully skips unavailable services.

Why Bing matters: ChatGPT Search, Perplexity, and Microsoft Copilot all use Bing as their search backend. If you’re not in Bing, you’re invisible to 3 major AI search products.

Local LLM setup (Ollama, LM Studio, vLLM)

Run AEO checks against local models — free, offline, no API keys:

# 1. Install Ollama and pull a model
brew install ollama
ollama pull qwen3:8b

# 2. Add to .searchstack.toml
# [ollama]
# base_url = "http://localhost:11434/v1"
# model = "qwen3:8b"

# 3. Run
searchstack ai ollama

Works with any OpenAI-compatible server:

Why test local models? Open-source LLMs (Qwen, Llama, Mistral, Gemma) are increasingly used in products, search tools, and agents. Knowing how they represent your brand helps you optimize content for the entire AI ecosystem — not just the big 4.

Monthly cost: $5-10 for full daily monitoring, $1-2 for weekly AEO/GEO only, $0 for GSC + technical audit.

Report

searchstack report generates a Markdown file with:

Sample report output

# SEO/AEO/GEO Report — 01-04-2026

> yoursite.com | Generated 2026-04-01 09:00

## Executive Summary

| Metric | Value |
|--------|-------|
| Visitors (30 days) | **1,247** |
| Google AI cites us | **0** times |
| Backlinks | 89 (from 23 domains) |
| Keyword gaps (not in top-10) | 12 |
| Positions: improved / declined | 5 / 2 |

**Status:** 🟡 Growing

## 3. Google AI Overview visibility (GEO)

- Keywords checked: 23
- AI Overview present: 18/23
- **AI cites us: 0**
- Organic top-10: 7

### Top Cited (instead of us)

| Domain | Times cited |
|--------|------------|
| competitor1.com | 8 |
| competitor2.com | 5 |
| wikipedia.org | 4 |

## 4. AI chatbot citations (AEO)

- ✅ **ChatGPT**: 3/8 queries cite us
- ✅ **Perplexity**: 5/8 queries cite us
- ❌ **Claude**: 0/8 queries cite us

## Recommendations

- 🤖 **Google AI never cites us** — improve citation-ready content
- 🎯 **12 keyword gaps** — update existing articles for these queries
- 🔗 **Low backlinks (23 domains)** — need outreach campaign

Configuration

All keys via .searchstack.toml or environment variables (env vars take priority):

export OPENAI_API_KEY="sk-..."           export PERPLEXITY_API_KEY="pplx-..."
export ANTHROPIC_API_KEY="sk-ant-..."    export XAI_API_KEY="xai-..."
export GEMINI_API_KEY="AIza..."          export OPENROUTER_API_KEY="sk-or-..."
export PLAUSIBLE_API_KEY="key"           export BING_WEBMASTER_API_KEY="key"
export DATAFORSEO_LOGIN="email"          export DATAFORSEO_PASSWORD="pass"

Full config template: docs/SERVICES.md

Architecture

src/searchstack/
├── cli.py              # argparse entry point & command routing
├── config.py           # .searchstack.toml + env loading + presets
├── snapshots.py        # JSON snapshot save/load/compare & diffing
├── providers/          # API clients (one per service)
│   ├── gsc.py            # Google Search Console (OAuth flow + Discover)
│   ├── dataforseo.py     # DataForSEO (SERP, PAA, UGC forums, async GEO)
│   ├── gemini.py         # Google Gemini (Google Search Grounding)
│   ├── plausible.py      # Plausible Analytics
│   ├── bing.py           # Bing Webmaster (inbound links & stats)
│   ├── openai.py         # OpenAI (ChatGPT)
│   ├── perplexity.py     # Perplexity
│   ├── anthropic.py      # Anthropic (Claude)
│   ├── grok.py           # Grok (xAI)
│   └── google_ads.py     # Google Ads Keyword Planner
└── commands/           # one file per CLI command
    ├── ai.py             # AEO citation check (6 engines + local)
    ├── geo.py            # GEO AI Overview monitor
    ├── entity.py         # Google Knowledge Graph brand authority
    ├── doctor.py         # 12-service live capability & credential check
    ├── diff.py           # Visual temporal diffing of snapshots
    ├── gsc_cmd.py        # Google Search Console & Discover
    ├── traffic.py        # Plausible traffic
    ├── keywords.py       # keyword suggestions
    ├── questions.py      # People Also Ask (PAA) questions
    ├── competitors.py    # competitor analysis
    ├── gaps.py           # keyword gaps
    ├── serp.py           # live SERP + UGC forums + PAA
    ├── track.py          # position tracking
    ├── backlinks.py      # backlink profile (DataForSEO + Bing fallback)
    ├── meta.py           # meta tag audit
    ├── schema.py         # JSON-LD validation
    ├── links.py          # internal linking
    ├── onpage.py         # on-page scoring
    ├── pages.py          # indexing status
    ├── indexnow.py       # IndexNow submission
    ├── bing_cmd.py       # Bing Webmaster submission & stats
    ├── report.py         # Markdown report generator
    ├── monitor.py        # Site health monitor
    ├── audit.py          # SEO audit with opportunity scores
    └── llms.py           # llms.txt generation and validation

Minimal dependencies: google-auth, google-auth-oauthlib, google-api-python-client, requests. No heavy frameworks.

Server & Cron Deployment

searchstack is a pure CLI tool — no GUI, no browser window, no interactive prompts (after initial OAuth setup). Deploy it on any Linux server and automate with cron.

Example: weekly monitoring on a VPS

# Install
pip install searchstack

# Copy your .searchstack.toml and token.pickle to the server
scp .searchstack.toml token.pickle yourserver:~/.config/searchstack/

# Add to crontab (crontab -e)
# ┌─── Weekly full report (Monday 8am)
0 8 * * 1  searchstack report >> /var/log/searchstack.log 2>&1

# ┌─── Daily position tracking
0 6 * * *  searchstack track >> /var/log/searchstack.log 2>&1

# ┌─── Submit new content to search engines (every 6 hours)
0 */6 * * *  searchstack indexnow >> /var/log/searchstack.log 2>&1

# ┌─── Weekly AEO check (Wednesday)
0 9 * * 3  searchstack ai >> /var/log/searchstack.log 2>&1

# ┌─── Weekly GEO check (Wednesday)
0 10 * * 3  searchstack geo >> /var/log/searchstack.log 2>&1

Pipe to Slack / email

# Send report to Slack via webhook
searchstack report && curl -X POST -d "{\"text\":\"$(cat ~/.searchstack/snapshots/report_$(date +%Y%m%d).md)\"}" YOUR_SLACK_WEBHOOK

# Or email it
searchstack report && mail -s "SEO Report $(date +%Y-%m-%d)" [email protected] < ~/.searchstack/snapshots/report_$(date +%Y%m%d).md

Docker (coming soon)

FROM python:3.12-slim
RUN pip install searchstack
COPY .searchstack.toml /root/.config/searchstack/config.toml
COPY token.pickle /root/.config/searchstack/
CMD ["searchstack", "report"]

Documentation

FAQ

searchstack --config /path/to/client-site.toml report

searchstack --preset saas-starter report
searchstack --preset developer-tools doctor

Roadmap

• searchstack init — interactive setup wizard
• searchstack cron — scheduled monitoring via system cron
• searchstack diff — visual diff between report snapshots (shipped in v1.0.0)
• searchstack doctor — live capability & health diagnostics (shipped in v1.0.0)
• searchstack questions — People Also Ask & question extraction (shipped in v1.0.0)
• searchstack entity — Google Knowledge Graph authority evaluation (shipped in v1.0.0)
• searchstack dashboard — local HTML dashboard
• Reddit, HackerNews, Twitter mention tracking
• YouTube search visibility
• llms.txt generation and validation (shipped in v0.1.0)
• GitHub Actions integration for CI/CD monitoring

License

MIT

Built by Alex Pospekhov