CLI 优先
在脚本、终端和 Agent 工作流中直接调用 QName，不必每次为了查询一个域名打开网页。
Agent-native CLI
qname-cli
QName 的终端入口，让人类和 AI Agent 都能用稳定命令调用已审批的 WHOIS 查询，并获得适合阅读或自动化处理的结构化结果。
安装并运行
qname-cli1
npm install -g @qname/cli2
npx skills add QNameAI/qname-cli -y -g3
qname-cli init --api-key <approved-key>4
qname-cli whois qname.ai example.com --pretty凭证审批
API 访问从用户申请和管理员审批开始，确保每个 key 都绑定到明确的 QName 账号。
内置 Skill
安装公开 Skill 后，Codex、Claude 等 Agent 能理解何时调用 qname-cli，以及如何读取结果。
当前 API 范围
qname-cli 第一阶段会保持克制：它用于域名查询本身，按审批额度开放单次多域名查询，不开放流量增强或更宽的账号操作。
通过 qname-cli whois 查询 WHOIS，按审批额度限制单次域名数
面向人类的 pretty 输出，以及面向自动化的 JSON 输出
通过 npx skills add QNameAI/qname-cli 接入 Agent-native 工作流
多域名请求必须控制在已审批 KEY 的额度内
该 API 不包含流量、反链、排名或域名画像数据
必须先通过审批，才能用 qname-cli init 配置 API Key
CLI 和 Skill 如何配合
npm 包负责安装可执行命令，Skill 是独立的 Agent 使用说明层，告诉 AI Agent 安全命令边界、输入格式和当前 API 限制。
- 1全局安装 @qname/cli，让终端可以调用 qname-cli。
- 2全局安装 QNameAI/qname-cli Skill，交给 Agent 使用。
- 3用 QName 设置页里已审批的 API Key 初始化一次 qname-cli。
- 4在已审批域名额度内运行 qname-cli whois，并检查输出结果。