← Back to work

Project · Open source

Chinese-Geo

An open-source visibility audit for sites that need to be found and cited by Chinese AI search. One command checks crawlers, citability, structured data, and distribution gaps.

Why it matters

AI discovery is not one global index. Content that works for Google and ChatGPT can still disappear from China’s retrieval ecosystems.

  • 2026
  • Solo project
  • Python · zero runtime deps
  • MIT
  • On PyPI
Chinese-Geo — a knowledge graph of domestic AI engines crawling and citing a site

Why existing GEO tools miss the Chinese web

I wanted to know whether a Chinese website could actually be found by China’s AI search products. Most SEO / GEO tools could not answer that. They watch ChatGPT and Perplexity, understand sources such as Wikipedia and llms.txt, and largely stop there.

China has a different retrieval and distribution landscape. Doubao commonly surfaces Douyin / Toutiao, Tencent Yuanbao connects naturally to WeChat official accounts, ERNIE to Baidu Baike / Baijiahao, Qwen to portals and creator media, and DeepSeek / Kimi to sources such as Zhihu / CSDN. These are common entry points, not exclusive feeds. Crawler access, off-site distribution, and citation monitoring all differ, so the practical battlefield is live retrieval rather than training data.

Common content entry points for Chinese AI platforms: Doubao with Douyin and Toutiao, Tencent Yuanbao with WeChat Official Accounts, ERNIE with Baidu Baike and Baijiahao, Qwen with portals and creator media, and DeepSeek or Kimi with Zhihu and CSDN
This is a distribution priority map, not a closed list. Publishing into the right retrieval ecosystems matters more than waiting on an independent site alone.

Nobody was filling that gap, so I built the audit I wanted: China-first, but still useful for the global search and AI layer.

I turned it into an audit you can act on

I boiled the core down to one command: an AI-visibility audit for any site. I didn't want it to just say "go do some SEO" — so it hands you something concrete: a score across 7 dimensions plus a prioritized fix list — whether domestic / overseas crawlers are let in, whether your sitemap is findable, structured data, content citability, JS-render shells, technical baseline. Each item tells you where you're losing points, what fixing it is worth, which engines it affects, and how to verify. A deterministic engine, happy to run in CI.

The best test was my own site. The first run scored 91. Then I looked at the report and realized the site was not wrong — the audit engine was.

The tool marked my site down. The tool was wrong.

I didn't change the site — I changed the tool. Turning it on myself surfaced its own blind spot, and I went back and made the engine honest. That loop — dare to test on a real site, fix the engine when it's wrong — convinces me more than running a few more cases. Beyond the audit it also generates recommended robots.txt, JSON-LD and llms.txt scaffolds, monitors citation rate / SoV inside domestic engines, and lays out an off-site matrix for Zhihu / CSDN / WeChat.

Before I was willing to hand it to someone else

I set myself one bar: it had to be something I would trust on a real site. So I did not cut corners here:

  • Adding a new check takes me minutes. One rule = one @register file plus one import; the pipeline finds it on its own, no touching the core — so it keeps growing as each engine changes.
  • It's solid enough that I'd put it in production. Zero runtime dependencies (pure Python stdlib), 500+ tests of real assertions, CI across Python 3.9–3.12, auto-publish to PyPI on tag, and I added SSRF protection in the fetch layer.
  • It genuinely understands China — the part I think is hardest to replace. I built a double-check for Bytespider's "robots-blocked ≠ really blocked", measured body length by Chinese character count (so "Chinese has no spaces" can't fool it), and verify crawler IPs by reverse DNS — things overseas tools generally lack.

Four ways in

I shipped it in four shapes — use whichever fits your workflow:

  • CLI: pip install Chinese-Geo, then chinese-geo audit example.com.
  • 6 Agent Skills (vendor-neutral, run in Claude Code / Codex / Kimi…): audit → rewrite → off-site, end to end.
  • MCP server: 8 tools, plug into any MCP-capable agent.
  • Claude Code plugin: one-click install with slash commands.

Quick start

Audit one site first

Command line

Install it (Python 3.9+):

pip install Chinese-Geo

Run an AI-visibility audit:

chinese-geo audit example.com

The report scores seven dimensions and returns a prioritized fix list. Add --format json when you want it in CI.

For AI agents

Claude Code installs the 6 Agent Skills and MCP server together:

/plugin marketplace add qingqingpi/Chinese-Geo
/plugin install chinese-geo

For Codex, Cursor, Kimi, or another agent, run chinese-geo init --agent codex (or the matching agent name). It writes the instruction and MCP config without overwriting existing content.