DEV Community

FangXin
FangXin

Posted on

GEO for small teams with no server

A small team can do GEO (generative engine optimization) without a server: run the work from an AI assistant or the command line on your own machine, host the fact site on free GitHub Pages, and let GitHub Actions run the weekly re-check. The free, open-source GEO Doctor (geo-doctor) is built that way: no server, no database.

1. List the questions people ask AI

Write about ten questions in your users' words, in three kinds: recommendation questions that do not name you ("Is there a budgeting app that works offline?"), fact questions about you ("Is that app free?"), and cases you do not fit, to see whether AI wrongly suggests you.

2. Build a fact card

Write down your name, what the product does, price, who it is and is not for, and how it differs from alternatives, with a source for each line, and confirm each one. Everything you publish afterwards uses only these facts, so AI sees one consistent story.

3. Ask the AIs and find gaps

GEO Doctor asks DeepSeek, Qwen, Kimi, Doubao, Yuanbao, ChatGPT, Perplexity, Gemini and Claude through their APIs, saves every answer, and lists the questions where a competitor is recommended and you are not, per AI. API answers can differ from the apps, so confirm important findings by hand.

4. Write for the gaps and put it where AI can read it

  • One answer-style article per gap, using only confirmed facts. GEO Doctor checks drafts for placeholders, hype, unconfirmed facts and duplicates, and a person approves each one.
  • A fact site built from the fact card (fact page, FAQ, llms.txt, structured data) on free GitHub Pages.
  • A quick readability check of your own site: robots.txt, AI crawlers, noindex, visible text.

5. Re-check every week

With the project on GitHub and an API key set, GEO Doctor samples weekly, drafts for new gaps, writes a report and opens a pull request for you to review. It does not promise rankings; it reports the count as it is.

Cost and data

Free and MIT-licensed; only the AI API calls cost money, on your own account. Works with Claude Code, Codex, Kimi Code, AI clients that accept skill packages, and Node.js 18+, plus a local web console with a button for each step. Data is plain files in geo/; API keys come only from environment variables.

Source: https://github.com/Fangx-AI/geo-doctor

Disclosure: I maintain GEO Doctor, and this article was drafted with AI assistance (Claude) and reviewed by me.

Top comments (0)