Built for automation
JSON is the default output. Stable commands and fields let scripts, CI jobs, and AI agents continue the work.
Bring WHOIS, domain traffic, and Google keyword research into one command line. Enter a domain or seed phrase and get structured results built for people, scripts, and AI agents.
One entry point, four research jobs
This interactive workspace demonstrates the core qname-cli capabilities. It cycles automatically, or you can choose a task to inspect its command and response fields.
qname-cli whois canva.com --pretty| Field | Live response |
|---|---|
| Registry ID | 70395741_DOMAIN_COM-VRSN |
| Status | clientTransferProhibited |
| Created / updated | 2001-05-05 / 2026-05-18 |
| Expires | 2030-05-05 |
| Registrar | Gandi SAS · IANA 81 |
| Registrant | Canva Pty. Ltd. · AU |
| WHOIS server | whois.gandi.net |
| Nameservers | 4 AWS DNS records |
| DNSSEC | signedDelegation |
JSON is the default output. Stable commands and fields let scripts, CI jobs, and AI agents continue the work.
Choose API key permissions when you create a key. Each valid call uses 1 account credit.
The public Skill teaches Codex, Claude, and other agents when to call a command, which arguments to use, and how to read the result.
Copy and run
Install and initialize once, then choose a command for the research job. Quote phrases that contain spaces. Google Ads locations and languages use target IDs.
npm install -g @qname/cliInstall the latest stable qname-cli release and register the global command.
qname-cli init --api-key <your-key>Run this once, or provide the key through the QNAME_API_KEY environment variable.
qname-cli whois qname.ai example.com --prettyReturn registration status, registrar, creation and expiry dates, status codes, and nameservers.
qname-cli traffic qname.ai --prettyReturn available visit, source, country, and top-keyword fields for the domain.
qname-cli keywords "ai video generator" --country 2840 --language 1000 --prettyReturn search volume, advertiser competition, top-of-page bid ranges, and a 12-month trend.
qname-cli keywords --website canva.com --network google --prettyGenerate Google Ads ideas from a public site. This does not claim that the site ranks organically for those terms.
qname-cli keywords "ai image generator" --format textReturn a tab-separated summary. Omit --format to keep the default JSON response.
Version 0.2.0 covers WHOIS, domain traffic, and Google keyword research. Each capability requires the matching scope on the API key; the CLI never bypasses account approval or quota controls.
Understand qname-cli access, output formats, keyword data, and agent integration before you automate a research workflow.
Choose the WHOIS, traffic, and keyword research permissions your CLI needs. Each valid query uses 1 account credit. The API reports missing permissions and insufficient credits as separate errors.
Default JSON works best for scripts and AI agents. The --pretty option changes only the JSON indentation for human review. The --format text option returns a compact tab-separated summary that is easy to paste into a spreadsheet, but it does not preserve every nested response field.
The keywords command returns Google Ads ideas and historical metrics, including average monthly searches, advertiser competition, bid ranges, and a 12-month trend. Website discovery generates ideas from public pages; it does not claim that the site already ranks organically for those phrases.
Yes. After you install the QNameAI/qname-cli Skill, an agent receives the command boundaries, arguments, and output-field guidance. The API key still comes from local configuration or QNAME_API_KEY, so the agent can call only the selected permissions and account balance.
The npm package provides the executable. The QNameAI/qname-cli Skill provides agent instructions. Together they let an agent choose the right command while respecting API scopes and quotas.
View the source and Skill