
什么是 EEO?
EEO 是 Everything Engine Optimization(全引擎优化)的缩写,是一个涵盖 SEO、AEO、GEO 和 LLMO 的统称。该项目帮助品牌了解并改善其在 AI 引擎生成的答案中的呈现方式。
EEO 结合了三项相关能力:
- EEO 审计:向 AI 引擎提出真实买家可能会询问的问题,然后衡量品牌在返回答案中的可见度。报告包含原始答案,便于检查。
- 品牌注册表:存储遵循
eeo.brand.v1架构的机器可读品牌卡片。品牌可以通过公开拉取请求中的域名验证来认领卡片。 - 网站生成器:将品牌卡片转换为静态网站,并生成
llms.txt、JSON-LD 和允许 AI 爬虫访问的robots.txt文件。
该项目旨在保持开放性、尽可能不依赖外部依赖,并且便于检查。其更广泛的规则以及面向优化服务提供商的五条行为约定,记录在 EEO 标准中。
为什么 AI 品牌可见度很重要
当买家向 AI 引擎寻求推荐时,回答会根据模型读取过的信息生成,例如文章、评论和列表页面。品牌自身的描述可能无法以结构化格式传达给模型。
EEO 通过为品牌提供一种开放格式来陈述事实、一个用于证明域名所有权的公开流程,以及让引擎、开发者和买家都能读取相关信息的工具,来解决这一问题。
选择 EEO 工作流程
该代码库提供多个入口。请选择与目标相匹配的方式:
- 使用
eeo-local.html,无需安装任何内容,即可快速进行基于浏览器的审计。 - 使用
cli.cjs,进行可重复检查、批量审计、数据集处理和定期复测。 - 使用 Docker 镜像,在本地运行社区品牌网站。
- 使用
server.cjs和web/项目,运行自托管的审计工具网页版。 - 在将审计集成到开发或研究工作流时,使用 GitHub Action、MCP 服务器或 Chrome 扩展。
运行单文件审计
1. 下载并打开工具
从代码库下载 eeo-local.html 并在浏览器中打开。此版本不需要 Node.js、安装软件包或服务器。
2. 选择引擎并提供密钥
从目录中选择引擎。该目录包含 26 个预设,其中包括 11 个中国本土引擎。粘贴所选引擎要求的 API 密钥。工具会将这些密钥保存在浏览器的 localStorage 中。
3. 填写品牌表单
输入品牌信息并选择相关行业,然后运行审计。EEO 会提出面向买家的问题,并评估品牌在答案中的突出程度。
4. 检查并导出报告
报告包括 S 至 D 的评级、认知度和提及度分数、按引擎划分的明细,以及每条原始答案。你可以将结果导出为 JSON,或打印为 PDF 以便分享和审阅。
从 CLI 运行审计
命令行工作流程需要 Node 18 或更高版本。其核心工作流程无需安装依赖。
1. 创建配置文件
复制示例配置,并填写计划使用的引擎设置和 API 密钥:
cp config.example.json config.json
根据本地环境妥善配置,并且不要将密钥提交到公共代码库。
2. 检查一个品牌
提供品牌名称和行业,运行单个品牌审计:
node cli.cjs check 蜜雪冰城 --industry 餐饮
CLI 会发送已配置的审计请求,并生成相应的可见度结果。
3. 运行批量审计
将品牌名称逐行写入文本文件,并将结果写入 CSV:
node cli.cjs batch brands.txt --csv result.csv
当你需要比较多个品牌或创建可重复的报告流程时,这种方式非常有用。
4. 审计数据集
如果要处理某个行业类别中的品牌,请使用基于数据集的命令:
node cli.cjs dataset 白酒 --limit 10
--limit 选项用于控制示例运行规模。使用 node cli.cjs --help 查看所有可用命令,其中包括用于定期复测的 watch。
使用 Docker 运行社区品牌网站
Docker 工作流程根据 datasets/brands-1k.json 生成品牌网站。它不需要 API 密钥,因为它提供的是生成的品牌信息,而不是运行引擎审计。
docker build -t eeo-community .
docker run -p 8080:80 eeo-community
容器启动后,打开 http://localhost:8080。网站为每个品牌提供一个页面,并包含支持 AI 爬虫的 llms.txt、JSON-LD 和 robots.txt。
此 Docker 设置不同于自托管审计服务器。对于审计服务器,请查看 server.cjs 和 config.example.json。可以使用以下命令构建网页界面:
cd web
npm install
npm run build
public/ 中也包含预构建的网页界面。
了解代码库结构
eeo-local.html是包含 26 个引擎预设的单文件审计工具。cli.cjs提供 check、batch、dataset 和 watch 工作流。core.cjs包含 CLI、MCP 服务器和 GitHub Action 共用的审计引擎。server.cjs是自托管服务器版本,web/包含其 React 和 Vite 源代码。action/包含用于在 CI 中运行品牌可见性审计的 GitHub Action。mcp/包含适用于 Claude Desktop、Cursor 和 Windsurf 的 MCP 服务器。extension/包含 Chrome MV3 快速检查扩展。datasets/包含完整的品牌集合和精选种子数据。platform/包含声明验证和最终确定脚本。standards/taxonomy/包含行业特征和买家问题库。tools/包含用于生成网站、llms.txt、架构和索引的工具。
认领或添加品牌卡片
认领现有卡片
品牌应首先在 datasets/ 中搜索现有卡片。认领流程详见 platform/README.md,并通过公开拉取请求使用域名验证。
此流程会留下可见记录,证明该品牌控制着与卡片关联的已验证域名。
添加缺失品牌
如果品牌尚未列出,请根据 CONTRIBUTING.md 创建并提交卡片。提交拉取请求前,请遵循仓库的架构和贡献规则。
高级工作流和贡献提示
连接兼容的 AI 端点
引擎观察者可以为检测目录提议新的引擎预设。CLI、自托管服务器和 MCP 服务器还可以通过 config.json 连接到兼容 OpenAI 的端点。添加预设或更改检测行为前,请先查看贡献指南。
自动执行定期审计
使用 CLI 的 watch 命令安排定期重新测试。对于仓库自动化,action/ 目录提供了可在 CI 中运行可见性审计的 GitHub Action。仓库还包含用于声明验证、声明最终确定和每月自审计的工作流。
在 AI 工具中使用 MCP 服务器
MCP 服务器适用于 Claude Desktop、Cursor 和 Windsurf。它复用共用的审计引擎,使兼容客户端能够通过 MCP 集成访问项目的审计功能。请使用 config.example.json 中说明的通用引擎和密钥设置进行配置。
扩展行业分类体系
分类体系贡献者可以在 standards/taxonomy/ 下添加行业特征库和买家问题库。验收规则记录在分类体系 README 中。添加行业别名被列为适合首次贡献的简单任务。
生成机器可读的发布资源
网站生成工具可以将品牌卡片转换为静态信息网站。生成的输出旨在通过 llms.txt、JSON-LD 和爬虫规则,让引擎及其他工具更容易发现品牌事实。
保持审计结果可解释
EEO 报告会保留每个原始引擎回答,而不是只展示分数。比较运行结果时,请结合知名度和提及分数,查看逐引擎明细及原始回答。这样更容易区分整体可见性变化与由单个引擎或单个问题导致的结果。
为获得可重复的结果,请在不同运行之间保持行业选择、品牌数据、引擎配置和批处理输入一致。添加新引擎或分类体系时,请记录相关变更,以便公平比较后续报告。
结语
EEO 提供了一套开放工作流,用于衡量 AI 引擎如何描述品牌,并以结构化格式发布品牌事实。无需安装时,可从 eeo-local.html 开始审计;需要批处理或定期任务时,使用 CLI;需要本地社区实例时,则使用 Docker 或自托管服务器。
了解基本工作流后,你可以认领品牌卡片、贡献分类体系数据、添加引擎预设、将审计集成到 CI,或把 MCP 服务器连接到兼容的 AI 开发工具。项目采用 Apache License 2.0 发布,标准和分类体系文件则使用仓库中记录的许可证。
