开源的 GEO 与 SEO 代理技能集合（v0.5.0，Experimental），把生成式引擎优化变成可审计、可复用的运行。含七个活跃 Skill：意图路由、查询与机会地图、站点诊断、内容生成（JSON/Markdown/HTML）、可见度与引用份额度量、策略实验计划、实体图谱与冲突事实保留，另有 planned 状态的发布路由。不推断实时平台数据，缺失证据显式保留；每次运行产出 run-lineage.json 与证据台账。Python 3.11-3.14，AGPL-3.0-only。

技能介绍

GEOHub · 开源 GEO 与 SEO 智能代理技能集合

面向 AI 搜索的开源、基于证据边界的 GEO 与 SEO 代理技能集合，覆盖机会挖掘、站点诊断、内容生成、效果度量和 SEO 规划等核心能力。

Version 0.5.0 · Experimental · GEO-first · SEO-ready

通过 registry 驱动的控制面、Artifact Bus、评估实验室、JSON Schema 契约与七个活跃 Skill，把生成式引擎优化（GEO）的工作变成可审计、可复用的运行。

仓库：yaojingang/GEOHub｜许可：AGPL-3.0-only（商业授权当前为 inquiry_only）
Copyright © 2026 姚金刚 / Yao
maturity_tier=library 描述的是打包严格程度，不声称生产级结果质量

适用场景

想为品牌 / 门店做 AI 搜索适配的机会挖掘与内容规划。
需要诊断品牌官网、站点或页面在 GEO 视角下的适配问题，并拿到结构化报告。
需要生成适配 AI 搜索的内容（标题、解读、对比、排行、页面蓝图）。
需要可复现的可见度 / 提及 / 引用份额度量，而不是拍脑袋的结论。
需要一套有证据来源、能对齐 ASEO 与 SEO 的优化策略与实验计划。

核心能力

↔ 左右滑动查看完整表格

Skill	作用
`geo`	按 registry 路由中英文请求，并诚实报告不可用路由
`geo-discover`	把校验过的 GEO brief 转成确定性的查询地图、机会地图、证据台账、run manifest 与质量报告
`geo-diagnose`	评估显式的品牌/站点/页面来源，输出结构化诊断、确定性报告、证据台账、修复查询地图、机会地图、质量报告与 run manifest
`geo-content`	生成带证据行标的标题、解读、对比、排行、页面蓝图与精修稿，输出 JSON / Markdown / 独立 HTML；DOCX/PDF 为可选渲染层
`geo-measure`	从经过批准的离线引擎观测包计算可复现的可见度、提及、来源收录、引用份额与面板覆盖率指标
`geo-strategy`	产出有边界的干预候选、保真度检查、实验计划、外部发布交接与「只记正向」的策略记忆
`geo-knowledge`	构建带来源行标的实体图谱，保留冲突事实，支持局部/全局查询，并在源哈希变化时替换相应贡献
`geo-publish`	仍是可见的路线图路由，状态 `planned`，无执行权限

路由侧：resolver 保持单意图路由最小化，并暴露两条精确的多阶段 DAG——brand-baseline-lite（discover → diagnose）与 content-campaign（discover → content）。词法路由保留生产权，语义打分为影子模式并记录分歧。持久工作流状态支持检查点、重试、中止、审批以及显式的外部发布/观测等待。路由请求限定 8,000 字符与 16,384 UTF-8 字节。

效果预览

不推断任何数据：没有连接器，不推断实时平台采样、搜索量、排名或转化数据；缺失证据在生成的产物中保持显式可见。
每次可执行运行都带 run-lineage.json：含产物哈希与白名单内的运维元数据；运行负载不进入采纳率与漂移聚合。
视觉报告：GEOHub 0.5.0 升级复盘提供独立中文 HTML 报告，含 17 模块前后对比评分、修复闭环、确定性门禁与剩余生产证据。
数据保留：默认仅预览，--confirm 才把过期运行移入可恢复的 .geohub-trash；永久清除需在七天宽限期后二次确认。
生产就绪状态仍为 blocked：人工评审、实时平台基准、受治理的采纳、外部策略效果、生产知识评估、法务评审与已执行的 CI 认证都仍是缺失证据。

工作方式

快速开始（Python 3.11–3.14）

git clone https://github.com/yaojingang/geo-seo-hub.git
cd geo-seo-hub
python3 -m venv .venv
.venv/bin/python -m pip install .
.venv/bin/geo-seo-hub --version
.venv/bin/geo-seo-hub route --text "帮我挖掘 AI 搜索问题"

开发与完整发布门禁

.venv/bin/python -m pip install -e '.[dev]'
.venv/bin/python scripts/verify_all.py

运行约定

CLI 输出 JSON；--output 是一个 runs 根目录，七个 provider 执行器把协议 1.0.0 的运行写到 // 并返回实际运行目录。
内容运行绝不访问网络，会快照相对来源文件以便离线重放，在独立 HTML 中转义用户文本，并把可选渲染器的失败显式保留。
DOCX/PDF 依赖缺失时核心输出仍成功，run manifest 记录 degraded + missing_dependencies；安装 .[render] 才请求 DOCX/PDF 支持。
geo-diagnose 只抓取显式的公开 HTTP(S) canonical URL（不带查询串），接受 HTML/XHTML，不做爬取扩展，快照成功页面供离线重放；其分数不代表实时 AI 平台的召回、排名或引用份额。

发布与治理

make verify 与 python3 scripts/verify_all.py 跑完整的仓库、证据、测试、评估、打包与隔离安装门禁；make repo-verify 跑快速结构检查。门禁使用合成夹具，不需要外部服务或密钥。仓库 AGPL-3.0-only，贡献者协议仍在法务评审中，因此外部代码合并暂停。

你需要提供

一个明确的 GEO brief：品牌 / 站点 / 页面（diagnose 只接受显式给定的公开 URL）。
内容任务的目标关键词或主题、目标输出形态（JSON / Markdown / HTML，需要 DOCX/PDF 则安装 .[render]）。
若要做度量：经批准的离线引擎观测包。

你会获得

结构化、可审计的 GEO/SEO 分析报告，合规内容产出，可复现的度量结果，以及清晰的优化策略方案——全部带证据台账、run manifest 与质量报告，缺失证据会显式标注而不是被编造。

使用示例

帮我为本地咖啡新店做一个AI搜索适配的SEO机会挖掘和内容规划。

帮我诊断我的品牌官方页面，输出结构化的GEO适配问题报告和优化方向。

生成一篇适配AI搜索的关于便携式咖啡机对比的GEO内容框架和初稿。

GEO 与 SEO 的边界：GEOHub 把两者视为共享搜索基础的相邻能力域——查询意图、来源证据、品牌事实、实体结构、内容规格、站点解析、质量报告与 Artifact Bus 契约对两个域都可用。0.5.0 只交付了可执行的 GEO 发现、诊断、内容、观测包度量、策略规划、知识治理与路由；策略执行止于外部发布交接，没有可验证的窗口后度量就不能声称效果。技术 SEO、SERP 与关键词数据、索引、Core Web Vitals、内链、Search Console 与流量度量等专用 SEO 工作流与效果声明，仍是未来的 Registry 增项。