geo-optimization-cli

让 ChatGPT、Claude、Perplexity、Gemini 主动引用你的网站。 自动生成 AI 搜索引擎所需的全套优化文件，无需手写代码。

这个工具解决什么问题？

你有没有发现：越来越多用户不去 Google 搜索，而是直接问 ChatGPT 或 Claude：

「有什么好用的项目管理工具推荐？」 「XX 行业最好的平台是哪个？」

如果你的网站没有做 GEO（生成式搜索引擎优化），AI 在回答这类问题时根本不会提到你——不是因为你产品不好，而是因为 AI 系统找不到足够的结构化信息来引用你。

这个工具做一件事：自动生成 3 类文件，上传到你的网站后，AI 系统就能识别、理解并引用你的内容。

整个过程：10 分钟完成，不需要写任何代码。

🚀 三秒上手

# 检测你自己的网站 GEO 评分
geo check https://yoursite.com

# 并排对比你和竞品的 GEO 差距
geo compare https://yoursite.com https://competitor.com

# 生成可分享的 Markdown 报告（直接发给团队/开发）
geo report https://yoursite.com

# 检测竞品
geo check https://competitor.com

geo compare 输出示例：

🔄 GEO 竞品对比分析
──────────────────────────────────────────────────────────────────
                    yoursite.com            competitor.com
──────────────────────────────────────────────────────────────────
GEO 总分            40/100  ███░░░░░        75/100  ██████░░  👑

robots.txt          ✓ 已存在                ✓ 已存在
llms.txt            ✗ 缺失                  ✓ 已配置           ← 竞品领先
AI 爬虫访问         ✗ 未开放                ✓ 已开放           ← 竞品领先
Schema 数据         ✗ 未检测                ✓ 已配置（3种）    ← 竞品领先

📊 总结
  competitor.com 领先 yoursite.com 35 分（75 vs 40）
  竞品已做、你还未做：llms.txt、AI 爬虫访问、Schema 数据
  修复后预计得分：96+/100 （超越竞品）

一键修复：  geo generate -t saas -o ./geo-artifacts

输出示例：

🔍 GEO 实时检测：https://yoursite.com
─────────────────────────────────────────────────────
GEO 评分：40/100  ████████░░░░░░░░░░░░  较差

检测项：
  ✓  robots.txt      已存在
  ✗  llms.txt        文件不存在 — AI 爬虫无法确认数据使用权限
  ✗  AI 爬虫访问     robots.txt 未允许 GPTBot、ClaudeBot
  ✗  Schema 数据     未检测到结构化标记

关键问题（立即修复）：
  🔴 缺少 llms.txt
     → 生成并上传 llms.txt 到网站根目录
  🔴 AI 爬虫未被允许
     → 在 robots.txt 中为 AI 爬虫添加 Allow 规则

修复以上 3 个问题后，预计评分提升至 96+/100

一键生成优化文件：
  geo generate -t saas -o ./geo-artifacts

⚡ 完整上手流程（从 0 到 1）

适合人群： 从未用过命令行工具的 PM / 运营 / 增长团队成员 完成时间： 约 10-15 分钟（含环境安装） 最终产出： 一个 geo-artifacts/ 文件夹，交给开发部署即可

第 0 步：安装 Node.js 运行环境（只需做一次）

如果你之前做过前端项目或已安装过 Node.js，可以跳过这一步。

Mac 用户：

1. 打开浏览器，访问 https://nodejs.org
2. 点击绿色的 「LTS（推荐版本）」 按钮下载
3. 打开下载的 .pkg 文件，一路点击「继续」安装
4. 安装完成后，按 Command（⌘） + 空格，输入「终端」，打开「终端」应用
5. 在终端里输入以下命令，按回车：

node --version

看到类似这样的输出，说明安装成功：

v20.11.0

版本号只要是 v18 以上都可以。

Windows 用户：

1. 打开浏览器，访问 https://nodejs.org
2. 点击绿色的 「LTS（推荐版本）」 按钮下载 .msi 文件
3. 双击安装，一路点击「Next」直到完成
4. 按 Windows 键，搜索「PowerShell」，右键选择「以管理员身份运行」
5. 输入以下命令，按回车：

node --version

看到类似这样的输出，说明安装成功：

v20.11.0

第 1 步：安装 geo-optimization-cli

在终端（或 PowerShell）里，输入：

npm install -g geo-optimization-cli

安装过程会显示一堆文字，最后看到类似这样的输出表示成功：

added 1 package in 2s

验证安装：

geo --version

应该看到：

geo-optimization-cli v1.5.0

Mac 遇到权限错误（EACCES）？ 改用这条命令： sudo npm install -g geo-optimization-cli 输入你的电脑登录密码（输入时不会显示，正常现象），按回车。

第 2 步：进入你的工作目录

在终端里，进入你想存放输出文件的文件夹。

方法一（推荐）： 在 Finder（Mac）或文件资源管理器（Windows）里，进入你的项目文件夹，然后：

• Mac： 直接把文件夹拖进终端窗口，会自动填入路径，然后在前面手动加上 cd 再按回车
• Windows： 在文件夹地址栏输入 powershell 按回车，直接在该目录打开

方法二（直接输入路径）：

# Mac 示例（替换成你自己的路径）
cd /Users/你的用户名/Desktop

# Windows 示例
cd C:\Users\你的用户名\Desktop

确认当前位置：

pwd
# Mac 会显示类似：/Users/yourname/Desktop
# Windows 会显示类似：C:\Users\yourname\Desktop

第 3 步：生成 GEO 优化文件

根据你的情况，选择下面任意一种方式：

✅ 方式 A：有 GEO 审计报告（推荐）

如果你用 Claude 或其他 GEO 审计工具生成过报告文件（如 GEO-AUDIT-REPORT.md）

先查看你的评分：

geo score ./GEO-AUDIT-REPORT.md

终端会显示类似这样的内容：

────────────────────────────────────────────────────────
📊 GEO 分数分析
────────────────────────────────────────────────────────

  读取报告: ./GEO-AUDIT-REPORT.md

  网站:     你的网站名
  URL:      https://yoursite.com
  业务类型: saas

  ● 整体 GEO 评分: 54/100 (Poor)

  分类评分:
    citability        58/100    ← AI 有多愿意引用你
    brandAuthority    45/100    ← AI 对你品牌的认知度
    technical         62/100    ← 技术层面的可抓取性

  问题汇总:
    🔴 关键 (Critical): 3 项
    🟠 高优先 (High):   5 项
    🟡 中等 (Medium):   4 项

  ⚡ 立即修复:
    • 缺少 llms.txt（AI 爬虫无法确认数据使用权限）
    • robots.txt 未允许 GPTBot、ClaudeBot 访问
    • 缺少 Organization Schema 结构化数据

再一键生成所有优化文件：

geo generate ./GEO-AUDIT-REPORT.md -o ./geo-artifacts

✅ 方式 B：没有审计报告，直接生成

不知道自己现在的问题在哪，先生成一套标准文件再说

# 选择最接近你网站类型的参数：
geo generate -t saas       -o ./geo-artifacts   # SaaS / 软件产品 / 订阅制工具
geo generate -t ecommerce  -o ./geo-artifacts   # 电商 / 在线商店 / 品牌官网
geo generate -t publisher  -o ./geo-artifacts   # 内容平台 / 博客 / 媒体 / 资讯站
geo generate -t local      -o ./geo-artifacts   # 本地商家 / 餐厅 / 门店 / 服务业
geo generate -t general    -o ./geo-artifacts   # 不确定？用这个，覆盖所有基础场景

执行后终端会显示：

✓ 已生成: llms.txt
✓ 已生成: robots-txt-update.txt
✓ 已生成: schema/organization.json
✓ 已生成: schema/software-application.json
✓ 已生成: schema/faq-page.json
✓ 已生成: schema/breadcrumb-list.json
✓ 已生成: implementation-plan.md

📁 输出目录: ./geo-artifacts

第 4 步：确认文件已生成

# Mac / Linux
ls ./geo-artifacts

# Windows PowerShell
dir .\geo-artifacts

应该看到：

geo-artifacts/
├── llms.txt
├── robots-txt-update.txt
├── implementation-plan.md
└── schema/
    ├── organization.json
    ├── faq-page.json
    ├── breadcrumb-list.json
    └── software-application.json   ← 根据业务类型不同而不同

第 5 步：查看行动计划

# Mac
cat ./geo-artifacts/implementation-plan.md

# Windows
type .\geo-artifacts\implementation-plan.md

这个文件里有按优先级排好的任务清单，直接复制给开发排期。

第 6 步：把文件交给开发部署

你已经完成了 PM 能做的全部工作。接下来把下面这段话发给你们的开发同学：

你好，我用 geo-optimization-cli 生成了一批 GEO 优化文件，放在 geo-artifacts/ 目录下。
需要你完成以下部署，预计 1-2 小时：

1. 【最高优先】将 llms.txt 上传至网站根目录
   目标地址：https://[你的域名]/llms.txt（浏览器可以直接访问到）

2. 【最高优先】将 robots-txt-update.txt 里的内容追加到服务器的 robots.txt 文件末尾

3. 【高优先】将 schema/ 目录下每个 .json 文件的内容，
   用 <script type="application/ld+json"> 标签包裹后，嵌入对应页面的 <head> 区域
   （organization.json 放所有页面，其他的放对应类型的页面）

完成后可以用 `geo verify` 命令验证是否生效，或者直接发我截图确认。

详细说明见：./geo-artifacts/implementation-plan.md

生成文件详解

全部命令

常用参数

常见问题

Q：终端显示 command not found: geo，怎么办？

A：说明安装没有成功。请重试安装命令：

npm install -g geo-optimization-cli

如果还是不行，Mac 用户加 sudo：sudo npm install -g geo-optimization-cli

Q：生成文件时报错 Cannot find module，怎么办？

A：通常是 Node.js 版本太低。检查你的版本：

node --version

版本需要 >= 18。如果低于 18，请重新去 nodejs.org 下载 LTS 版本安装。

Q：这和 SEO 工具有什么区别？

A：传统 SEO 优化 Google 搜索排名，GEO 优化 AI 助手的引用意愿。两者互不冲突，可以同时做。

Q：文件上传后多久生效？

A：AI 爬虫的抓取频率各不相同。通常 2-4 周后开始看到 AI 更多引用你的内容。llms.txt 和 robots.txt 改动生效最快，Schema 数据需要等爬虫下次抓取。

Q：需要每次更新网站都重新生成吗？

A：不需要。只在以下情况需要更新：公司名/网址变更、产品定位大调整、新增/删除主要功能。日常内容更新不需要重新生成。

Q：schema JSON 文件里有一些占位符，需要替换吗？

A：需要让开发把文件里的 [公司名]、[网站域名]、[产品描述] 等占位符替换成真实信息，再嵌入页面。通常 10 分钟内完成。

开发者 API

import { GeoOptimizer, AuditParser, SchemaGenerator } from 'geo-optimization-cli';

// 程序化生成优化文件
const optimizer = new GeoOptimizer({ businessType: 'saas' });
const artifacts = await optimizer.generateArtifacts({ type: 'saas' });
await optimizer.saveArtifacts(artifacts, './output');

// 解析审计报告
const parser = new AuditParser();
const parsed = parser.parse(markdownContent);
console.log(parsed.overallScore);   // 54
console.log(parsed.businessType);   // 'saas'
console.log(parsed.issues.critical); // 关键问题列表

// 生成指定 Schema
const schema = new SchemaGenerator();
const org = schema.organization({ name: 'Acme Corp', url: 'https://acme.com' });
const recommended = schema.recommended('saas'); // 返回推荐的 schema 类型列表

系统要求

• Node.js >= 18（免费下载）
• 零外部依赖，安装即用

问题反馈

遇到问题或有功能建议？在 GitHub Issues 提交，或直接提 PR。

开源协议

MIT © redredchen01