pp-isitagentready

Is It Agent Ready — Printing Press CLI

前提条件：安装 CLI

此技能依赖 isitagentready-pp-cli 二进制文件。**调用此技能中的任何命令前，必须确认 CLI 已安装。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install isitagentready --cli-only
   

2. 验证：isitagentready-pp-cli --version
3. 确保报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接 Go 安装（需要 Go 1.26.6 或更新版本）。该方式会将程序安装到 $GOPATH/bin（默认为 $HOME/go/bin），因此请将该目录添加到 $PATH：

go install github.com/mvanhorn/printing-press-library/library/developer-tools/isitagentready/cmd/isitagentready-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。在验证成功前，请勿执行此技能中的命令。

isitagentready.com 和 is-agentic.com 分别在浏览器标签页中提供一次性评分，彼此不会记住任何内容，也不知道对方的存在。此 CLI 将二者整合为一个可重复的工作流：使用任一扫描器检查任何网站，获取按优先级排列的修复建议，在 CI 中设置门禁，比较不同时期的结果，与竞争对手对比，并批量扫描整个网站组合——每次扫描都会按来源添加标签并保存在本地，因此历史记录和 open-advice 能准确告诉你哪些内容发生了变化，还有哪些问题尚未修复。

两个扫描器的结果并不一致，而这正是其设计所在。isitagentready.com 按五个固定类别报告 0-5 级；is-agentic.com 则报告 0-100 分，分母因网站而异，不适用的检查不会计入其中。此 CLI 不会对这两种结果取平均值，也不会重新缩放。crossref 会并列显示两种原生评估结果，并且只对确实衡量同一事物的四项检查判定是否一致。

何时使用此 CLI

当你需要检查或提升网站对 AI Agent 的就绪程度时，可以使用此工具：扫描网站对 robots.txt、llms.txt、MCP、OAuth 和商务协议的就绪情况；获取可复制粘贴的修复方案以提升等级；根据就绪情况设置部署门禁；跟踪网站评分随时间的变化；或比较多个网站。它尤其适用于能随后应用所发现修复的编码 Agent。

不适用场景

以下情况请勿使用此 CLI：

• 从头生成 llms.txt 或 robots.txt 文件（此 CLI 用于扫描并提供建议，不会为你编写这些文件）。
• 跟踪 ChatGPT 或 Perplexity 是否引用你的品牌（这是 AI 可见度跟踪，属于另一种产品）。
• 通用 SEO 关键词排名或反向链接审计。
• 获取页面内容的 Markdown 版本供 Agent 阅读（这是目标网站上的 Markdown 内容协商功能，并非此扫描器的功能）。

独特功能

此 API 的其他工具均不具备以下功能。

发布时避免回归

• gate — 当网站的就绪等级低于目标等级，或之前通过的检查出现回归时，让构建失败。

  如果你希望在 CI 中获得确定的退出码，而不是依赖脆弱的 JSON grep，请使用此命令。

  isitagentready-pp-cli gate https://isitagentready.com --min-level 3
  

• open-advice — 列出所有已扫描网站中仍未通过的检查及其修复提示词，让你准确了解还有哪些工作要做。

  如果你想通过一条命令了解“我所有网站还有哪些待处理修复”，请使用此命令。

  isitagentready-pp-cli open-advice --agent
  

跟踪就绪情况随时间的变化

• history — 显示某网站历次扫描的就绪等级，并标记各项检查在扫描之间如何从通过变为失败或从失败变为通过。

  使用此命令可确认修复确实已生效，并发现悄无声息的回归。

  isitagentready-pp-cli history https://example.com --agent
  

• diff — 对比某网站的两次扫描（默认比较最近两次），生成逐项检查的回归/修复/未变化表格，以及等级差值。

  如果你想准确了解两个时间点之间发生了哪些变化，而不只是看到新评分，请使用此命令。

  isitagentready-pp-cli diff https://example.com
  

跨多个网站

• compare — 扫描多个网站，并打印逐项对照矩阵，显示每个网站实现了哪些 Agent 标准，以及各自的等级。

  使用此命令可准确查看竞争对手实现了哪些你尚未实现的标准。

  isitagentready-pp-cli compare https://example.com https://isitagentready.com
  

• batch — 从文件或标准输入读取 URL 列表，逐个扫描并保存，然后按等级或未通过检查的数量打印排行榜。

  使用此命令可按最差优先的顺序梳理整个网站群，而不必一次只在一个浏览器标签页中扫描网站。

  isitagentready-pp-cli batch urls.txt --rank failing --csv
  

交叉核对两个扫描器

• crossref — 针对一个 URL 并列显示 isitagentready.com 的 0-5 级和 is-agentic.com 的 0-100 分，各自使用原生量表，绝不合并；此外，还会对四项实际衡量同一内容的检查给出一致性判定。

  使用此命令可在一个扫描器显示一切正常、而你想再听取第二意见时进行核对，无须假装两个分数相同。

  isitagentready-pp-cli crossref https://example.com
  

• --source is-agentic — 使用第二个扫描器运行任何基于扫描的命令。每次保存的扫描都会标记其来源，因此 history、diff、gate、compare 和 batch 都会使用单一扫描器的量表，不会在不知情的情况下混用。一次运行中的所有 is-agentic 请求——包括并发的 compare 和 batch 扇出请求——都会通过同一个共享客户端发送，因此整个进程不会超过该主机公布的公共报告每秒 2 次请求限额，也不会因自身请求竞争而触发 429 错误。

  使用此命令可像追踪 isitagentready 一样，持续追踪 is-agentic 的情况。

  isitagentready-pp-cli report https://example.com --source is-agentic
  

命令参考

scan — 扫描网站，检查其 AI Agent 就绪情况

• isitagentready-pp-cli scan — 扫描 URL；返回就绪等级（0-5），以及 5 个类别中各项检查的结果

找到合适的命令

当你知道要做什么，却不知道该用哪个命令时，可以直接向 CLI 提问：

isitagentready-pp-cli which "<capability in your own words>"

which 会根据自然语言功能查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出码 0 表示至少找到一个匹配项；退出码 2 表示没有足够可信的匹配项，此时请改用 --help 或缩小查询范围。

使用示例

获取网站可直接复制粘贴的修复内容

isitagentready-pp-cli advice https://example.com --copy

将每项提升到下一级所需的修复提示词打印为一个可直接粘贴的代码块，可直接交给编码 Agent。

查看所有网站仍未修复的问题

isitagentready-pp-cli open-advice --agent

根据本地扫描历史，汇总所有网站仍未通过的检查及其修复提示词。

将冗长的扫描结果缩减为你关心的检查

isitagentready-pp-cli report https://example.com --agent --only-failing --select checks.discovery.mcpServerCard.status,checks.discovery.mcpServerCard.message

完整扫描结果体量大且嵌套层级深；--select 会提取你指定的点分字段，让 Agent 无需解析数十 KB 的数据。

根据就绪情况阻止部署

isitagentready-pp-cli gate https://example.com --min-level 3 --no-regress

如果网站等级低于 3，或任何此前通过的检查出现回退，则以非零状态码退出；适用于 CI。

与竞争对手对比

isitagentready-pp-cli compare https://example.com https://isitagentready.com

打印逐项标准矩阵，显示每个网站实现了哪些 Agent 就绪检查。

使用两个扫描器交叉核对网站

isitagentready-pp-cli crossref https://example.com

分别打印 isitagentready 的 0-5 级和 is-agentic 的 0-100 分，作为两个独立的原生判定；然后打印一张一致性表，列出两个扫描器实际都会衡量的四项检查。两个分数绝不会求平均或重新缩放，因为它们的分母不同（前者固定为五个类别；后者按网站确定，不包含不适用的检查）。如果其中一个扫描器没有该 URL 的报告，仍会打印另一个扫描器的结果。

持续追踪第二个扫描器

isitagentready-pp-cli check https://example.com --source is-agentic
isitagentready-pp-cli history https://example.com --source is-agentic

使用 --source is-agentic 时，check 会打印该扫描器自己的判定——分数及其标签、必需/推荐等级明细，以及每项未通过问题及其修复方法——而不会打印 isitagentready 等级，因为这两种量表表达的含义并不相同。

每次扫描都会连同来源一起保存，每次读取也都会按单一来源筛选，因此 is-agentic 历史记录不会与 isitagentready 历史记录混合。省略 --source 会保留原有的 isitagentready 行为，也包括在此功能推出前记录的扫描。

基于 is-agentic 评分门控 CI

isitagentready-pp-cli gate https://example.com --source is-agentic --min-score 70

--min-score 是 is-agentic 的阈值；--min-level 是 isitagentready 的阈值。传入错误的参数组合（--min-level 配合 --source is-agentic）会被视为用法错误，而不是悄悄重新解释，因为 Level 3 和 70 分表达的并非同一主张。

身份验证设置

无需 API 密钥或登录。扫描端点是公开且只读的，因此所有命令开箱即用。

运行 isitagentready-pp-cli doctor 以验证设置。

Agent 模式

在任意命令中添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可通过管道传递 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 保留部分字段。点分路径可深入嵌套结构；数组会逐元素遍历。对于输出冗长的 API，这对于缩小上下文至关重要：

  isitagentready-pp-cli scan --url https://example --agent --select id,name,status
  

• 可预览 — --dry-run 显示请求，但不发送

• 非交互式 — 绝不提示，每项输入都通过标志传入

• 明确重试行为 — 仅当已存在的创建操作也应视为成功时，才使用 --idempotent

路径和状态

Agent 应将 CLI 的路径解析器视为运行时契约的一部分：

• 单次调用使用 --home <dir>，或设置 ISITAGENTREADY_HOME=<dir>，将所有四类路径重定位到同一个根目录下。

• 仅当某一特定类型需要使用不同路径时，才使用按类型设置的环境变量：ISITAGENTREADY_CONFIG_DIR、ISITAGENTREADY_DATA_DIR、ISITAGENTREADY_STATE_DIR、ISITAGENTREADY_CACHE_DIR。

• 解析顺序为：按类型设置的环境变量、--home、ISITAGENTREADY_HOME、XDG（XDG_CONFIG_HOME、XDG_DATA_HOME、XDG_STATE_HOME、XDG_CACHE_HOME），最后是平台默认值。

• config 包含 config.toml 和配置档案等设置。data 包含 credentials.toml、data.db、Cookie 和身份验证辅助文件。state 包含持久化查询、作业和 teach.log。cache 包含可重新生成的 HTTP/缓存文件。

• 存储的密钥位于 data 目录下的 credentials.toml 中。为保持兼容性，会读取现有旧版 config.toml 中的密钥；首次写入身份验证信息时，这些密钥会从 config.toml 中移出。

• 运行 isitagentready-pp-cli doctor --fail-on warn 以显示路径和凭据位置警告。对于需要已解析目录的 Agent，agent-context 会提供 schema v4 的 paths 区块。

• 对于 MCP，请通过 MCP 宿主配置传递重定位设置。MCP 二进制文件不会继承 CLI 标志：

  {
    "mcpServers": {
      "isitagentready": {
        "command": "isitagentready-pp-mcp",
        "env": {
          "ISITAGENTREADY_HOME": "/srv/isitagentready"
        }
      }
    }
  }
  

集群优先级：继承的按类型环境变量会覆盖该类型显式指定的 --home。使用 ISITAGENTREADY_HOME 或按类型设置的变量作为持久的集群配置方式；--home 仅用于单次调用。通过取消设置环境变量无法撤销重定位；清除 ISITAGENTREADY_HOME 前，请手动移动文件，否则 doctor 将无法找到留在原根目录下的凭据。

Agent 反馈

当你（或 Agent）发现此 CLI 有不妥之处时，请记录下来：

isitagentready-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
isitagentready-pp-cli feedback --stdin < notes.txt
isitagentready-pp-cli feedback list --json --limit 10

条目会以本地方式存储在已解析的 data 目录下的 feedback.jsonl 中。只有在设置了 ISITAGENTREADY_FEEDBACK_ENDPOINT，并且传入了 --send 或设置了 ISITAGENTREADY_FEEDBACK_AUTO_SEND=true 时，才会通过 POST 发送。默认情况下仅存储在本地。

写下令你感到意外的地方，而不是提交错误报告。简短、具体、一行即可：这才是会不断积累价值的部分。

输出传递

每条命令都接受 --deliver <sink>。输出会写入指定的接收端，同时输出到 stdout，或替代 stdout 输出，因此 Agent 无需手动通过管道传递即可路由命令结果。支持以下三种接收端：

接收端	效果
stdout	默认；仅写入 stdout
file:<path>	原子写入输出到 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到 URL（使用 --compact 时，内容类型为 application/json 或 application/x-ndjson）

对于未知方案，系统会拒绝并返回结构化错误，指出支持的方案。Webhook 失败时会返回非零状态码，并在 stderr 中记录 URL 和 HTTP 状态码。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。当定时运行的 Agent 每次都以相同配置调用同一命令时，可以使用配置——这是 HeyGen 的“Beacon”模式。

isitagentready-pp-cli profile save briefing --json
isitagentready-pp-cli --profile briefing scan --url https://example
isitagentready-pp-cli profile list --json
isitagentready-pp-cli profile show briefing
isitagentready-pp-cli profile delete briefing --yes

显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，供进行自省的 Agent 在运行时发现它们。

退出代码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
5	API 错误（上游问题）
7	请求过于频繁（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 isitagentready-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 请参阅上方的前置条件
3. 其他情况 → 直接使用（作为 CLI 命令执行，并带上 --agent）

安装 MCP 服务

1. 安装 MCP 服务：

   go install github.com/mvanhorn/printing-press-library/library/developer-tools/isitagentready/cmd/isitagentready-pp-mcp@latest
   

2. 在 Claude Code 中注册：

   claude mcp add isitagentready-pp-mcp -- isitagentready-pp-mcp
   

3. 验证：claude mcp list

直接使用

1. 检查是否已安装：which isitagentready-pp-cli 如果未找到，请提供安装选项（请参阅本文开头的前置条件）。
2. 根据用户查询，从上方的独特功能和命令参考中选择最合适的命令。
3. 使用 --agent 标志执行：

   isitagentready-pp-cli <command> [subcommand] [args] --agent
   

4. 如果存在歧义，请查看子命令帮助：isitagentready-pp-cli <command> --help。