面向自动化
JSON 是默认输出，命令和字段保持稳定，便于脚本、CI 任务与 AI Agent 继续处理。
Agent-native CLI · v0.2.0
qname-cli
把 WHOIS、域名流量和 Google 关键词研究放进同一个命令行。输入域名或种子词，获得适合人类阅读、脚本处理和 AI Agent 调用的结构化结果。
一个入口，四种研究任务
看见命令如何变成证据
这个交互工作台直接演示 qname-cli 的核心能力。它会自动轮播，你也可以选择左侧任务查看对应命令和返回字段。
QName AI research session
v0.2.0当前命令
$
qname-cli whois canva.com --pretty·domain: canva.com·source: WHOIS
| 字段 | 真实返回值 |
|---|---|
| Registry ID | 70395741_DOMAIN_COM-VRSN |
| 状态 | clientTransferProhibited |
| 创建 / 更新 | 2001-05-05 / 2026-05-18 |
| 到期时间 | 2030-05-05 |
| 注册商 | Gandi SAS · IANA 81 |
| 注册主体 | Canva Pty. Ltd. · AU |
| WHOIS 服务器 | whois.gandi.net |
| 域名服务器 | 4 个 AWS DNS |
| DNSSEC | signedDelegation |
qname.ai/apiWHOIS 已返回
按权限开放
每个 API Key 都绑定已审批的能力类型、单次请求额度和每日请求额度。
内置 Agent Skill
公开 Skill 告诉 Codex、Claude 等 Agent 何时调用命令、如何传参和怎样解释结果。
复制即可运行
qname-cli 常见用法
先安装并初始化一次，之后按研究任务选择命令。带空格的关键词需要放在引号中；Google Ads 地区和语言使用目标 ID。
01
安装 CLI
npm install -g @qname/cli安装最新稳定版 qname-cli，并在终端中注册全局命令。
02
配置已审批的 API Key
qname-cli init --api-key <approved-key>配置只需完成一次；也可以使用 QNAME_API_KEY 环境变量。
03
查询单个或多个域名
qname-cli whois qname.ai example.com --pretty返回注册状态、注册商、创建与到期时间、状态码和域名服务器。
04
查询域名流量
qname-cli traffic qname.ai --pretty返回可用的访问量、来源、地区和热门关键词等域名流量字段。
05
拓展 Google 关键词
qname-cli keywords "ai video generator" --country 2840 --language 1000 --pretty返回搜索量、广告竞争、页首出价区间和近 12 个月趋势。
06
从网站发现关键词
qname-cli keywords --website canva.com --network google --pretty根据公开网站内容生成 Google Ads 关键词建议，不代表该网站的自然搜索排名。
07
输出便于脚本处理的表格
qname-cli keywords "ai image generator" --format text使用制表符分隔的文本摘要；省略 --format 时默认返回 JSON。
qname-cli API 范围
0.2.0 已覆盖 WHOIS、域名流量和 Google 关键词研究。每项能力都需要 API Key 拥有对应 scope；CLI 不会绕过账号审批或配额。
whois 支持单域名和已审批额度内的批量域名查询
traffic 查询域名流量与访问表现
keywords 支持 1–10 个种子词和网站挖词两种模式
关键词研究支持地区、语言、Google 搜索网络与分页参数
默认 JSON 输出；--pretty 美化 JSON；--format text 输出摘要
不提供反链、域名评分、排名追踪或域名购买操作
关于 qname-cli
开始自动化之前，先了解 qname-cli 的权限、输出格式、关键词数据来源和 Agent 接入方式。
qname-cli 需要哪些权限？
每个命令都需要 API Key 拥有对应 scope。WHOIS、流量和关键词研究权限可以分别审批；单次请求数与每日额度也由 Key 控制。命令缺少权限时会返回明确错误，不会静默跳过限制。
qname-cli 的 JSON、--pretty 和 --format text 有什么区别？
默认 JSON 最适合脚本和 AI Agent 继续处理。--pretty 只改变 JSON 的缩进，便于人工阅读。--format text 会输出紧凑的制表符摘要，适合复制到表格或快速浏览，但不会保留每个嵌套字段。
qname-cli 的关键词研究数据来自哪里？
keywords 命令返回 Google Ads 的关键词建议和历史指标，包括月均搜索量、广告竞争、页首出价区间及近 12 个月趋势。网站挖词根据公开网页生成建议，不表示该网站已经获得这些词的自然搜索排名。
AI Agent 可以直接使用 qname-cli 吗？
可以。安装 QNameAI/qname-cli Skill 后，Agent 会获得命令边界、参数和输出字段说明。API Key 仍由本机配置或 QNAME_API_KEY 环境变量提供，Agent 只能调用该 Key 已审批的能力和额度。
CLI 和 Skill 如何配合
npm 包提供真实可执行命令，QNameAI/qname-cli Skill 提供 Agent 使用说明。两者结合后，Agent 可以选择正确命令并遵守 API scope 与配额。
查看源码与 Skill- 1安装 @qname/cli，让终端和 Agent 环境可以调用 qname-cli。
- 2运行 npx skills add QNameAI/qname-cli -y -g 安装公开 Skill。
- 3从 QName AI 设置页申请所需的 WHOIS、流量或关键词研究权限。
- 4初始化已审批的 API Key，再让 Agent 在允许范围内执行研究任务。