All-in-one B2B lead generation toolkit aggregating customs trade intelligence, global company deep due-diligence and LinkedIn professional network data into asingle workflow. Analyze HS code market distribution, trade trends and company trade-share ranking

B2B Lead Generation

Aggregate skill for B2B lead generation: customs trade intelligence + global-company deep due-diligence + LinkedIn professional data. 38 scripts across 3 data sources, routed by domain index.

Overview

Three data sources, each behind a domain index (intent → script decision table):

Running Scripts

Environment Setup

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

Script directory: scripts/*.py

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

How to pick a script

1. Match the user's intent to a data source in the table above.
2. Open the corresponding indexes/.md - it is an intent→script decision table that pins each intent to exactly one script.
3. Open that script's references/-api.md for exact parameter names/formats - never guess parameters.

Routing Decision Tree

Cross-skill handoff (capabilities NOT in this skill)

These belong to standalone companion skills - hand off when the user needs them:

Combined Workflows (cross-source, only possible in this aggregate)

1. Full overseas-buyer pipeline (cross-skill): upkuajing-customs-trade-company-search (find buyers with trade records) → this skill global-depth/linkedin (find decision-makers) → b2b-outreach validity (clean contacts) → b2b-outreach (reach out).
2. Supplier due-diligence: global-depth (global_company_search → company_shareholder_list / company_employee_list) → customs-company (customs_company_stats to gauge real trade scale).
3. Talent mapping: linkedin (linkedin_company_employee_list) → linkedin_person_experience_list / linkedin_person_education_list (background).
4. Market sizing then targeting: customs-overview (summary / top_n to size a market) → customs-analysis (trade_percent to find dominant players) → global-depth (background the top players).

API Key and Top-up

This skill requires an API key, stored in ~/.upkuajing/.env:

cat ~/.upkuajing/.env

UPKUAJING_API_KEY=your_api_key_here

API Key Not Set

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

1. User has one: user provides it (manually add to ~/.upkuajing/.env)
2. User doesn't have one: apply via auth.py --new_key (auto-saved to ~/.upkuajing/.env)

Wait for user selection.

Account Top-up

When API response indicates insufficient balance:

1. Create top-up order (auth.py --new_rec_order)
2. Send the payment page URL to the user, guide them to open & pay; proceed after they confirm success.

Get Account Information

python scripts/auth.py --account_info

Newly applied keys must be registered/bound at UpKuaJing Open Platform.

Fees

All API calls incur fees; billing methods differ per interface.

Latest pricing: visit Detailed Price Description, or run:

python scripts/auth.py --price_info

(returns complete pricing for all interfaces - the aggregate auth.py queries the full price list and falls back to per-original-skill lookup if needed.)

Billing rules (summary)

• query_count search (4 scripts: global_company_search, global_company_person_search, linkedin_company_search, linkedin_person_search): billed by calls = ceil(query_count / 20); each call returns up to 20 records (query_count range 20–1000). When query_count > 20, inform the user of the expected call count first.
• All other scripts (customs analysis/company/overview; global/linkedin list & detail endpoints): billed per call. Cursor-paginated scripts return one page per call - pass cursor from the previous response to fetch the next page; single-record scripts (stats, summary, date, school detail) return one result per call.
• All calls incur fees - there are no free queries in this skill.
• Per-interface billing detail lives in the corresponding references/-api.md.

Fee Confirmation Principle

Any operation that incurs fees must first inform the user and wait for explicit confirmation in a separate message. Do not execute in the same message as the notification. When query_count exceeds one page, inform the user of the expected number of calls first.

Error Handling

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

API Documentation Reference

customs-analysis (route: indexes/customs-analysis.md)

• area | hscode-detail | hscode-search | overview | trade-percent | trends

customs-company (route: indexes/customs-company.md)

• area-list | area-stats | hscode-list | hscode-stats | partner-stats | port-list | product-list | stats | trends

customs-overview (route: indexes/customs-overview.md)

• date | summary | top-n | trade-list | trend | us-import

global-depth (route: indexes/global-depth.md)

• global-company-list | company-employee-list | company-shareholder-list | global-company-person-list | person-colleague-list | person-alumni-list | person-experience-list | person-education-list | school-detail

linkedin (route: indexes/linkedin.md)

• linkedin-company-list | linkedin-company-employee-list | linkedin-person-list | linkedin-person-colleague-list | linkedin-person-alumni-list | linkedin-person-experience-list | linkedin-person-education-list | linkedin-school-detail

Notes

• countryType: 1 = exporting countries (suppliers), 2 = importing countries (buyers).
• IDs are source-specific: a global-depth pid/hid is not the same as a LinkedIn pid/hid - stay within one source per investigation.
• Large search queries (global/linkedin *_search) return a task_id + file_url; resume with --task_id to append. Customs & list scripts use cursor pagination - pass the cursor from the previous response (inside --params) to fetch the next page.
• task_data/ stores results under UUID subdirectories.
• File paths use forward slashes on all platforms.
• Prohibit outputting technical parameter format: convert code-style params to natural language in responses.
• Do not estimate per-call fees - use auth.py --price_info for accurate pricing.
• Do not guess parameter names - read the references/-api.md first.

Related Skills

Other UpKuaJing skills you might find useful:

• b2b-outreach - Send email/SMS, harvest map merchants, validate contact info (phone/email/domain)
• upkuajing-customs-trade-company-search (= upkuajing-trade-company-search) - Search companies with real customs trade records
• upkuajing-company-people-search (= upkuajing-global-company-people-search) - Quick shallow company/person lookup + contact info
• upkuajing-contact-info-validity-check - Validate contact info (phone/email/domain) standalone
• upkuajing-email-tool - Standalone email send & task tracking
• upkuajing-sms-tool - Standalone SMS send & task tracking
• upkuajing-map-merchants-search - Standalone Google Maps merchant harvesting