Fangx-AI/geo-doctor

🩺 GEO 医生 – AI‑powered SEO / GEO optimisation tool

What it is – An open‑source skill (plugin) that you can install into AI‑assistant platforms (Claude Code, Codex, Kimi Code, WorkBuddy, etc.). Once installed you talk to the assistant with a single command like “帮我做 GEO” and the skill runs an eight‑step workflow that:

1. Diagnoses whether major AI crawlers (ChatGPT, Claude, DeepSeek, etc.) can read your website.
2. Collects factual data from your site and builds a “fact card”.
3. Generates realistic user questions that people might ask an AI about your product.
4. Samples the answers those AIs actually give (you paste the replies or let the skill call the APIs automatically).
5. Analyzes the recommendation rate, lists competing products that are being suggested instead of you, and pinpoints the missing content.
6. Writes SEO‑friendly copy (FAQ, comparison pages, blog posts) that directly addresses the gaps, using only verified facts.
7. Publishes the new pages to your own site, a generated “facts site”, or third‑party platforms (WordPress, dev.to, Zhihu, etc.).
8. Retests after a week to show whether the recommendation rate improved, optionally automating the whole loop via a GitHub Action.

The whole process is designed to help Chinese and international products get recommended by AI chat‑bots and search‑crawlers.

---

📦 Installation (no server needed)

• One‑line skill install – In a supported AI assistant start a new conversation and send:

帮我安装这个 skill：https://github.com/Fangx-AI/geo-doctor/tree/master/skills/geo-doctor

• The skill can also be added via the platform’s plugin marketplace, by copying the skills/geo-doctor folder to the appropriate local directory, or by uploading the released geo-doctor.zip.
• After installation, simply say “帮我做 GEO” to start the workflow.
• For users who prefer the command line, the repository ships a single‑command entry point:

npx github:Fangx-AI/geo-doctor <url> --phrase "关键正文"

which runs the AI‑crawler audit without installing the skill.

---

🛠️ Core features

Feature	What it does	Why it matters
AI‑crawler audit	Checks robots.txt, noindex, canonical tags, sitemap, structured data and whether the raw HTML contains readable text for 9 major AI crawlers.	Guarantees the site is technically visible to AI assistants.
Fact‑card generation	Extracts verified product facts from your site, price pages, docs, and flags inconsistencies.	Provides a single source of truth for later copy generation.
Question set creation	Synthesises 20‑30 realistic user queries, then selects a core set of ~10.	Mirrors the actual prompts users will give AI.
Automated sampling	Calls DeepSeek, Qwen, ChatGPT, Claude, etc. (or lets you paste manual answers) and stores every response.	Gives you raw data to compute recommendation rates.
Gap analysis & prescription	Ranks competing products, shows which questions they win, and produces a checklist of missing content.
Batch content writing	Generates one article per gap, automatically checks for placeholders, exaggerations, or unverified facts.
One‑click publishing	Deploys to static sites, WordPress, GitHub Pages, and prepares formatted drafts for Zhihu, Juejin, etc.
Continuous retesting	Re‑asks the same questions after changes, produces a before/after report, and can be scheduled weekly via a GitHub Action.
Badge & share‑card	Emits an SVG/PNG badge (e.g., AI‑crawler score 80/100) and a social‑media card you can embed on your site.

---

🚀 Quick start without installing the skill

npx github:Fangx-AI/geo-doctor https://example.com/page --phrase "关键功能描述"

• Outputs a 0‑100 score, a list of issues, and optional badge/code snippets.
• Bash (toolkit/geo-audit.sh) and PowerShell (toolkit/geo-audit.ps1) equivalents are provided for environments without Node.js.

---

📚 Documentation & community

• Handbook – Full step‑by‑step guide, playbooks for different product types, and a list of common GEO pitfalls. (docs/handbook.md)
• CI integration – GitHub Action to run the audit on every push. (docs/quickstart.md)
• Compliance guide – Rules to avoid spammy or illegal content generation. (skills/geo-doctor/references/compliance.md)
• Leaderboard – Public list of Chinese sites that block AI crawlers. (docs/ai-crawler-leaderboard.md)
• Contributions are welcomed (adding new platform cases, prompts, or fixing docs). PRs are encouraged.

---

🛡️ Safety & limits

• The audit script is zero‑dependency and only contacts the URLs you give it and the corresponding robots.txt/sitemap.xml. No data is sent to third parties.
• The tool does not guarantee that any AI will recommend your product; it only helps you fix technical and content gaps that currently prevent recommendation.
• Bulk publishing is limited to preparing drafts; actual posting to platforms like Zhihu or WeChat must be done manually to avoid account bans.
• Requires an API key for automatic sampling on platforms that expose an API (DeepSeek, ChatGPT, etc.).

---

📄 License

• Code – MIT License
• Documentation & templates – Creative Commons Attribution 4.0 (CC‑BY‑4.0)

---

🎯 Who should use it

• Product teams that rely on AI chat‑bots (国内豆包、DeepSeek, 海外 ChatGPT/Claude) for discovery.
• Marketing engineers looking to improve AI‑search visibility (GEO optimisation) without building a custom crawler.
• Developers who want a plug‑and‑play skill for their AI‑assistant workspace.

---

Bottom line: GEO 医生 is a practical, open‑source automation suite that turns AI‑assistant prompts into a repeatable SEO‑style workflow, helping you discover why AI assistants don’t surface your product and giving you the tools to fix it.