auto-geo

auto-geo

Mesin GEO sumber terbuka yang membuat merek Anda disebut di ChatGPT, Claude, Gemini, Perplexity, dan Grok.

Audit, hasilkan, perbaiki, dan lacak halaman yang dikutip oleh model bahasa besar — satu CLI, berbasis file, MIT.

Ketika seseorang bertanya kepada ChatGPT, Perplexity, Claude, Gemini, atau Google AI Overviews tentang pertanyaan yang seharusnya dijawab oleh bisnis Anda, apakah mesin tersebut mengutip domain Anda? auto-geo adalah putaran penuh untuk mewujudkannya dan membuktikan bahwa hal itu terjadi:

auto-geo init      # set up the system once
auto-geo doctor    # audit any page for citation readiness
auto-geo write     # generate publish-ready pages from target queries
auto-geo fix       # rewrite an existing page so it passes the audit
auto-geo check     # measure: do AI engines actually cite you?
auto-geo history   # track citation coverage over time

Semuanya berbasis file dan dapat dikomit — prompt yang dilacak, riwayat pemeriksaan, konfigurasi. Tanpa server, tanpa akun, tanpa basis data. Satu langkah instalasi:

npm i -g auto-geo

Dibangun oleh Shadow — laboratorium riset media yang membangun generasi berikutnya dari intelijen media dan teknologi komunikasi bertenaga AI, bermitra dengan tim yang membawa OpenAI, TikTok, Meta, Amazon, dan Lovable ke peta. Shadow menggunakan auto-geo untuk menerbitkan ke shadow.inc/resources.

---

Daftar Isi

• Mulai Cepat
• Apa itu GEO?
• Alur kerja
• auto-geo init — siapkan sistem
• auto-geo doctor — audit halaman mana pun untuk kesiapan kutipan
• auto-geo write — hasilkan halaman dari kueri
• auto-geo fix — tulis ulang halaman untuk kesiapan kutipan
• auto-geo prompts — kelola prompt yang Anda lacak
• auto-geo check — ukur cakupan kutipan aktual
• auto-geo history — cakupan kutipan dari waktu ke waktu
• Konfigurasi
• Arsitektur halaman
• Output ramah agen
• Ramah LLM
• Berkontribusi
• Lisensi

---

Mulai Cepat

0. Instal sekali (atau jalankan perintah apa pun secara satu kali lewat npx auto-geo@latest)

npm i -g auto-geo

1. Siapkan — konfigurasi, slot kunci .env.local, dan ruang kerja .auto-geo

auto-geo init

2. Tambahkan kunci API ke .env.local (dimuat otomatis oleh setiap perintah)

3. Audit halaman mana pun — milik Anda atau pesaing

auto-geo doctor https://example.com/some-page

4. Lacak prompt yang Anda inginkan agar dikutip oleh mesin AI

auto-geo prompts add "alat pemantauan media terbaik" "apa itu GEO"

5. Ukur — setiap proses disimpan ke riwayat secara otomatis

auto-geo check

6. Pantau pergerakan cakupan dari waktu ke waktu

auto-geo history

Node >=18.17 diperlukan. Peningkatan nanti adalah npm i -g auto-geo@latest. Cara lain untuk masuk:

brew install shadowresearch/tap/auto-geo # Homebrew (macOS / Linux) mise use -g npm:auto-geo # mise

Eksekusi mandiri (tanpa perlu Node) untuk macOS, Linux, dan Windows disertakan dalam setiap rilis.

---

Apa itu GEO?

Optimasi Mesin Generatif adalah disiplin membuat halaman Anda menjadi yang dikutip oleh mesin pencari AI saat menjawab pertanyaan. Ini adalah penerus SEO: alih-alih bersaing untuk peringkat dalam daftar tautan, Anda bersaing untuk dikutip di dalam jawaban.

Halaman yang menang bukanlah postingan blog. Riset empiris mengaitkan probabilitas kutipan dengan bentuk spesifik:

1. Arsitektur, bukan prosa. Blok bernama dan tervalidasi — TL;DR, intro, bagian H2 format pertanyaan, panduan terkait, poin penting, FAQ, pengungkapan. Mesin AI mengekstrak potongan terstruktur; struktur kaku meningkatkan ekstraksi.
2. Jawaban di awal. Setiap bagian dibuka dengan "kapsul jawaban" 40–60 kata yang sepenuhnya menjawab pertanyaan bagian tersebut sebelum paragraf pendukung apa pun.
3. Judul format pertanyaan. H2 ditulis sebagai pertanyaan yang benar-benar diajukan pengguna ke mesin AI.
4. Padat entitas. Entitas bernama (perusahaan, orang, produk) dengan kepadatan tinggi — terkait dengan probabilitas kutipan ~4,8x lebih tinggi.
5. Berasal dari skema. JSON-LD Article + FAQPage dihasilkan dari struktur, bukan ditulis manual.

auto-geo mengkodekan bentuk ini dalam skema ketat (lihat docs/sop.md — prosedur operasi standar lengkap), mengaudit URL apa pun terhadapnya, menghasilkan halaman baru yang sesuai, lalu menutup putaran dengan mengukur apakah mesin benar-benar mengutip Anda.

---

Alur kerja

        ┌──────────────────────────────────────────────────────┐
        │                    auto-geo init                     │
        │   config · .env.local · .auto-geo/ workspace         │
        └──────────────────────────────────────────────────────┘
              │
   ┌──────────┼──────────────┬─────────────────┐
   ▼          ▼              ▼                 ▼
 doctor     write           fix             prompts
 audit a    generate        rewrite an      track the queries
 page       new pages       existing page   that matter to you
   │          │              │                 │
   └──────────┴──────────────┴────────┬────────┘
                                      ▼
                                    check ──── saves every run ────┐
                                measure actual                     ▼
                                citations                       history
                                                            coverage over time,
                                                            newly cited / lost

doctor mengukur kesiapan (apakah halaman ini dibentuk untuk kutipan?). check mengukur hasil (apakah benar-benar dikutip?). history mengubah hasil menjadi garis tren.

---

auto-geo init — siapkan sistem

auto-geo init # interaktif (beberapa pertanyaan) auto-geo init --yes # templat non-interaktif

Satu perintah menyiapkan semuanya:

File	Apa itu
auto-geo.config.json	Default Anda — domain, penyedia, model, penulis. Dapat dikomit; tidak pernah menyimpan rahasia.
.env.local	Slot kunci API. Dimuat otomatis oleh setiap perintah. Gitignore.
.auto-geo/prompts.txt	Prompt yang Anda lacak — satu per baris, komentar # diizinkan.
.auto-geo/checks/	Setiap proses pemeriksaan, disimpan sebagai JSON. Data di balik riwayat.

Alur interaktif diakhiri dengan menanyakan prompt yang ingin Anda lacak, sehingga proyek baru beralih dari nol ke dasar kutipan terukur dalam satu sesi. init tidak pernah menimpa .env.local yang ada dan menolak menimpa konfigurasi yang ada tanpa --force.

---

auto-geo doctor — audit halaman mana pun untuk kesiapan kutipan

Jalankan pada URL apa pun — milik Anda, pesaing, setiap halaman di peta situs Anda — dan dapatkan laporan terstruktur tentang sinyal kutipan yang dicari mesin AI.

auto-geo doctor https://example.com/some-page

✓ TL;DR present (52 words, in range)
✗ Question-format H2 headings (2 of 6 are question-format; SOP §3 targets all)
✓ Article JSON-LD present
✗ FAQPage JSON-LD present (No FAQPage JSON-LD block detected)
✓ Entity density (12.3/1k words)
✗ Image cadence (0 images for 1247 words)
✓ Answer-first first paragraph
✓ No self-link in related guides

Score: 5 / 8 checks pass — moderate GEO posture

Top 3 fixes (ranked by citation lift):
  1. Add a FAQPage JSON-LD block. Each Q is a citable extraction target.
  2. Convert 4 statement-form H2 headings to question form.
  3. Add 2 images with descriptive alt text (entity + context).

Seluruh peta situs — skor rata-rata, halaman dengan skor terendah, kegagalan paling umum

auto-geo doctor --site https://example.com/sitemap.xml --max-pages 50

JSON untuk CI / dasbor

auto-geo doctor https://example.com/page --json

Kode keluar 0 jika skor ≥ 75%, 1 sebaliknya — gunakan sebagai gerbang deploy. Lihat docs/doctor.md untuk referensi pemeriksaan lengkap.

---

auto-geo write — hasilkan halaman dari kueri

Berikan domain Anda dan kueri yang ingin Anda kutip; dapatkan kembali file JSON tervalidasi dan siap publikasi — satu halaman terstruktur per kueri, sesuai dengan arsitektur GEO penuh.

auto-geo write
--query "apa itu GEO"
--query "GEO vs SEO"
--out ./resources

✓ "what is GEO"        → ./resources/geo.json (validated, ~$0.06)
✓ "GEO vs SEO"         → ./resources/geo-vs-seo.json (validated, ~$0.06)

Total: 2 pages · 2 ok · ~$0.12 spent · 31s elapsed

Prompt sistem mengkodekan SOP GEO — panjang TL;DR, jendela kapsul jawaban, superlatif terlarang, struktur FAQ — dan output dibatasi ke skema pada level sistem tipe melalui generateObject Vercel AI SDK, dengan putaran koreksi diri terbatas pada kegagalan validasi. Default: gpt-5.4 (OpenAI) atau claude-sonnet-4-6 (Anthropic), terdeteksi otomatis dari kunci API mana pun yang Anda atur.

Dry-run — rencana + estimasi biaya, tanpa panggilan LLM

auto-geo write --query "apa itu X" --dry-run

Batch dari file, anthropic, 4 halaman sekaligus

auto-geo write --queries-file queries.txt --provider anthropic --concurrency 4

Dengan file konfigurasi (auto-geo init), --domain, bidang penulis, dan penyedia berasal dari konfigurasi — --query kosong saja sudah cukup. Lihat docs/write.md.

---

auto-geo fix — tulis ulang halaman untuk kesiapan kutipan

Di mana doctor memberi tahu apa yang salah, fix menghasilkan penulisan ulang yang dioptimalkan GEO yang lolos semua 8 pemeriksaan — diambil, diaudit, diregenerasi, dan divalidasi terhadap skema yang sama yang digunakan write.

auto-geo fix https://www.example.com/some-blog-post --out ./fixed.json

Score (before):    3 / 8
Generating rewrite via openai gpt-5.4...
Score (projected): 8 / 8 — strong GEO posture
→ ./fixed.json (validated)

auto-geo fix https://example.com/page --provider anthropic # Claude sebagai gantinya auto-geo fix https://example.com/page --dry-run # hanya audit + estimasi biaya

Lihat docs/fix.md.

---

auto-geo prompts — kelola prompt yang Anda lacak

Prompt yang Anda lacak adalah pertanyaan yang Anda ingin mesin AI jawab dengan mengutip domain Anda. Mereka berada di .auto-geo/prompts.txt (teks biasa, dapat dikomit) dan itulah yang dijalankan check secara default.

auto-geo prompts add "alat pemantauan media terbaik" "apa itu GEO" auto-geo prompts # daftar bernomor auto-geo prompts rm 2 # berdasarkan indeks — atau teks persis

Tidak tahu apa yang harus dilacak? Biarkan mesin mengusulkan set prompt Anda — discover mengambil beranda Anda, melihat apa yang sudah Anda lacak, dan meminta LLM menghasilkan kueri niat tinggi yang harus Anda perebutkan:

auto-geo prompts discover --dry-run # pratinjau proposal auto-geo prompts discover --count 15 # tambahkan 15 (tidak pernah menimpa, tidak pernah duplikat)

prompts add (dan discover) mem-bootstrap ruang kerja pada penggunaan pertama, jadi Anda bahkan tidak perlu init untuk mulai melacak.

---

auto-geo check — ukur cakupan kutipan aktual

Untuk setiap prompt, tanyakan mesin pencari AI nyata dan laporkan apakah domain Anda termasuk di antara kutipan. Ini adalah kebenaran dasar yang diprediksi doctor.

auto-geo check # prompt yang dilacak, domain dari konfigurasi

  using 3 tracked prompts from .auto-geo/prompts.txt
  [1/3] ✗ "what is GEO" — not cited (5 sources)
  [2/3] ✓ "how do I get cited by ChatGPT" — cited (2 sources)
  [3/3] ✓ "open source GEO tools" — cited (1 source)

Coverage: 2/3 queries (67%) · 3 page citations total · ~$0.012 spent
  saved → .auto-geo/checks/2026-06-10T13-22-05--perplexity.json (auto-geo history)

Mesin: perplexity (default), openai, anthropic, gemini, xai (alias grok), atau --engine all — yang menjalankan setiap mesin yang kunci API-nya diatur dan melaporkan cakupan per mesin plus ringkasan gabungan.

Kueri eksplisit alih-alih set yang dilacak

auto-geo check --domain shadow.inc --query "apa itu GEO"

Setiap mesin yang Anda miliki kuncinya, cakupan gabungan

auto-geo check --engine all

CI: gagalkan deploy saat kueri kritis tidak mengutip Anda

auto-geo check --queries-file geo/critical-queries.txt && deploy

Streaming JSON untuk agen / dasbor

auto-geo check --ndjson

Setiap proses disimpan ke .auto-geo/checks/ secara otomatis (pilih keluar dengan --no-save). Kode keluar 0 jika cakupan > 0%, 1 jika 0%. Lihat docs/check.md untuk bentuk output, penangkapan kueri fan-out, aturan pencocokan domain, dan mode interop --format geo-audit.

---

auto-geo history — cakupan kutipan dari waktu ke waktu

Keuntungan menyimpan setiap proses: garis tren. Cakupan per proses dengan delta per mesin, plus prompt mana tepatnya yang mulai atau berhenti Anda dikutip.

auto-geo history

  2026-06-01 08:30  perplexity   33% ·   1/3 cited  $0.01
  2026-06-08 09:15  perplexity   67% ↑34  2/3 cited  $0.01

  Since last run (perplexity · 2026-06-01 08:30 ▸ 2026-06-08 09:15)
    ✓ newly cited  open source GEO tools
    ✗ lost         (none)

  2 runs · .auto-geo/checks

Tren membandingkan yang sebanding — setiap proses diukur terhadap proses sebelumnya dari pemilih mesin yang sama. --engine all memfilter ke proses multi-mesin; --limit N mengontrol kedalaman; --json mengeluarkan baris + delta yang dapat dibaca mesin. Lihat docs/history.md.

---

Konfigurasi

Atur sekali dengan auto-geo init, timpa di mana saja. Prioritas, tertinggi dulu:

1. Bendera CLI
2. Variabel lingkungan (penyedia terdeteksi otomatis dari kunci API mana yang diatur)
3. auto-geo.config.json (berjalan naik dari cwd — ramah monorepo)
4. Default bawaan

// auto-geo.config.json — dapat dikomit, tanpa rahasia { "domain": "https://www.example.com", "basePath": "/resources", "provider": "openai", "model": "gpt-5.4", "engine": "perplexity", "concurrency": 4, "author": { "name": "Jane Doe", "jobTitle": "Kepala Konten", "bio": "Jane menulis tentang optimasi mesin generatif…", }, }

Kunci API berada di .env.local (atau .env), dimuat otomatis oleh setiap perintah — variabel lingkungan yang sudah diatur selalu menang:

Mesin / penyedia	Var env
OpenAI (write, fix, check)	OPENAI_API_KEY
Anthropic (write, fix, check)	ANTHROPIC_API_KEY
Perplexity (check)	PERPLEXITY_API_KEY
Gemini (check)	GOOGLE_API_KEY atau GEMINI_API_KEY
xAI / Grok (check)	XAI_API_KEY

---

Arsitektur halaman

Semua yang dihasilkan write dan fix — dan semua yang diaudit doctor — mengikuti arsitektur tujuh blok yang ketat:

1. TL;DR — kapsul jawaban 40–60 kata
2. Intro — blok pengaturan konteks
3. Bagian — H2 format pertanyaan, masing-masing dibuka dengan kapsul jawaban 40–60 kata
4. Panduan Terkait — 4–8 entri
5. Poin Penting — 4–6 butir deklaratif
6. FAQ — 3–10 Tanya Jawab dengan jawaban 40–60 kata
7. Pengungkapan — catatan sumber, stempel waktu, baris penerbit Pelanggaran struktural adalah kesalahan keras (payload yang dihasilkan ditolak dan dibuat ulang); heuristik kepadatan dan irama adalah peringatan lunak. Spesifikasi lengkap: docs/architecture.md, docs/validation.md, dan SOP di balik setiap batasan: docs/sop.md.

JSON keluaran bersifat agnostik perender — POST ke CMS Anda, hidrasi templat, atau render dengan komponen Anda sendiri. Struktur adalah kontraknya.

---

Keluaran ramah agen

Setiap perintah dibangun untuk dijalankan oleh agen maupun oleh manusia:

• --json — satu objek stabil yang dapat dibaca mesin di stdout.
• --ndjson (check) — satu baris JSON per kueri saat hasil mengalir masuk, ditambah satu baris _summary.
• Progres dikirim ke stderr, hasil ke stdout — pipa tetap bersih.
• Kode keluar stabil — doctor dan check adalah gerbang CI langsung pakai.
• --no-color / NO_COLOR / deteksi non-TTY untuk keluaran ramah log.

auto-geo check --ndjson | jq 'select(.cited) | .query'

---

Ramah LLM

auto-geo adalah alat yang keluarannya berupa konten yang dimaksudkan untuk dikutip oleh LLM — jadi repo ini memakan dogfood-nya sendiri:

• llms.txt — indeks terkurasi mengikuti konvensi llmstxt.org.
• llms-full.txt — README + setiap dokumen substantif digabung dalam satu berkas untuk konsumsi satu tarikan.
• Situs GitHub Pages di shadowresearch.github.io/auto-geo — mengiklankan keduanya melalui <link rel="alternate">, memancarkan Article JSON-LD.
• AGENT.md — spesifikasi operasi ringkas untuk agen pengkode yang menjalankan CLI.

---

Berkontribusi

Lihat CONTRIBUTING.md. Laporan bug, peningkatan pemeriksaan, mesin baru, dan penyempurnaan dokumentasi semuanya diterima.

• Kode Etik
• Kebijakan Keamanan
• Changelog

---

Lisensi

MIT.

---

Tentang Shadow

Shadow adalah laboratorium riset media yang membangun generasi berikutnya dari intelijen media dan teknologi komunikasi bertenaga AI, bermitra dengan tim-tim yang membawa OpenAI, TikTok, Meta, Amazon, dan Lovable ke peta. Shadow menjalankan auto-geo secara end-to-end sesuai jadwal untuk tim riset media, PR, dan komunikasi.

Pelajari lebih lanjut di shadow.inc.