geo-score 快速开始 · geo-score 文档

geo-score 按开源的 AIV 量表 v1.1，给网站打 0–100 分，衡量 AI 回答引擎能不能抓到、读懂、信任并引用它。这一页带你在屏幕上看到自己的分数，讲清报告里写了什么，再指向其余文档。你只需要 Python 3.8 以上，不需要 API Key，也不需要注册账号。

运行 geo-score 需要什么？

打分（第 1 级）是一个只用 Python 标准库的文件。可以直接从发布 tag 管道运行，可以用 uv 不安装就跑 PyPI 上的包，也可以用 pipx 或 pip 装上 geo-score 命令。不管哪种方式，跑的都是同一个发布版本 1.8.3。

Python 3.8+，macOS、Linux、Windows 都行。
能访问网络：要能访问被打分的网站、它的标记指向的地址，以及 Wikidata 和 Wikipedia 搜索。
不需要 Key。只有第 2、3 级要用 API 去问 AI 引擎，才需要你自己的 Key。

怎么给一个网站打分？

任选一行。同样的页面，打出的报告完全一样。

uvx geo-score@1.8.3 example.com                    # 不安装，直接运行 PyPI 上的包
pipx install geo-score==1.8.3                      # 或者装上 geo-score 命令
pip install geo-score==1.8.3                       # 用 pip 也行，建议装在虚拟环境里
curl -sL https://raw.githubusercontent.com/jianruntech/geo-score/v1.8.3/cli/geo_score.py | python3 - example.com --brief

访问不了 PyPI 时，可以装 GitHub Release 附带的 wheel；每个发布都带 SHA256SUMS，PyPI 上的 wheel 与它逐字节一致。也可以先在本站在线试一下：在线打分读的页面更少，并会给出在本地复现结果的命令。

报告里写了什么？

首屏只放三样：总分和档位、离下一档还差多少、最大的几处缺口。往下是每一项检查和它所在的档。

总分和档位。0–100 分，按这次能观测到的检查项归一化，落在「未起步」到「领先」五个档之一。
支柱和检查项。五个支柱、21 项阶梯式检查。每一项是满分、部分得分、0 分或未测；未测的项退出分母，绝不按 0 分算。
最大缺口排在前面。门槛项得 0 分的永远排在最前，其后按「升一档能多拿几分」排序，每一处都写明下一档要什么。
页脚。拿到的分数和可观测满分、哪些项退出了分母及原因、量表版本、这次运行用了多久。

加上 --explain 可以看到每一项背后的证据：状态码、计数、哪句话算数或不算数。从 1.7.0 起，报告还会列出三项「分数之外」的观察（逐页的 robots.txt 规则、服务端 HTML 里的链接、hreflang 标注），它们从不影响分数。

三级用法分别是什么？

打分回答的是引擎「能不能」引用一个站。另外两级用你自己的 API Key 测引擎「有没有」引用它，结果与分数并列报告，从不相加。

级别	回答什么	需要什么	命令
1 · 打分	AI 引擎能不能抓到、读懂、信任并引用这个站？	什么都不要	`geo-score example.com`
2 · 实测	就某一个问题，引擎现在引不引用它？	OpenAI、Perplexity、Gemini、Anthropic、OpenRouter 任一家的 API Key	`geo-score example.com --ask "…"`
3 · 追踪	一组固定问题下，它每周被引用的频率怎么变？	你的 Key 和一组问题	`geo-score watch run`

本站的在线打分只跑第 1 级，从不向任何 AI 引擎提问，也不用任何模型 Key。

接下来看什么？

命令行参数：所有参数、退出码、怎么比较两次运行。
GitHub Action：每次 push 都打分，退步时让构建失败。
MCP 服务：把同一个打分器交给 Agent。
分数怎么算：每一项检查、每一道门槛、每一个档位。
常见问题：分数为什么会动、为什么显示横线、为什么封顶 40。