domain-checker

团队内部使用的 Agent Skill 包，用于通过西部数码 API 查询域名是否可以注册。

项目根目录本身就是 skill 包，结构很简单：

SKILL.md
references/
└── west-api.md
scripts/
└── west_domain_check.py

它可以安装到 Codex、Claude Code、Cursor 里作为 skill 使用，也可以直接在命令行运行。

安装为 Agent Skill

Codex、Claude Code、Cursor 的详细安装方式见 INSTALL.md。

也可以直接对 Agent 说：

请从 https://github.com/shishengkai/domain-checker 下载项目代码，
并按照 README/INSTALL.md 把它安装为当前 Agent 可用的 domain-checker skill。

手工安装示例：

python3 install.py --target codex
python3 install.py --target claude
python3 install.py --target cursor
python3 install.py --target cursor-project --project-dir /path/to/project

安装后建议重启对应 Agent，确保它重新加载 skill 元数据。

使用要求

• Python 3.10+
• 已开通 API 权限的西部数码正式代理账号
• 本地配置好 WEST_USERNAME 和 WEST_API_PASSWORD

Python CLI 只使用标准库。requirements.txt 只是为了团队工具链一致性保留。

配置鉴权信息

复制示例文件：

cp env.example .env

填写本地真实值：

WEST_USERNAME="your-west-username"
WEST_API_PASSWORD="your-west-api-password"

西部数码 API 调用鉴权信息的查找路径：登录西部数码 → 管理中心 → 代理商管理 → API接口配置。

不要提交真实 .env。

脚本会自动加载 .env，查找顺序是：

1. 已安装的 skill 目录，用于全局凭据，例如 ~/.cursor/skills/domain-checker/.env。
2. 当前工作目录，用于项目级覆盖。

如果 shell 环境变量里已经有同名变量，环境变量优先级最高。

直接使用

查询一组完整域名：

python3 scripts/west_domain_check.py --domains example.com,example.net

用一组 name 和一组后缀组合查询：

python3 scripts/west_domain_check.py --names alpha,beta --suffixes .com,.net

只验证输入解析，不调用西部数码 API：

python3 scripts/west_domain_check.py --names alpha,beta --suffixes .com,.net --dry-run

输出 JSON，方便 Agent 或脚本继续处理：

python3 scripts/west_domain_check.py --domains example.com --json

注意事项

• 这是团队内部包，不是面向公开生态的多服务商框架。
• 当前实现固定使用西部数码 API。
• 这个 skill 只查询域名是否可注册，不注册域名，也不管理 DNS。
• 西部数码有 API 频率和反滥用限制，请合理控制批量查询规模。