mcpField
D
domain-query

domain-query

github.com/wmy2981Cloud & DevOps155 installsUpdated 5w ago
Repository

About domain-query

domain-query is a command-line skill that queries domain ICP filing and WHOIS registration details through the 接口盒子 API. It can fetch both together or query one type and output raw JSON.

Key features

  1. 01Query ICP filing details
  2. 02Query WHOIS registration information
  3. 03Choose ICP or WHOIS only
  4. 04Run a live WHOIS query without cache
  5. 05Output raw results as JSON

Use cases

  1. 01Verify a domain's ICP filing
  2. 02Check a domain's registrar, dates, and DNS servers
  3. 03Retrieve WHOIS details while bypassing the cache

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wmy2981/skills --skill domain-query

After installing, type/domain-queryin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.claude-plugin/
plugin.json
references/
icp_api_doc.md
whoisall_api_doc.md
scripts/
.env.example
domain_query.py

Details

From the project README

Domain Query

Queries the 接口盒子 API for ICP filing and WHOIS registration information for any domain — all in one command.

Execution Rule

Run the user's requested command directly without pre-checking dependencies, environment variables, or configuration. If something is wrong, the script will fail with a clear error — check and fix only then.

Environment Variables

VariableDescription
JKHZ_ID接口盒子 (apihz.cn) user ID
JKHZ_KEY接口盒子 API key

The script loads these from ~/.wmyskills/.env (shared across skills) automatically; a scripts/.env in the script directory takes priority if present. Use scripts/.env.example as the template — add the variables to ~/.wmyskills/.env, never overwriting an existing file.

Requirements

pip install python-dotenv

Usage

Script: scripts/domain_query.py

Query all (ICP + WHOIS)
python scripts/domain_query.py example.com
WHOIS live query (skip cache)
python scripts/domain_query.py example.com --live
Query only one item
python scripts/domain_query.py example.com --only icp
python scripts/domain_query.py example.com --only whois
Output raw JSON
python scripts/domain_query.py example.com --json

Query Items

ItemContent
📋 ICP Filing (ICP 备案)Filing number, organization name, type, review date
📝 WHOISRegistrar, registration/expiration dates, DNS servers, domain status, etc.

Arguments

ArgDescription
domainDomain name (required), e.g. example.com
--liveWHOIS live query (bypasses cache; cached is faster)
--onlyQuery only one of: icp, whois
--jsonOutput raw JSON (debugging)

Notes

  • Default behavior queries both items at once
  • WHOIS cache mode is faster; --live gives the freshest data but takes longer

Comments

Markdown supported