数据分析

联系方式有效性校验，验证电话号码有效、无效、座机、手机、是否注册WhatsApp多种状态，验证邮箱地址有效和无效，支持网站域名有效、无效。帮助销售团队、招聘人员、贸易商验证联系数据（邮箱验证、手机号验证、域名校验）、减少退信邮件、提升外联与冷启动效率——是 CRM 数据清洗、候选人筛查、供应商核验、邮件列表清洗的必备工具，适用于外贸邮件群发前清洗、招聘背调与采购商核实。

试用

核验邮箱、手机号及其余联系方式的真实有效性，在开展客户触达前筛选无效数据，提升联系信息准确度，降低消息无效发送概率，服务外贸获客、CRM 数据清洗和销售线索核验工作。

它能做什么

核验邮箱、手机号及其余联系方式的真实有效性，在开展客户触达前筛选无效数据，提升联系信息准确度，降低消息无效发送概率，服务外贸获客、CRM 数据清洗和销售线索核验工作。

技能文档

跨境魔方联系方式有效性检测

使用跨境魔方开放平台API检测联系方式的有效性。本技能提供三种检测接口：电话有效性、邮件有效性、域名有效性。

概述

本技能通过三个脚本提供对跨境魔方联系方式有效性检测服务的访问：

  • 电话有效性检测 (phone_validity_check.py): 检测电话号码的有效性、类型及WhatsApp状态
  • 邮件有效性检测 (email_validity_check.py): 检测邮箱地址的有效性
  • 域名有效性检测 (domain_validity_check.py): 检测域名的有效性及安全性

脚本运行

环境准备

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

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

重要：始终使用直接脚本调用，如 python scripts/phone_validity_check.py。不要使用 shell 复合命令如 cd scripts && python phone_validity_check.py。

三种检测API

电话有效性检测 (phone_validity_check.py)

检测电话号码的有效性、类型及WhatsApp状态。

参数：查看参数说明 电话有效性检测

示例：

# 检测单个电话号码
python scripts/phone_validity_check.py --phones "+8613812345678"

# 检测多个电话号码
python scripts/phone_validity_check.py --phones "+8613812345678 +14155551234 +442071234567"

邮件有效性检测 (email_validity_check.py)

检测邮箱地址的有效性。

参数：查看参数说明 邮件有效性检测

示例：

# 检测单个邮箱
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"

域名有效性检测 (domain_validity_check.py)

检测域名的有效性及安全性状态。

参数：查看参数说明 域名有效性检测

示例：

# 检测单个域名
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密钥。API密钥保存在 ~/.upkuajing/.env 文件中：

cat ~/.upkuajing/.env

文件内容示例：

UPKUAJING_API_KEY=your_api_key_here

未设置API密钥

请先检查 ~/.upkuajing/.env 文件是否有 UPKUAJING_API_KEY; 如果未设置 UPKUAJING_API_KEY API密钥，请提示并让用户选择：

  1. 用户有，由用户提供(手动添加到 ~/.upkuajing/.env 文件)
  2. 用户没有，你可使用接口进行申请（auth.py --new_key），申请到新密钥后，会自动保存到 ~/.upkuajing/.env 等待用户选择；

账户充值

如果调用接口响应账户余额不足时，需说明并引导用户进行账户充值：

  1. 创建充值订单（auth.py --new_rec_order）
  2. 根据订单响应，发送支付页面URL给用户，引导用户打开地址付款，付款成功后告诉你；

获取账户信息

可通过此脚本，获取UPKUAJING_API_KEY对应的账户信息 auth.py --account_info

费用

所有有效性检测API调用会产生费用。

最新价格：用户可访问 详细价格说明 或者使用：python scripts/auth.py --price_info（返回接口完整定价）

费用确认原则

任何会产生费用的操作，都必须先告知、等待用户明确确认，不得在告知的同一条消息中直接执行。

工作流程

决策指南

用户意图使用API
"检测电话号码是否有效"电话有效性检测
"验证邮箱地址是否存在"邮件有效性检测
"检测域名是否安全"域名有效性检测

错误处理

  • API密钥无效/不存在：检查 ~/.upkuajing/.env 文件中的 UPKUAJING_API_KEY
  • 余额不足：引导用户充值
  • 参数无效：必须先查看 references/ 目录下的对应 API 文档，从文档中获取正确的参数名称和格式，不要猜测

API 文档参考

  • 电话有效性检测：查看 references/phone-api.md
  • 邮件有效性检测：查看 references/email-api.md
  • 域名有效性检测：查看 references/domain-api.md

注意事项

  • 文件路径在所有平台上都使用正斜杠
  • 不要猜测参数名称，从文档中获取准确的参数名称和格式
  • 禁止输出技术参数格式：不要在回复中展示代码样式的参数，应将其转换为自然语言
  • 不要估算或猜测费用 — 使用 python scripts/auth.py --price_info 获取准确定价信息

相关技能

其他您可能会用到的跨境魔方技能：

  • linkedin-person-search — 领英找人
  • global-company-person-search — 全球企业库找人
  • linkedin-company-search — 领英找公司
  • 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 — 域名有效性检测

相关技能

邮箱有效性检查，验证邮箱地址格式，有效和无效状态。帮助销售团队、招聘人员、市场营销人员验证邮箱有效性、降低邮件退信率、提升外联与冷启动效率——是 CRM数据清洗、候选人筛查、供应商核验、邮件列表清洗的必备工具，适用于外贸邮件群发前清洗、招聘背调与采购商核实。

核验邮箱地址的真实可用状态，逐条返回邮箱验证结果以及判定原因，清理无效邮箱数据，降低外贸邮件群发退信概率，完成邮件列表合规清洗。

手机号有效性校验，验证电话号码有效、无效、座机、手机、是否注册WhatsApp多种状态，帮助销售团队、招聘人员、贸易商、外贸从业者检查手机号真实性、减少无效联系人、提升客户触达效率——是 CRM 数据清洗、候选人筛查、供应商核验的必备工具，适用于外贸短信群发前清洗、招聘背调与采购商核实。

核验电话号码真实有效性、号码类型以及 WhatsApp 注册状态，输出核验结果、号码分类、国家代码和 WhatsApp 启用情况，筛选无效联系方式，提升外贸客户触达效率。

It validates phone-number status including valid, invalid, landline, mobile andWhatsApp-registered statuses. It helps sales teams, recruiters, traders and exportersverify phone-number authenticity, cut invalid contacts and boost outreach efficiency. Thises

Verify mobile and landline numbers and WhatsApp registration status. Reduce invalid contacts to improve outreach for exporters, recruiters and sales teams. Trigger: phone number validation, WhatsApp status check, CRM data cleansing, bulk SMS pre‑verification, supplier verification

2 次安装

域名有效性检查，验证企业网站域名有效、无效状态。帮助销售团队、市场人员和研究人员检查公司域名、提升邮件触达率——是 CRM数据清洗、销售线索验证、供应商核验、邮件列表清洗的必备工具，适用于外贸邮件群发前清洗、招聘背调与采购商核实。

核验域名可用性、安全状态以及风险标记，输出域名验证结论、校验失败原因和敏感标签，清理风险域名，优化外贸邮件列表并降低邮件退信概率。

Validates email addresses by checking format compliance and active-or-inactive status. Ithelps sales teams, recruiters and marketers confirm email authenticity, lower bounce ratesand boost cold-outreach performance. This indispensable tool delivers CRM dat

Verify email validity and format, cut email bounce‑rates and clean contact lists for exporters, recruiters and B2B sales teams. Trigger: email address validation, reduce email bounce rate, email‑list scrubbing, CRM data cleansing, cold outreach optimization

1 次安装