geo-optimizer

GEO 优化器

面向 AI 搜索可见性的生成式引擎优化（GEO）。

如需了解 GEO 的背景、它与 SEO 的区别以及相关研究，请参阅 README.md。

快速审计工作流

1. 技术可见性检查

# Run full GEO audit
python3 ${CLAUDE_SKILL_DIR}/scripts/audit-geo.py https://example.com

# Check HTML size and JS dependency
curl -sI https://example.com | grep -i content-length

2. 内容权威性分析

# Check hedge density of your content
python3 ${CLAUDE_SKILL_DIR}/scripts/check-hedge-density.py --url https://example.com/blog/post

# Or analyze text directly
python3 ${CLAUDE_SKILL_DIR}/scripts/check-hedge-density.py --text "Your content here"

3. Agent 基础设施设置

# Generate AgentFacts schema for your domain
python3 ${CLAUDE_SKILL_DIR}/scripts/generate-agentfacts.py \
  --domain example.com \
  --agent-name "Example Service" \
  --capabilities text,image \
  --output /.well-known/agent-facts

核心指标

犹豫表达密度评分

衡量内容中的不确定性表达。目标：<0.2%

应避免的犹豫词语：

• maybe、possibly、perhaps、might、could be
• however、although、it seems、arguably
• some believe、it appears、potentially

参见：references/hedge-density.md

HTML 大小预算

上限：1MB 原始 HTML。超过此阈值会导致：

• 18% 的页面被爬虫放弃
• 内容截断风险
• 索引速度变慢

使用以下命令检查：curl -sI URL | grep content-length

参见：references/technical-visibility.md

JS 依赖风险

AI 爬虫对 JavaScript 的渲染能力各不相同：

• 渲染型爬虫： GPTBot、PerplexityBot（有时）
• 非渲染型： ClaudeBot 及许多其他爬虫

如果内容需要 JS 才能显示，那么约 40% 的 AI 爬虫将无法看到你的内容。

发现差距

参见：references/discovery-strategies.md

AgentFacts 设置

NANDA 协议为 AI Agent 发现提供机器可读的元数据。将其放置于 /.well-known/agent-facts：

{
  "@context": "https://nanda.dev/ns/agent-facts/v1",
  "id": "nanda:example.com",
  "agent_name": "urn:agent:example:com",
  "endpoints": {
    "static": ["https://api.example.com/v1/agent"]
  },
  "capabilities": {
    "modalities": ["text"],
    "authentication": {
      "methods": ["oauth2", "jwt"]
    }
  },
  "trust": {
    "certification": "self-attested",
    "human_oversight": "true"
  }
}

参见：references/agentfacts-schema.md

审计报告章节

完整的 GEO 审计包括：

1. 技术可见性

   • HTML 负载大小（目标：<1MB）
   • JS 依赖评估
   • 爬虫可访问性

2. 内容权威性

   • 犹豫表达密度评分（目标：<0.2%）
   • 确信度评估
   • 实体密度

3. 发现策略

   • 站点年龄分析
   • 新近度壁垒检测
   • 推荐方法

4. Agent 基础设施

   • AgentFacts 是否存在
   • 架构验证
   • NANDA 合规性

脚本

脚本	用途
audit-geo.py	对 URL 进行完整的 GEO 审计
check-hedge-density.py	分析内容确信度
generate-agentfacts.py	创建符合 NANDA 规范的架构

参考文档

文件	内容
hedge-density.md	确信度评分方法
agentfacts-schema.md	NANDA 协议规范
technical-visibility.md	爬虫行为与限制
discovery-strategies.md	初创公司与在位企业的策略

示例命令

# Full audit with report
python3 ${CLAUDE_SKILL_DIR}/scripts/audit-geo.py https://mysite.com --output report.md

# Quick hedge check
python3 ${CLAUDE_SKILL_DIR}/scripts/check-hedge-density.py --url https://mysite.com/about

# Generate AgentFacts for SaaS
python3 ${CLAUDE_SKILL_DIR}/scripts/generate-agentfacts.py \
  --domain myapp.com \
  --agent-name "MyApp AI" \
  --capabilities text \
  --auth oauth2,apikey