Data & analysis

Full contact data validation eliminates inaccurate lead information for global B2B prospecting. Run multi-dimensional phone checks to distinguish valid/invalidnumbers, landlines, mobile lines and WhatsApp registered accounts. Complete email authentication

Try it

Verify phone numbers, emails, and domains via the UpKuaJing Open Platform API in one skill.

What it does

Three command-line scripts check contact data against the UpKuaJing API. phone_validity_check.py reports number validity, line type, and WhatsApp status. email_validity_check.py reports email address validity. domain_validity_check.py reports domain validity and security. All three accept single or batch inputs. Every API call incurs a fee, and the skill requires explicit user confirmation before any chargeable operation. An UPKUAJING_API_KEY must be set in ~/.upkuajing/.env; auth.py provides account-info, pricing, and top-up order commands when balance is low.

When to use it

  • Check a phone number's validity, line type, and WhatsApp registration status
  • Verify whether an email address is valid before sending
  • Confirm a domain's validity and security status
  • Batch-validate a list of phone numbers, emails, or domains in one run

The skill document

UpKuaJing Contact Info Validity Check

Check the validity of contact information using the UpKuaJing Open Platform API. This skill provides three detection interfaces: phone validity, email validity, and domain validity.

Overview

This skill provides access to UpKuaJing's contact validity detection through:

  • Phone Validity Check (phone_validity_check.py): Check phone number validity, type, and WhatsApp status
  • Email Validity Check (email_validity_check.py): Check email address validity
  • Domain Validity Check (domain_validity_check.py): Check domain validity and security

Running Scripts

Environment Setup

  1. Check Python: python --version
  2. Install dependencies: pip install -r requirements.txt

Script directory: scripts/*.py Run example: python scripts/*.py

Important: Always use direct script invocation like python scripts/phone_validity_check.py. Do NOT use shell compound commands like cd scripts && python phone_validity_check.py.

Three Detection APIs

Phone Validity Check (phone_validity_check.py)

Check phone number validity, type, and WhatsApp status.

Parameters: See Phone Validity API

Examples:

# Check single phone number
python scripts/phone_validity_check.py --phones "+8613812345678"

# Check multiple phone numbers
python scripts/phone_validity_check.py --phones "+8613812345678 +14155551234 +442071234567"

Email Validity Check (email_validity_check.py)

Check email address validity.

Parameters: See Email Validity API

Examples:

# Check single email
python scripts/email_validity_check.py --emails "test@example.com"

# Check multiple emails
python scripts/email_validity_check.py --emails "test@example.com valid@gmail.com invalid-email"

Domain Validity Check (domain_validity_check.py)

Check domain validity and security status.

Parameters: See Domain Validity API

Examples:

# Check single domain
python scripts/domain_validity_check.py --domains "google.com"

# Check multiple domains
python scripts/domain_validity_check.py --domains "google.com fake-domain-xyz123456.com github.com"

API Key and UpKuaJing Account

  • API Key: Stored in ~/.upkuajing/.env file as UPKUAJING_API_KEY
  • First check: If not set, prompt user to provide or apply at UpKuaJing Open Platform

API Key Not Set

First check if the ~/.upkuajing/.env file has UPKUAJING_API_KEY; If UPKUAJING_API_KEY is not set, prompt the user to choose:

  1. User has one: User provides it (manually add to ~/.upkuajing/.env file)
  2. User doesn't have one: Guide user to apply at UpKuaJing Open Platform Wait for user selection;

Account Top-up

When API response indicates insufficient balance, explain and guide user to top up:

  1. Create top-up order (auth.py --new_rec_order)
  2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;

Get Account Information

Use this script to get account information for UPKUAJING_API_KEY: auth.py --account_info

Fees

All validity check API calls incur fees. Latest pricing: Users can visit Detailed Price Description Or use: python scripts/auth.py --price_info (returns complete pricing for all interfaces)

Fee Confirmation Principle

Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.

Workflow

Decision Guide

User IntentUse API
"Check if phone number is valid"Phone Validity Check
"Verify email address exists"Email Validity Check
"Check if domain is safe"Domain Validity Check

Error Handling

  • API key invalid/non-existent: Check UPKUAJING_API_KEY in ~/.upkuajing/.env file
  • Insufficient balance: Guide user to top up
  • Invalid parameters: Must first check the corresponding API documentation in references/ directory, get correct parameter names and formats from documentation, do not guess

API Documentation Reference

  • Phone Validity: Check references/phone-api.md
  • Email Validity: Check references/email-api.md
  • Domain Validity: Check references/domain-api.md

Notes

  • File paths use forward slashes on all platforms
  • Do not guess parameter names, get accurate parameter names and formats from documentation
  • Prohibit outputting technical parameter format: Do not display code-style parameters in responses, convert to natural language
  • Do not estimate or guess fees — use python scripts/auth.py --price_info to get accurate pricing information

Related Skills

Other UpKuaJing skills you might find useful:

  • linkedin-person-search — Search people from the LinkedIn source
  • global-company-person-search — Search people from the global company database
  • linkedin-company-search — Search companies from the LinkedIn source
  • global-company-search — Search companies from the global company database
  • global-company-shareholder — Query shareholder list from the global company database
  • global-company-employee — Query employee list from the global company database
  • global-company-person-colleague — Query colleague list from the global company database
  • global-company-person-alumni — Query alumni list from the global company database
  • global-company-person-experience — Query work experience list from the global company database
  • global-company-person-education — Query education history list from the global company database
  • global-company-person-school-detail — Query school detail from the global company database
  • upkuajing-global-company-people-search — Global company and people search
  • upkuajing-customs-trade-company-search — Search customs trade companies
  • upkuajing-map-merchants-search — Map-based merchant search
  • upkuajing-email-tool — Send emails and manage email tasks
  • upkuajing-sms-tool — Send SMS and manage SMS tasks
  • upkuajing-contact-info-validity-check — Check contact info validity
  • phone-validity-check — Check phone number validity
  • email-validity-check — Check email address validity
  • domain-validity-check — Check domain validity and security

Questions people ask

Does the skill work without an API key?
No. UPKUAJING_API_KEY must be set in ~/.upkuajing/.env, otherwise the skill prompts the user to supply one or apply at the UpKuaJing Open Platform.
Are the validity checks free?
No. All three APIs charge per call, and the skill requires explicit user confirmation before any fee-incurring operation. Run `python scripts/auth.py --price_info` for current pricing.
Can I check multiple items at once?
Yes. Each script accepts multiple values in its --phones, --emails, or --domains argument, space-separated, for a single batch call.

Related skills

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 installs

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

核验邮箱、手机号及其余联系方式的真实有效性，在开展客户触达前筛选无效数据，提升联系信息准确度，降低消息无效发送概率，服务外贸获客、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 installs

End-to-end B2B outreach toolkit combining bulk cold email, global SMS, Google Maps merchant harvesting and contact validation in one skill. Send enterprisebulk cold email campaigns and global mass SMS with two-way reply support, then monitor full delivery

B2B outreach toolkit: send bulk cold email and global SMS, harvest Google Maps merchants, and validate contact info (phone/WhatsApp, email, domain) before reaching out. Monitor email/SMS delivery status, cleanse CRM contact lists, and run end-to-end cross-border outreach campaigns. Trigger: bulk cold email, email send, email open rate tracker, business domain emails, mass mail for exporters, global bulk SMS, two-way SMS replies, SMS delivery reports, cross-border SMS marketing, Google maps business scraper, merchant data download, radius-based lead search, distributor sourcing, phone number validation, WhatsApp status check, email address validation, domain validity security check, CRM data cleansing, bulk SMS pre-verification, B2B outreach campaign

2 installs

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

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

Checks domain availability to confirm valid or inactive status for corporate websitedomains. It helps sales teams, marketers and researchers validate company domains andimprove email deliverability. As an essential tool for CRM data cleansing, sales-leadve

Verify corporate domain status to filter invalid domains, boost email deliverability and clean your CRM and email lists for exporters. Trigger: domain validity check, corporate domain verification, email‑list scrubbing, CRM data cleansing, sales lead validation

1 installs