Getting Started

Get the toolkit installed and run your first GEO audit in under 10 minutes.

1. What You Need

Requirement	Version	Notes
Python	3.9+	python.org
git	any	git-scm.com
Website	—	Must be publicly accessible via HTTPS

Check your Python version:

python3 --version

2. Install

One-liner (recommended):

curl -sSL https://raw.githubusercontent.com/auriti-labs/geo-optimizer-skill/main/install.sh | bash

This script:

Clones the repo to ~/geo-optimizer-skill
Creates a Python virtual environment at ~/geo-optimizer-skill/.venv
Installs dependencies (requests, beautifulsoup4, lxml) into the venv
Creates a ./geo wrapper script that activates the venv automatically before running any script

You never need to activate the venv manually — ./geo handles it.

Custom install path? The --dir flag cannot be used with curl | bash (the flag is intercepted by bash, not the script). Download first, then pass the flag:
curl -sSL https://raw.githubusercontent.com/auriti-labs/geo-optimizer-skill/main/install.sh -o install.sh
bash install.sh --dir /custom/path

Manual alternative (if you prefer to inspect first):

git clone https://github.com/auriti-labs/geo-optimizer-skill.git ~/geo-optimizer-skill
cd ~/geo-optimizer-skill
bash install.sh

Update anytime:

bash ~/geo-optimizer-skill/update.sh

3. Your First Audit

cd ~/geo-optimizer-skill
geo audit --url https://yoursite.com

That’s it. The script fetches your homepage, robots.txt, and checks for /llms.txt, JSON-LD schema, meta tags, and content signals.

4. Reading the Output

The audit output is divided into 5 sections plus a final score.

Section 1 — ROBOTS.TXT

Shows which AI bots are explicitly configured in your robots.txt. Each bot is shown as allowed or missing.

▸ ROBOTS.TXT ─────────────────────────────────────────────
  ✅ GPTBot          allowed  (OpenAI — ChatGPT training)
  ✅ OAI-SearchBot   allowed  (OpenAI — ChatGPT citations)  ← critical
  ❌ ClaudeBot        MISSING                               ← critical
  ❌ PerplexityBot    MISSING                               ← critical

Section 2 — LLMS.TXT

Checks whether /llms.txt exists at the root of your site and whether it has content.

▸ LLMS.TXT ───────────────────────────────────────────────
  ❌ Not found at https://yoursite.com/llms.txt

Section 3 — SCHEMA JSON-LD

Lists which schema types were found in the page’s <head>.

▸ SCHEMA JSON-LD ─────────────────────────────────────────
  ✅ WebSite schema
  ❌ FAQPage schema missing
  ❌ WebApplication schema missing

Section 4 — META TAGS

Checks for title, meta description, canonical URL, and Open Graph tags.

▸ META TAGS ──────────────────────────────────────────────
  ✅ Title · Meta description · Canonical · OG tags

Section 5 — CONTENT QUALITY

Counts headings, statistics (numbers/percentages), and external citation links.

▸ CONTENT QUALITY ────────────────────────────────────────
  ✅ 12 headings  ·  3 statistics  ·  0 external citations

GEO Score:

──────────────────────────────────────────────────────────
  GEO SCORE   [████████░░░░░░░░░░░░]   55 / 100   ⚠️  NEEDS WORK
──────────────────────────────────────────────────────────

Score ranges: 0–40 Critical · 41–70 Fair · 71–90 Good · 91–100 Excellent

5. What to Fix First

Follow this priority order — each step has the highest ROI before moving to the next:

robots.txt — Add all AI bots. Takes 5 minutes. Affects whether bots can crawl you at all. → AI Bots Reference
llms.txt — Generate it from your sitemap. Takes 2 minutes. → Generating llms.txt
Schema — Add WebSite, FAQPage, WebApplication. → Schema Injector
Content — Add statistics, external citations, expert quotes. → The 9 Princeton GEO Methods

6. Update

bash ~/geo-optimizer-skill/update.sh

Pulls the latest commits, updates dependencies, and keeps your ./geo wrapper intact.