Package Exports

geo-optimization-cli
geo-optimization-cli/lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (geo-optimization-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

geo-optimization-cli

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

这个工具是做什么的？

传统 SEO 让你的网站出现在 Google 搜索结果里。

GEO（Generative Engine Optimization） 让 AI 助手（ChatGPT、Claude、Perplexity、Gemini）在回答用户问题时，主动引用你的网站内容。

越来越多的用户直接问 AI「有什么好用的 XX 工具？」而不是去 Google 搜索。如果你的网站没有做 GEO 优化，AI 根本不知道你的产品存在。

这个工具做的事情： 自动生成 3 类文件，放到你的网站上，让 AI 系统能读懂、信任并引用你的内容。

生成的文件有什么用？（给 PM 看的版本）

文件	作用	类比
`llms.txt`	告诉 AI 爬虫"你可以使用我们的数据"	就像 `robots.txt` 之于 Google，只是对象是 AI
`robots-txt-update.txt`	允许 GPTBot、ClaudeBot、PerplexityBot 抓取你的页面	给 AI 爬虫开门
`schema/*.json`	用 AI 能读懂的结构化语言描述你的产品	相当于给 AI 一份你的产品说明书
`implementation-plan.md`	按优先级排好的行动清单	直接交给开发或运营去执行

前置要求

在开始之前，你需要安装 Node.js（一个运行环境，免费）：

打开 https://nodejs.org
下载 LTS 版本（推荐稳定版）并安装
安装完成后，打开终端（Mac：Command + 空格 搜索「终端」，Windows：搜索「PowerShell」）
输入以下命令确认安装成功：

node --version
# 应该显示 v18.x.x 或更高版本

安装

# 全局安装（安装一次，随处可用）
npm install -g geo-optimization-cli

# 安装完成后，验证是否成功
geo --version
# 应该显示：geo-optimization-cli v1.1.2

遇到权限错误？ Mac 用户请在命令前加 sudo：sudo npm install -g geo-optimization-cli

快速开始（10 分钟完成优化）

根据你的情况，选择对应的路径：

📋 路径 A：你已经有一份 GEO 审计报告

适用于：已经用 Claude 或其他工具生成了 GEO-AUDIT-REPORT.md 的情况

第 1 步：查看你的 GEO 评分和问题清单

geo score ./GEO-AUDIT-REPORT.md

输出示例：

📊 GEO 分数分析
─────────────────────────────────────
  网站:     你的网站名称
  业务类型: saas
  整体评分: 54/100 (Poor)

  分类评分:
    AI 可引用性   58/100
    品牌权威度    45/100
    技术实现      62/100

  问题汇总:
    🔴 关键 (Critical): 10 项
    🟠 高优先 (High):    8 项

  ⚡ 立即修复：
    • 缺少 llms.txt 文件（AI 爬虫不知道能否使用你的数据）
    • robots.txt 未放行 GPTBot、ClaudeBot

第 2 步：一键生成所有优化文件

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

这条命令会根据你的审计报告，自动选择适合你业务类型的文件组合。

第 3 步：查看生成了什么

ls ./geo-artifacts
# 你会看到：llms.txt, robots-txt-update.txt, schema/, implementation-plan.md

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

参考下方「生成文件说明」，告知开发需要做什么。

🚀 路径 B：从零开始（没有审计报告）

适用于：想快速生成一套基础优化文件，之后再做详细审计

第 1 步：告诉工具你的网站类型

# 选择你的网站类型（选一个最接近的）：
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   # 其他 / 不确定，用这个

# 不想真正生成文件，只是想预览会生成什么？
geo generate -t saas --dry-run

不知道选哪个？ → 用 general，覆盖所有场景的基础文件。

第 2 步：查看生成的文件

ls ./geo-artifacts

第 3 步：把文件交给开发部署（见下方说明）

⚙️ 路径 C：初始化项目配置（团队协作推荐）

适用于：多人团队、需要把配置保存在项目里的情况

# 第 1 步：初始化配置文件（会提示你填写网站信息）
geo init

# 第 2 步：生成文件（自动读取配置，不需要重复输入参数）
geo generate -o ./geo-artifacts

# 第 3 步：检查你网站上目前已有的 GEO 实现情况
geo verify

生成文件说明（让开发人员部署）

运行 geo generate 后，./geo-artifacts/ 里会有：

geo-artifacts/
├── llms.txt                    ← 上传到网站根目录
├── robots-txt-update.txt       ← 内容追加到 robots.txt
├── implementation-plan.md      ← 行动清单，发给团队
└── schema/
    ├── organization.json       ← 所有网站都需要
    ├── faq-page.json           ← 所有网站都需要
    ├── breadcrumb-list.json    ← 所有网站都需要
    ├── software-application.json  ← 仅 SaaS 类型
    ├── product.json               ← 仅电商类型
    ├── local-business.json        ← 仅本地商家类型
    └── article.json               ← 仅媒体/博客类型

每个文件需要开发做什么？

文件	开发操作	优先级
`llms.txt`	上传到 `https://你的域名/llms.txt`，确保能公开访问	🔴 最高
`robots-txt-update.txt`	把里面的内容追加到服务器上的 `robots.txt` 文件末尾	🔴 最高
`schema/organization.json`	将文件内容包在 `<script type="application/ld+json">` 标签里，放入每个页面的 `<head>` 中	🟠 高
其他 `schema/*.json`	同上，放入对应页面的 `<head>` 中	🟡 中
`implementation-plan.md`	作为项目任务清单，按优先级排期	—

发给开发的说明模板

需要部署以下 GEO 优化文件，提升网站在 AI 搜索引擎中的可见度：

1. 将 llms.txt 上传至网站根目录，确保 https://[域名]/llms.txt 可访问
2. 将 robots-txt-update.txt 中的内容追加到 robots.txt 末尾
3. 将 schema/ 目录下的 JSON 文件内容，分别以 JSON-LD 格式嵌入对应页面 <head>
   格式：<script type="application/ld+json">{ ...文件内容... }</script>

预计工作量：1-2 小时。完成后可用 geo verify 命令验证是否生效。

全部命令一览

命令	说明
`geo score <报告文件>`	解析审计报告，显示 GEO 评分和问题清单
`geo generate [报告文件]`	生成 llms.txt、robots.txt 规则、Schema JSON
`geo generate -t <类型>`	无需审计报告，直接按业务类型生成
`geo deploy [目录]`	将生成的文件复制到网站根目录
`geo verify`	检查网站当前 GEO 实现状态
`geo init`	创建项目配置文件 `.geo-optimization.json`
`geo analyze <URL>`	抓取并分析指定网址

常用参数

参数	说明
`-t saas / ecommerce / publisher / local / general`	指定网站业务类型
`-f ./path/to/report.md`	指定输入的审计报告路径
`-o ./output-dir`	指定输出目录（默认：`./geo-artifacts`）
`--dry-run`	预览模式，不实际写入文件
`-v`	显示版本号
`-h`	显示帮助

常见问题

Q：这个工具和 SEO 工具有什么区别？ A：传统 SEO 工具优化的是 Google 搜索排名。这个工具优化的是 AI 助手（ChatGPT、Claude 等）是否会引用你的网站。两者可以同时做，互不冲突。

Q：生成的文件上传后，多久能看到效果？ A：AI 爬虫抓取频率各不相同，通常需要 2-4 周后，AI 系统开始更多引用你的内容。

Q：需要每次更新网站都重新生成吗？ A：不需要。Schema 文件和 llms.txt 是长效文件，只有当你的产品、联系方式或主要业务发生变化时才需要更新。

Q：我的网站是英文的，但这个工具显示中文，有问题吗？ A：生成的文件内容（llms.txt、schema JSON 等）是标准格式，与语言无关。命令行界面是中文，但输出的文件完全符合国际标准。

Q：我看不懂 schema JSON 文件里的内容，需要修改吗？ A：不需要。直接把文件内容交给开发嵌入到页面 <head> 里即可。如果里面的信息（如公司名、网址）需要替换成你的实际信息，开发可以直接修改文本。

开发者 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'

// 单独生成某类 Schema
const schema = new SchemaGenerator();
const org = schema.organization({ name: 'Acme Corp', url: 'https://acme.com' });

JSPM