PyPI - Chinese-Geo - Versions diffs - 0.1.1__tar.gz - Mend

Chinese-Geo 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (67) hide show

chinese_geo-0.1.1/Chinese_Geo.egg-info/PKG-INFO +114 -0
chinese_geo-0.1.1/Chinese_Geo.egg-info/SOURCES.txt +65 -0
chinese_geo-0.1.1/Chinese_Geo.egg-info/dependency_links.txt +1 -0
chinese_geo-0.1.1/Chinese_Geo.egg-info/entry_points.txt +3 -0
chinese_geo-0.1.1/Chinese_Geo.egg-info/requires.txt +9 -0
chinese_geo-0.1.1/Chinese_Geo.egg-info/top_level.txt +1 -0
chinese_geo-0.1.1/LICENSE +21 -0
chinese_geo-0.1.1/PKG-INFO +114 -0
chinese_geo-0.1.1/README.md +94 -0
chinese_geo-0.1.1/pyproject.toml +31 -0
chinese_geo-0.1.1/seogeo/__init__.py +1 -0
chinese_geo-0.1.1/seogeo/botverify.py +56 -0
chinese_geo-0.1.1/seogeo/cli.py +249 -0
chinese_geo-0.1.1/seogeo/data/__init__.py +0 -0
chinese_geo-0.1.1/seogeo/data/domestic_bots.py +23 -0
chinese_geo-0.1.1/seogeo/data/overseas_bots.py +21 -0
chinese_geo-0.1.1/seogeo/data/platforms.py +53 -0
chinese_geo-0.1.1/seogeo/dom.py +89 -0
chinese_geo-0.1.1/seogeo/engines.py +79 -0
chinese_geo-0.1.1/seogeo/fetch.py +64 -0
chinese_geo-0.1.1/seogeo/generate.py +198 -0
chinese_geo-0.1.1/seogeo/mcp_server.py +98 -0
chinese_geo-0.1.1/seogeo/monitor.py +101 -0
chinese_geo-0.1.1/seogeo/offsite.py +31 -0
chinese_geo-0.1.1/seogeo/pipeline.py +35 -0
chinese_geo-0.1.1/seogeo/report.py +117 -0
chinese_geo-0.1.1/seogeo/robots.py +102 -0
chinese_geo-0.1.1/seogeo/rules/__init__.py +18 -0
chinese_geo-0.1.1/seogeo/rules/base.py +80 -0
chinese_geo-0.1.1/seogeo/rules/bytespider.py +37 -0
chinese_geo-0.1.1/seogeo/rules/content.py +42 -0
chinese_geo-0.1.1/seogeo/rules/discovery.py +27 -0
chinese_geo-0.1.1/seogeo/rules/domestic_bots.py +58 -0
chinese_geo-0.1.1/seogeo/rules/freshness.py +23 -0
chinese_geo-0.1.1/seogeo/rules/https.py +17 -0
chinese_geo-0.1.1/seogeo/rules/opengraph.py +24 -0
chinese_geo-0.1.1/seogeo/rules/overseas_bots.py +46 -0
chinese_geo-0.1.1/seogeo/rules/rendering.py +39 -0
chinese_geo-0.1.1/seogeo/rules/structure.py +41 -0
chinese_geo-0.1.1/seogeo/rules/technical.py +18 -0
chinese_geo-0.1.1/seogeo/rules/viewport.py +18 -0
chinese_geo-0.1.1/seogeo/scoring.py +43 -0
chinese_geo-0.1.1/seogeo/service.py +51 -0
chinese_geo-0.1.1/setup.cfg +4 -0
chinese_geo-0.1.1/tests/test_botverify.py +61 -0
chinese_geo-0.1.1/tests/test_bytespider.py +36 -0
chinese_geo-0.1.1/tests/test_content.py +34 -0
chinese_geo-0.1.1/tests/test_discovery.py +32 -0
chinese_geo-0.1.1/tests/test_dom.py +55 -0
chinese_geo-0.1.1/tests/test_domestic_bots.py +61 -0
chinese_geo-0.1.1/tests/test_engines.py +75 -0
chinese_geo-0.1.1/tests/test_fetch.py +45 -0
chinese_geo-0.1.1/tests/test_generate.py +176 -0
chinese_geo-0.1.1/tests/test_meta_rules.py +59 -0
chinese_geo-0.1.1/tests/test_monitor.py +63 -0
chinese_geo-0.1.1/tests/test_offsite.py +67 -0
chinese_geo-0.1.1/tests/test_overseas_bots.py +42 -0
chinese_geo-0.1.1/tests/test_packaging.py +40 -0
chinese_geo-0.1.1/tests/test_pipeline.py +70 -0
chinese_geo-0.1.1/tests/test_registry.py +56 -0
chinese_geo-0.1.1/tests/test_rendering.py +27 -0
chinese_geo-0.1.1/tests/test_report.py +92 -0
chinese_geo-0.1.1/tests/test_robots.py +93 -0
chinese_geo-0.1.1/tests/test_scoring.py +46 -0
chinese_geo-0.1.1/tests/test_skills.py +48 -0
chinese_geo-0.1.1/tests/test_structure.py +28 -0
chinese_geo-0.1.1/tests/test_technical.py +22 -0

chinese_geo-0.1.1/Chinese_Geo.egg-info/PKG-INFO ADDED Viewed

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: Chinese-Geo
+Version: 0.1.1
+Summary: 中文 / 国内生态优先的开源 SEO + GEO 工具包（让站点被国内 AI 引擎抓取与引用）
+Author: qingqingpi
+License: MIT
+Project-URL: Homepage, https://github.com/qingqingpi/Chinese-Geo
+Project-URL: Repository, https://github.com/qingqingpi/Chinese-Geo
+Project-URL: Issues, https://github.com/qingqingpi/Chinese-Geo/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: render
+Requires-Dist: playwright>=1.40; extra == "render"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Dynamic: license-file
+# 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 是否真被服务端硬拦**（它不守 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+，无需任何第三方包。
+```bash
+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](INSTALL.md)**。
+### 示例输出
+```
+# seogeo 体检报告：https://www.example.com
+**总分 20/100 · 等级：亟需整改**
+## 优先级修复清单
+### 🔴 必须修
+- [+20分 · ★国内 AI 爬虫准入] 为 Bytespider, PetalBot 各自单独写 User-agent 块并 Allow: /（合并进 * 通配段会被忽略）
+- [+16分 · 内容可引用性] 补强：唯一 H1 主标题、H2 小节切分、正文≥300字、列表/表格
+- [+16分 · 结构化] 添加 Organization / Article / FAQPage 等 JSON-LD
+```
+## 🧭 为什么国内要单独一套
+每家国内 AI 主要"吃自己生态"：豆包 ← 抖音 / 今日头条，元宝 ← 微信公众号，文心 ← 百度百科 / 百家号，通义 ← 门户自媒体，DeepSeek / Kimi ← 知乎 / CSDN 等公网 UGC。爬虫准入、站外分发、引用监控都与海外完全不同；llms.txt 在国内基本无效，GEO 主战场是"联网检索"而非训练语料。
+## 🗺️ 路线图
+- [x] CLI `audit`：AI 可见性体检（7 类 12 项检查，确定性引擎）
+- [x] CLI 生成半边：`bots gen`（推荐 robots.txt，国内各家单独成块）+ `schema gen`（JSON-LD 脚手架）
+- [x] Bytespider 服务端硬拦探测（robots 挡了≠真挡住）+ 反向 DNS 真伪校验（`bots verify`）
+- [x] CLI `init` + `llms gen`：一键生成 robots + llms.txt + schema 脚手架 + canonical 自查清单
+- [ ] 行动清单：预期效果（量化）+ 影响哪些引擎 + 怎么验证
+- [x] 6 个 Agent Skill（vendor-neutral，跑在 Claude Code / Codex / CodeBuddy / Qoder / Kimi 等）：**optimize 全流程总入口** / audit 体检 / structure 结构 / content 文案 / offsite 站外+实体 / monitor 引用率·SoV
+- [x] 跨 Agent 指令层（`AGENTS.md` + `CLAUDE.md`，覆盖 Codex / opencode / Cursor / Trae / Kimi 等 30+ agent）
+- [x] MCP server（8 工具：audit / bots_gen / schema_gen / llms_gen / monitor_prompts / monitor_run / monitor_score / offsite；可选 `pip install Chinese-Geo[mcp]`，跑 `seogeo-mcp`）
+- [x] Claude 插件一键装（`.claude-plugin/` plugin.json + marketplace + 根 `.mcp.json`）→ 见 [INSTALL.md](INSTALL.md)
+- [x] 跨 agent 一键接入：`seogeo init --agent <claude|codex|gemini|cursor|generic>`（写指令文件 + `.mcp.json`，不覆盖已有）
+- [x] Claude 斜杠命令（`/seogeo:audit` `/seogeo:monitor`，直接跑 CLI 注入结果）
+- [x] CI（GitHub Actions 跑 Python 3.9–3.12 测试）+ 打 GitHub Release 自动发 PyPI
+- [x] 引用率 / SoV 监控（零 key 手动抽样，中文友好，真 SoV）：`seogeo monitor` + seogeo-monitor Skill
+- [x] 站外矩阵 + 实体权威层（知乎 / CSDN / 公众号 / 小红书…）：`seogeo offsite` 确定性矩阵（按引擎×受众×开放/封闭）+ `seogeo-offsite` skill
+- [x] BYOK 监控自动跑引擎（自带 key 一条命令跑完各引擎）：`seogeo monitor run`
+> ⚠️ 早期阶段（v0）。欢迎 issue / PR。
+## 开发
+```bash
+pip install -e ".[dev]"
+pytest
+```
+## License
+MIT © 2026 qingqingpi

chinese_geo-0.1.1/Chinese_Geo.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,65 @@
+LICENSE
+README.md
+pyproject.toml
+Chinese_Geo.egg-info/PKG-INFO
+Chinese_Geo.egg-info/SOURCES.txt
+Chinese_Geo.egg-info/dependency_links.txt
+Chinese_Geo.egg-info/entry_points.txt
+Chinese_Geo.egg-info/requires.txt
+Chinese_Geo.egg-info/top_level.txt
+seogeo/__init__.py
+seogeo/botverify.py
+seogeo/cli.py
+seogeo/dom.py
+seogeo/engines.py
+seogeo/fetch.py
+seogeo/generate.py
+seogeo/mcp_server.py
+seogeo/monitor.py
+seogeo/offsite.py
+seogeo/pipeline.py
+seogeo/report.py
+seogeo/robots.py
+seogeo/scoring.py
+seogeo/service.py
+seogeo/data/__init__.py
+seogeo/data/domestic_bots.py
+seogeo/data/overseas_bots.py
+seogeo/data/platforms.py
+seogeo/rules/__init__.py
+seogeo/rules/base.py
+seogeo/rules/bytespider.py
+seogeo/rules/content.py
+seogeo/rules/discovery.py
+seogeo/rules/domestic_bots.py
+seogeo/rules/freshness.py
+seogeo/rules/https.py
+seogeo/rules/opengraph.py
+seogeo/rules/overseas_bots.py
+seogeo/rules/rendering.py
+seogeo/rules/structure.py
+seogeo/rules/technical.py
+seogeo/rules/viewport.py
+tests/test_botverify.py
+tests/test_bytespider.py
+tests/test_content.py
+tests/test_discovery.py
+tests/test_dom.py
+tests/test_domestic_bots.py
+tests/test_engines.py
+tests/test_fetch.py
+tests/test_generate.py
+tests/test_meta_rules.py
+tests/test_monitor.py
+tests/test_offsite.py
+tests/test_overseas_bots.py
+tests/test_packaging.py
+tests/test_pipeline.py
+tests/test_registry.py
+tests/test_rendering.py
+tests/test_report.py
+tests/test_robots.py
+tests/test_scoring.py
+tests/test_skills.py
+tests/test_structure.py
+tests/test_technical.py

chinese_geo-0.1.1/Chinese_Geo.egg-info/dependency_links.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+

chinese_geo-0.1.1/Chinese_Geo.egg-info/entry_points.txt ADDED Viewed

@@ -0,0 +1,3 @@
+[console_scripts]
+seogeo = seogeo.cli:main
+seogeo-mcp = seogeo.mcp_server:main

chinese_geo-0.1.1/Chinese_Geo.egg-info/requires.txt ADDED Viewed

@@ -0,0 +1,9 @@
+[dev]
+pytest>=7
+[mcp]
+mcp>=1.0
+[render]
+playwright>=1.40

chinese_geo-0.1.1/Chinese_Geo.egg-info/top_level.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ seogeo

chinese_geo-0.1.1/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 qingqingpi
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chinese_geo-0.1.1/PKG-INFO ADDED Viewed

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: Chinese-Geo
+Version: 0.1.1
+Summary: 中文 / 国内生态优先的开源 SEO + GEO 工具包（让站点被国内 AI 引擎抓取与引用）
+Author: qingqingpi
+License: MIT
+Project-URL: Homepage, https://github.com/qingqingpi/Chinese-Geo
+Project-URL: Repository, https://github.com/qingqingpi/Chinese-Geo
+Project-URL: Issues, https://github.com/qingqingpi/Chinese-Geo/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: render
+Requires-Dist: playwright>=1.40; extra == "render"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Dynamic: license-file
+# 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 是否真被服务端硬拦**（它不守 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+，无需任何第三方包。
+```bash
+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](INSTALL.md)**。
+### 示例输出
+```
+# seogeo 体检报告：https://www.example.com
+**总分 20/100 · 等级：亟需整改**
+## 优先级修复清单
+### 🔴 必须修
+- [+20分 · ★国内 AI 爬虫准入] 为 Bytespider, PetalBot 各自单独写 User-agent 块并 Allow: /（合并进 * 通配段会被忽略）
+- [+16分 · 内容可引用性] 补强：唯一 H1 主标题、H2 小节切分、正文≥300字、列表/表格
+- [+16分 · 结构化] 添加 Organization / Article / FAQPage 等 JSON-LD
+```
+## 🧭 为什么国内要单独一套
+每家国内 AI 主要"吃自己生态"：豆包 ← 抖音 / 今日头条，元宝 ← 微信公众号，文心 ← 百度百科 / 百家号，通义 ← 门户自媒体，DeepSeek / Kimi ← 知乎 / CSDN 等公网 UGC。爬虫准入、站外分发、引用监控都与海外完全不同；llms.txt 在国内基本无效，GEO 主战场是"联网检索"而非训练语料。
+## 🗺️ 路线图
+- [x] CLI `audit`：AI 可见性体检（7 类 12 项检查，确定性引擎）
+- [x] CLI 生成半边：`bots gen`（推荐 robots.txt，国内各家单独成块）+ `schema gen`（JSON-LD 脚手架）
+- [x] Bytespider 服务端硬拦探测（robots 挡了≠真挡住）+ 反向 DNS 真伪校验（`bots verify`）
+- [x] CLI `init` + `llms gen`：一键生成 robots + llms.txt + schema 脚手架 + canonical 自查清单
+- [ ] 行动清单：预期效果（量化）+ 影响哪些引擎 + 怎么验证
+- [x] 6 个 Agent Skill（vendor-neutral，跑在 Claude Code / Codex / CodeBuddy / Qoder / Kimi 等）：**optimize 全流程总入口** / audit 体检 / structure 结构 / content 文案 / offsite 站外+实体 / monitor 引用率·SoV
+- [x] 跨 Agent 指令层（`AGENTS.md` + `CLAUDE.md`，覆盖 Codex / opencode / Cursor / Trae / Kimi 等 30+ agent）
+- [x] MCP server（8 工具：audit / bots_gen / schema_gen / llms_gen / monitor_prompts / monitor_run / monitor_score / offsite；可选 `pip install Chinese-Geo[mcp]`，跑 `seogeo-mcp`）
+- [x] Claude 插件一键装（`.claude-plugin/` plugin.json + marketplace + 根 `.mcp.json`）→ 见 [INSTALL.md](INSTALL.md)
+- [x] 跨 agent 一键接入：`seogeo init --agent <claude|codex|gemini|cursor|generic>`（写指令文件 + `.mcp.json`，不覆盖已有）
+- [x] Claude 斜杠命令（`/seogeo:audit` `/seogeo:monitor`，直接跑 CLI 注入结果）
+- [x] CI（GitHub Actions 跑 Python 3.9–3.12 测试）+ 打 GitHub Release 自动发 PyPI
+- [x] 引用率 / SoV 监控（零 key 手动抽样，中文友好，真 SoV）：`seogeo monitor` + seogeo-monitor Skill
+- [x] 站外矩阵 + 实体权威层（知乎 / CSDN / 公众号 / 小红书…）：`seogeo offsite` 确定性矩阵（按引擎×受众×开放/封闭）+ `seogeo-offsite` skill
+- [x] BYOK 监控自动跑引擎（自带 key 一条命令跑完各引擎）：`seogeo monitor run`
+> ⚠️ 早期阶段（v0）。欢迎 issue / PR。
+## 开发
+```bash
+pip install -e ".[dev]"
+pytest
+```
+## License
+MIT © 2026 qingqingpi

chinese_geo-0.1.1/README.md ADDED Viewed

@@ -0,0 +1,94 @@
+# 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 是否真被服务端硬拦**（它不守 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+，无需任何第三方包。
+```bash
+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](INSTALL.md)**。
+### 示例输出
+```
+# seogeo 体检报告：https://www.example.com
+**总分 20/100 · 等级：亟需整改**
+## 优先级修复清单
+### 🔴 必须修
+- [+20分 · ★国内 AI 爬虫准入] 为 Bytespider, PetalBot 各自单独写 User-agent 块并 Allow: /（合并进 * 通配段会被忽略）
+- [+16分 · 内容可引用性] 补强：唯一 H1 主标题、H2 小节切分、正文≥300字、列表/表格
+- [+16分 · 结构化] 添加 Organization / Article / FAQPage 等 JSON-LD
+```
+## 🧭 为什么国内要单独一套
+每家国内 AI 主要"吃自己生态"：豆包 ← 抖音 / 今日头条，元宝 ← 微信公众号，文心 ← 百度百科 / 百家号，通义 ← 门户自媒体，DeepSeek / Kimi ← 知乎 / CSDN 等公网 UGC。爬虫准入、站外分发、引用监控都与海外完全不同；llms.txt 在国内基本无效，GEO 主战场是"联网检索"而非训练语料。
+## 🗺️ 路线图
+- [x] CLI `audit`：AI 可见性体检（7 类 12 项检查，确定性引擎）
+- [x] CLI 生成半边：`bots gen`（推荐 robots.txt，国内各家单独成块）+ `schema gen`（JSON-LD 脚手架）
+- [x] Bytespider 服务端硬拦探测（robots 挡了≠真挡住）+ 反向 DNS 真伪校验（`bots verify`）
+- [x] CLI `init` + `llms gen`：一键生成 robots + llms.txt + schema 脚手架 + canonical 自查清单
+- [ ] 行动清单：预期效果（量化）+ 影响哪些引擎 + 怎么验证
+- [x] 6 个 Agent Skill（vendor-neutral，跑在 Claude Code / Codex / CodeBuddy / Qoder / Kimi 等）：**optimize 全流程总入口** / audit 体检 / structure 结构 / content 文案 / offsite 站外+实体 / monitor 引用率·SoV
+- [x] 跨 Agent 指令层（`AGENTS.md` + `CLAUDE.md`，覆盖 Codex / opencode / Cursor / Trae / Kimi 等 30+ agent）
+- [x] MCP server（8 工具：audit / bots_gen / schema_gen / llms_gen / monitor_prompts / monitor_run / monitor_score / offsite；可选 `pip install Chinese-Geo[mcp]`，跑 `seogeo-mcp`）
+- [x] Claude 插件一键装（`.claude-plugin/` plugin.json + marketplace + 根 `.mcp.json`）→ 见 [INSTALL.md](INSTALL.md)
+- [x] 跨 agent 一键接入：`seogeo init --agent <claude|codex|gemini|cursor|generic>`（写指令文件 + `.mcp.json`，不覆盖已有）
+- [x] Claude 斜杠命令（`/seogeo:audit` `/seogeo:monitor`，直接跑 CLI 注入结果）
+- [x] CI（GitHub Actions 跑 Python 3.9–3.12 测试）+ 打 GitHub Release 自动发 PyPI
+- [x] 引用率 / SoV 监控（零 key 手动抽样，中文友好，真 SoV）：`seogeo monitor` + seogeo-monitor Skill
+- [x] 站外矩阵 + 实体权威层（知乎 / CSDN / 公众号 / 小红书…）：`seogeo offsite` 确定性矩阵（按引擎×受众×开放/封闭）+ `seogeo-offsite` skill
+- [x] BYOK 监控自动跑引擎（自带 key 一条命令跑完各引擎）：`seogeo monitor run`
+> ⚠️ 早期阶段（v0）。欢迎 issue / PR。
+## 开发
+```bash
+pip install -e ".[dev]"
+pytest
+```
+## License
+MIT © 2026 qingqingpi

chinese_geo-0.1.1/pyproject.toml ADDED Viewed

@@ -0,0 +1,31 @@
+[project]
+name = "Chinese-Geo"
+version = "0.1.1"
+description = "中文 / 国内生态优先的开源 SEO + GEO 工具包（让站点被国内 AI 引擎抓取与引用）"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "qingqingpi"}]
+requires-python = ">=3.9"
+dependencies = []  # 运行时零依赖（核心）
+[project.urls]
+Homepage = "https://github.com/qingqingpi/Chinese-Geo"
+Repository = "https://github.com/qingqingpi/Chinese-Geo"
+Issues = "https://github.com/qingqingpi/Chinese-Geo/issues"
+[project.optional-dependencies]
+render = ["playwright>=1.40"]  # 可选：JS 渲染对比
+mcp = ["mcp>=1.0"]  # 可选：MCP server（seogeo-mcp）
+dev = ["pytest>=7"]
+[project.scripts]
+seogeo = "seogeo.cli:main"
+seogeo-mcp = "seogeo.mcp_server:main"
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["seogeo*"]

chinese_geo-0.1.1/seogeo/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ __version__ = "0.1.1"

chinese_geo-0.1.1/seogeo/botverify.py ADDED Viewed

@@ -0,0 +1,56 @@
+"""爬虫真伪 / 拦截判定。
+- looks_blocked：纯逻辑，判断 Bytespider 是否被服务端拦（用 browser-UA vs Bytespider-UA 对比）。
+- verify_bot_ip：反向 + 正向 DNS 双向校验某 IP 是否真为该爬虫（reverse/forward 可注入，便于测试）。
+- probe_bytespider_blocked：薄网络层，实际跑两次抓取喂给 looks_blocked。
+"""
+from __future__ import annotations
+import socket
+from seogeo.data.domestic_bots import DOMESTIC_BOT_RDNS
+from seogeo.fetch import fetch
+_CHALLENGE = ["just a moment", "checking your browser", "access denied", "captcha", "forbidden", "blocked"]
+_BLOCK_STATUS = {403, 429, 451, 503}
+_BROWSER_UA = ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+               "(KHTML, like Gecko) Chrome/120 Safari/537.36")
+_BYTESPIDER_UA = "Mozilla/5.0 (compatible; Bytespider; https://zhanzhang.toutiao.com/)"
+def looks_blocked(browser, bot):
+    """返回 True/False；任一抓取缺失返回 None。"""
+    if not browser or not bot:
+        return None
+    if bot["status"] in _BLOCK_STATUS:
+        return True
+    if any(k in (bot.get("text") or "")[:5000].lower() for k in _CHALLENGE):
+        return True
+    blen, botlen = len(browser.get("text") or ""), len(bot.get("text") or "")
+    if browser["status"] == 200 and bot["status"] == 200 and blen > 0 and botlen < 0.3 * blen:
+        return True
+    return False
+def verify_bot_ip(ip: str, bot: str, reverse=None, forward=None) -> bool:
+    """反向 + 正向 DNS 双向校验（百度/谷歌官方推荐法）。仅支持有 rDNS 落点的爬虫。"""
+    suffix = DOMESTIC_BOT_RDNS.get(bot)
+    if not suffix:
+        return False
+    reverse = reverse or (lambda i: socket.gethostbyaddr(i)[0])
+    forward = forward or (lambda h: socket.gethostbyname_ex(h)[2])
+    try:
+        host = reverse(ip)
+        if not host.endswith(suffix):
+            return False
+        return ip in forward(host)
+    except OSError:
+        return False
+def probe_bytespider_blocked(url: str):
+    """实际抓两次（浏览器 UA + Bytespider UA）判断是否被服务端拦。返回 True/False/None。"""
+    browser, _ = fetch(url, ua=_BROWSER_UA)
+    bot, _ = fetch(url, ua=_BYTESPIDER_UA)
+    return looks_blocked(browser, bot)