面向自动化
JSON 是默认输出,命令和字段保持稳定,便于脚本、CI 任务与 AI Agent 继续处理。
把 WHOIS、域名流量和 Google 关键词研究放进同一个命令行。输入域名或种子词,获得适合人类阅读、脚本处理和 AI Agent 调用的结构化结果。
一个入口,四种研究任务
这个交互工作台直接演示 qname-cli 的核心能力。它会自动轮播,你也可以选择左侧任务查看对应命令和返回字段。
qname-cli whois canva.com --pretty| 字段 | 真实返回值 |
|---|---|
| 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 |
JSON 是默认输出,命令和字段保持稳定,便于脚本、CI 任务与 AI Agent 继续处理。
创建 API 密钥时选择所需权限。每次有效调用消耗 1 个账户积分。
公开 Skill 告诉 Codex、Claude 等 Agent 何时调用命令、如何传参和怎样解释结果。
复制即可运行
先安装并初始化一次,之后按研究任务选择命令。带空格的关键词需要放在引号中;Google Ads 地区和语言使用目标 ID。
npm install -g @qname/cli安装最新稳定版 qname-cli,并在终端中注册全局命令。
qname-cli init --api-key <your-key>配置只需完成一次;也可以使用 QNAME_API_KEY 环境变量。
qname-cli whois qname.ai example.com --pretty返回注册状态、注册商、创建与到期时间、状态码和域名服务器。
qname-cli traffic qname.ai --pretty返回可用的访问量、来源、地区和热门关键词等域名流量字段。
qname-cli keywords "ai video generator" --country 2840 --language 1000 --pretty返回搜索量、广告竞争、页首出价区间和近 12 个月趋势。
qname-cli keywords --website canva.com --network google --pretty根据公开网站内容生成 Google Ads 关键词建议,不代表该网站的自然搜索排名。
qname-cli keywords "ai image generator" --format text使用制表符分隔的文本摘要;省略 --format 时默认返回 JSON。
0.2.0 已覆盖 WHOIS、域名流量和 Google 关键词研究。每项能力都需要对应权限,每次有效调用扣 1 积分。
开始自动化之前,先了解 qname-cli 的权限、输出格式、关键词数据来源和 Agent 接入方式。
创建密钥时可分别选择 WHOIS、流量和关键词研究权限。每次有效查询消耗 1 个账户积分。权限不足和积分不足会返回不同的错误。
默认 JSON 最适合脚本和 AI Agent 继续处理。--pretty 只改变 JSON 的缩进,便于人工阅读。--format text 会输出紧凑的制表符摘要,适合复制到表格或快速浏览,但不会保留每个嵌套字段。
keywords 命令返回 Google Ads 的关键词建议和历史指标,包括月均搜索量、广告竞争、页首出价区间及近 12 个月趋势。网站挖词根据公开网页生成建议,不表示该网站已经获得这些词的自然搜索排名。
可以。安装 QNameAI/qname-cli Skill 后,Agent 会获得命令边界、参数和输出字段说明。API Key 仍由本机配置或 QNAME_API_KEY 环境变量提供,Agent 只能调用密钥已启用的功能,并与 MCP 共用账户积分。
npm 包提供真实可执行命令,QNameAI/qname-cli Skill 提供 Agent 使用说明。两者结合后,Agent 可以选择正确命令并遵守 API scope 与配额。
查看源码与 Skill