域名有效性检查

使用开放平台 API 检查域名的有效性、安全性及敏感状态。

概览

本技能通过单一接口提供域名有效性检测能力：

• 域名有效性检查（domain_validity_check.py）：检查域名的有效性与安全性

脚本运行方式

环境准备

1. 检查 Python 版本：python --version
2. 安装依赖：pip install -r requirements.txt

脚本所在目录：scripts/*.py
运行示例：python scripts/*.py

重要提示：请始终使用直接脚本调用方式，例如 python scripts/domain_validity_check.py。切勿使用 Shell 复合命令，例如 cd scripts && python domain_validity_check.py。

域名有效性检查（domain_validity_check.py）

检查域名的有效性与安全状态。

参数说明：参见域名有效性 API 文档

使用示例：

# 检查单个域名
python scripts/domain_validity_check.py --domains "google.com"

# 检查多个域名
python scripts/domain_validity_check.py --domains "google.com fake-domain-xyz123456.com github.com"

API 密钥与账户

• API 密钥：存储于 ~/.upkuajing/.env 文件中，变量名为 UPKUAJING_API_KEY
• 首次检查：若未配置，将提示用户手动提供或前往开放平台申请

API 密钥未设置

首次运行时检查 ~/.upkuajing/.env 文件中是否存在 UPKUAJING_API_KEY；
若该变量未设置，则提示用户选择以下任一操作：

1. 用户已有密钥：由用户提供（需手动添加至 ~/.upkuajing/.env 文件）
2. 用户尚未申请密钥：引导用户前往开放平台申请
   等待用户完成选择；

账户充值

当 API 响应提示余额不足时，需向用户清晰说明情况并引导其完成充值：

1. 创建充值订单（执行 auth.py --new_rec_order）
2. 根据订单响应结果，向用户提供支付页面 URL，并指导用户打开该链接完成付款；用户付款成功后确认操作完成；

获取账户信息

使用以下脚本查询当前账户信息：auth.py --account_info

费用说明

域名有效性检查 API 调用将产生费用。
最新定价信息：用户可查阅《详细价格说明》文档，
或执行：python scripts/auth.py --price_info（返回所有接口的完整定价信息）

费用确认原则

任何会产生费用的操作，必须首先明确告知用户，并等待用户显式确认后方可执行。不得在通知消息中同步执行操作。

工作流程

决策指引

错误处理

• API 密钥无效或不存在：检查 ~/.upkuajing/.env 文件中 UPKUAJING_API_KEY 的配置
• 账户余额不足：引导用户进行充值
• 参数无效：必须首先查阅 references/ 目录下的对应 API 文档，从中获取准确的参数名称与格式，严禁凭猜测填写

API 文档参考

• 域名有效性 API：参见 references/domain-api.md

注意事项

• 所有平台下均统一使用正斜杠（/）表示文件路径
• 禁止猜测参数名称，务必从官方文档中获取准确的参数名与格式
• 禁止在响应中输出技术参数格式：不得以代码样式展示参数（如 --domains），须转换为自然语言表达
• 禁止估算或猜测费用 —— 请使用 python scripts/auth.py --price_info 获取准确的定价信息

相关技能

您可能还会用到的其他技能：

• linkedin-person-search — 从 LinkedIn 数据源搜索人员
• global-company-person-search — 从全球企业数据库搜索人员
• linkedin-company-search — 从 LinkedIn 数据源搜索企业
• global-company-search — 从全球企业数据库搜索企业
• global-company-shareholder — 查询全球企业数据库中的股东列表
• global-company-employee — 查询全球企业数据库中的员工列表
• global-company-person-colleague — 查询全球企业数据库中的同事列表
• global-company-person-alumni — 查询全球企业数据库中的校友列表
• global-company-person-experience — 查询全球企业数据库中的工作经历列表
• global-company-person-education — 查询全球企业数据库中的教育经历列表
• global-company-person-school-detail — 查询全球企业数据库中的学校详情
• upkuajing-global-company-people-search — 全球企业与人员联合搜索
• upkuajing-customs-trade-company-search — 海关贸易企业搜索
• upkuajing-map-merchants-search — 基于地图的商户搜索
• upkuajing-email-tool — 发送邮件及管理邮件任务
• upkuajing-sms-tool — 发送短信及管理短信任务
• upkuajing-contact-info-validity-check — 检查联系信息有效性
• phone-validity-check — 检查电话号码有效性
• email-validity-check — 检查邮箱地址有效性
• domain-validity-check — 检查域名有效性与安全性