中文 / 国内生态优先的开源 SEO + GEO 工具包（让站点被国内 AI 引擎抓取与引用）

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for sunxin1207 from gravatar.com sunxin1207

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT
  • Author: qingqingpi
  • Requires: Python >=3.9
  • Provides-Extra: render , mcp , dev
Report project as malware

Project description

Chinese-Geo

中文 / 国内生态优先的开源 SEO + GEO（生成式引擎优化） 工具包。 让你的网站被豆包 / DeepSeek / 文心一言 / 通义千问 / 腾讯元宝 / Kimi 等国内 AI 引擎抓得到、看得懂、更可能被引用。 国内生态是差异化核心，海外主流（ChatGPT / Claude / Perplexity / Google AI）一并覆盖——两个生态，一个工具。

现有 SEO/GEO 工具几乎全是英文 / 海外生态视角（只盯 ChatGPT / Perplexity，只认 Wikipedia / llms.txt）。Chinese-Geo 把国内这一套补全，同时不丢海外主流：国内爬虫准入、百度系结构化、知乎 / CSDN / 公众号站外矩阵、国产引擎引用监控——这是海外工具的空白。

命令行工具名为 seogeo（仓库名 Chinese-Geo）。

✨ 现在能做什么（v0）

一条命令，给你的站做 AI 可见性体检：7 个维度打分 + 中文优先级修复清单。

  • ★ 国内 AI 爬虫准入 —— robots.txt 是否放行 Baiduspider / Bytespider / PetalBot / Sogou / YisouSpider。重点查 Bytespider / 搜狗：有站长报告它们被合并进 * 或多 UA 堆叠组时仍照爬、单独成块后才停（社区经验、非官方），所以这两家仅靠 * 放行会提醒；其余几家按 RFC 9309 遵守 *、不扣分。还会探测 Bytespider 是否真被服务端硬拦（它不完全遵守 robots，robots 挡了≠真挡住），并支持反向 DNS 校验爬虫 IP 真伪——这些海外工具普遍没覆盖。
  • 海外 AI 爬虫准入 —— GPTBot / ClaudeBot / PerplexityBot / Google-Extended 等是否被挡（海外爬虫遵守 * 通配，判定规则与国内不同）。
  • AI 可发现性 —— sitemap.xml（百度 / 搜狗提交友好）。
  • 结构化数据 —— JSON-LD 存在性与合法性 + Open Graph 标签。
  • 内容可引用性 —— 唯一 H1、H2 切分、正文足量（按中文字符数，不被"中文没空格"坑到）、列表 / 表格、新鲜度（日期信号）。
  • JS 渲染可见性 —— 检测前端渲染空壳，AI 爬虫是否只看到空白页。
  • 技术基线 —— <html lang>、HTTPS、移动端 viewport。

确定性引擎，运行时零依赖（纯 Python 标准库），可进 CI、可复现。

🚀 快速开始

需要 Python 3.9+，无需任何第三方包。

git clone https://github.com/qingqingpi/Chinese-Geo
cd Chinese-Geo
pip install -e .

seogeo audit example.com                  # 体检：中文报告
seogeo audit example.com --format json    # 体检：JSON（给 agent / CI）
seogeo bots gen --sitemap https://example.com/sitemap.xml   # 生成推荐 robots.txt（国内各家单独成块）
seogeo bots verify 116.179.32.160 Baiduspider               # 反向 DNS 校验爬虫 IP 真伪
seogeo schema gen faqpage                 # 生成 JSON-LD 脚手架
seogeo llms gen --title "示例科技"          # 生成 llms.txt 脚手架（主要面向海外引擎）
seogeo init --site "示例科技"               # 一键打包 robots+llms+schema+canonical 清单 → seogeo-output/
seogeo monitor prompts --industry "智能客服"     # 生成去品牌化问题（粘进各 AI 引擎收集回答）

免安装直接跑：python -m seogeo.cli audit example.com

Claude Code 一键装成插件（含 6 个技能 + MCP），以及 Codex / Cursor 等其它 agent 的集成方式，见 INSTALL.md。

示例输出

# seogeo 体检报告：https://www.example.com
**总分 20/100 · 等级：亟需整改**

## 优先级修复清单
### 🔴 必须修
- [+20分 · ★国内 AI 爬虫准入] robots.txt 挡住了国内 AI 爬虫：Bytespider——各自单独写 User-agent 块并 Allow: /（Bytespider 不完全遵守 robots，必要时还需服务端 / WAF 硬拦）
- [+16分 · 内容可引用性] 补强：唯一 H1 主标题、H2 小节切分、正文≥300字、列表/表格
- [+16分 · 结构化] 添加 Organization / Article / FAQPage 等 JSON-LD

🧭 为什么国内要单独一套

每家国内 AI 主要"吃自己生态"：豆包 ← 抖音 / 今日头条，元宝 ← 微信公众号，文心 ← 百度百科 / 百家号，通义 ← 门户自媒体，DeepSeek / Kimi ← 知乎 / CSDN 等公网 UGC。爬虫准入、站外分发、引用监控都与海外完全不同；llms.txt 在国内基本无效，GEO 主战场是"联网检索"而非训练语料。

🗺️ 路线图

  • CLI audit：AI 可见性体检（7 类 12 项检查，确定性引擎）
  • CLI 生成半边：bots gen（推荐 robots.txt，国内各家单独成块）+ schema gen（JSON-LD 脚手架）
  • Bytespider 服务端硬拦探测（robots 挡了≠真挡住）+ 反向 DNS 真伪校验（bots verify）
  • CLI init + llms gen：一键生成 robots + llms.txt + schema 脚手架 + canonical 自查清单
  • 行动清单：预期效果（量化）+ 影响哪些引擎 + 怎么验证
  • 6 个 Agent Skill（vendor-neutral，跑在 Claude Code / Codex / CodeBuddy / Qoder / Kimi 等）：optimize 全流程总入口 / audit 体检 / structure 结构 / content 文案 / offsite 站外+实体 / monitor 引用率·SoV
  • 跨 Agent 指令层（AGENTS.md + CLAUDE.md，覆盖 Codex / opencode / Cursor / Trae / Kimi 等 30+ agent）
  • MCP server（8 工具：audit / bots_gen / schema_gen / llms_gen / monitor_prompts / monitor_run / monitor_score / offsite；可选 pip install Chinese-Geo[mcp]，跑 seogeo-mcp）
  • Claude 插件一键装（.claude-plugin/ plugin.json + marketplace + 根 .mcp.json）→ 见 INSTALL.md
  • 跨 agent 一键接入：seogeo init --agent <claude|codex|gemini|cursor|generic>（写指令文件 + .mcp.json，不覆盖已有）
  • Claude 斜杠命令（/seogeo:audit /seogeo:monitor，直接跑 CLI 注入结果）
  • CI（GitHub Actions 跑 Python 3.9–3.12 测试）+ 打 GitHub Release 自动发 PyPI
  • 引用率 / SoV 监控（零 key 手动抽样，中文友好，真 SoV）：seogeo monitor + seogeo-monitor Skill
  • 站外矩阵 + 实体权威层（知乎 / CSDN / 公众号 / 小红书…）：seogeo offsite 确定性矩阵（按引擎×受众×开放/封闭）+ seogeo-offsite skill
  • BYOK 监控自动跑引擎（自带 key 一条命令跑完各引擎）：seogeo monitor run

⚠️ 早期阶段（v0）。欢迎 issue / PR。

开发

pip install -e ".[dev]"
pytest

License

MIT © 2026 qingqingpi

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for sunxin1207 from gravatar.com sunxin1207

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT
  • Author: qingqingpi
  • Requires: Python >=3.9
  • Provides-Extra: render , mcp , dev

Release history Release notifications | RSS feed

This version

0.2.1

0.2.0

0.1.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chinese_geo-0.2.1.tar.gz (56.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chinese_geo-0.2.1-py3-none-any.whl (53.0 kB view details)

Uploaded Python 3

File details

Details for the file chinese_geo-0.2.1.tar.gz.

File metadata

  • Download URL: chinese_geo-0.2.1.tar.gz
  • Upload date:
  • Size: 56.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chinese_geo-0.2.1.tar.gz
Algorithm Hash digest
SHA256 73b2cae099264998643b4118e806ecbd58c78571869597ff90fc3c319bf52eac
MD5 783c2490a562e652c0d1cf0481a2bf2f
BLAKE2b-256 e92d96b6c899a441d9110f8af8c5f69cb6aacb0eb1c29229bfb569d4584eec38

See more details on using hashes here.

Provenance

The following attestation bundles were made for chinese_geo-0.2.1.tar.gz:

Publisher: publish.yml on qingqingpi/Chinese-Geo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chinese_geo-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: chinese_geo-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 53.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chinese_geo-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 19b9533a9c901554c4196845ec4840937d3c0d417ec9e170bbc00230cf87b9e8
MD5 4fd70c0030efac33197d0cdc132dc331
BLAKE2b-256 409d0dff303a4c3539bd92489bfb90fbd7a05b5c047e6cc78cf0eaa0c11798f5

See more details on using hashes here.

Provenance

The following attestation bundles were made for chinese_geo-0.2.1-py3-none-any.whl:

Publisher: publish.yml on qingqingpi/Chinese-Geo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page