邮箱有效性检查

通过 Open Platform API 检查邮箱地址的有效性与状态。

概述

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

• 邮箱有效性检查（email_validity_check.py）：检查邮箱地址有效性

脚本运行方式

环境准备

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

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

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

邮箱有效性检查（email_validity_check.py）

检查邮箱地址是否有效。

参数说明：参见 Email Validity API 文档

使用示例：

# 检查单个邮箱
python scripts/email_validity_check.py --emails "test@example.com"

# 检查多个邮箱
python scripts/email_validity_check.py --emails "test@example.com valid@gmail.com invalid-email"

API 密钥与账户

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

API 密钥未设置

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

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

账户充值

当 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 文档参考

• 邮箱有效性检查：参见 references/email-api.md

注意事项

• 所有平台均统一使用正斜杠（/）表示文件路径
• 禁止猜测参数名称：务必从文档中获取准确的参数名与格式
• 禁止在响应中输出技术参数格式：不得以代码风格展示参数，应转换为自然语言描述
• 禁止估算或猜测费用 —— 必须通过 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 — 检查域名有效性与安全性