B2B 线索生成聚合工具，将海关贸易情报、全球企业深度背调与 LinkedIn 职业人脉数据整合为统一工作流。分析 HS 编码的市场分布、贸易趋势与企业贸易占比以评估产品市场规模；基于 220+ 国家海关记录剖析单个公司的真实贸易规模、伙伴、产品与港口；获取宏观国家级贸易概览、Top 买家/供应商与美国进口统计；开展公司深度背调（员工、股东、最终受益人UBO、决策人）并绘制 LinkedIn 职业人脉图谱（同事、校友、履历与学历）。帮助出口商、采购代理、销售团队与 B2B获客专家发现海外买家、验证供应商、加

B2B 线索生成（Lead Generation）

聚合技能：海关贸易情报 + 全球企业深度背调 + LinkedIn 职业人脉。3 大数据源、38 个脚本，按域索引路由。

概览

三大数据源，各由一个域索引（意图->脚本决策表）承载：

运行脚本

环境准备

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

脚本目录：scripts/*.py

重要：始终用直接调用方式，如 python scripts/customs_analysis_area.py。不要用 cd scripts && python customs_analysis_area.py 这类 shell 复合命令。

如何选脚本

1. 把用户意图对应到上表的某个数据源。
2. 打开对应的 indexes/<域>.md —— 它是意图->脚本决策表，把每个意图精确到唯一脚本。
3. 打开该脚本的 references/-api.md 获取准确参数名/格式 —— 切勿猜测参数。

路由决策树

跨技能转交（本技能不含的能力）

以下属 standalone 配套技能，用户需要时转交：

组合工作流（跨数据源，仅聚合技能可做到）

1. 找海外买家全链路（跨技能）：upkuajing-customs-trade-company-search（找有贸易记录的买家）-> 本技能 global-depth/linkedin（找决策人）-> b2b-outreach 校验联系方式 -> b2b-outreach 触达。
2. 供应商背调：global-depth（global_company_search -> company_shareholder_list / company_employee_list）-> customs-company（customs_company_stats 看真实贸易规模）。
3. 人才 mapping：linkedin（linkedin_company_employee_list）-> linkedin_person_experience_list / linkedin_person_education_list（背调）。
4. 先量后打：customs-overview（summary/top_n 估算市场规模）-> customs-analysis（trade_percent 找头部玩家）-> global-depth（背调头部玩家）。

API 密钥与充值

本技能需要 API 密钥，存储在 ~/.upkuajing/.env：

cat ~/.upkuajing/.env

UPKUAJING_API_KEY=your_api_key_here

未设置 API 密钥

先检查 ~/.upkuajing/.env 是否有 UPKUAJING_API_KEY。若没有，提示用户选择：

1. 用户已有：用户提供（手动写入 ~/.upkuajing/.env）
2. 用户没有：用 auth.py --new_key 申请（自动保存到 ~/.upkuajing/.env）

等待用户选择。

账户充值

当 API 返回余额不足时：

1. 创建充值订单（auth.py --new_rec_order）
2. 把支付页面 URL 发给用户，引导其打开并支付；用户确认成功后再继续。

获取账户信息

python scripts/auth.py --account_info

新申请的密钥需在 跨境魔方开放平台 注册绑定。

计费

所有 API 调用均收费，不同接口计费方式不同。

最新定价：访问 详细价格说明，或运行：

python scripts/auth.py --price_info

（返回全部接口定价 —— 聚合版 auth.py 优先拉取全量定价列表，必要时回退到按原始技能名逐一查询。）

计费规则（概要）

• query_count 搜索（4 个脚本：global_company_search、global_company_person_search、linkedin_company_search、linkedin_person_search）：按调用次数计费 = ceil(query_count / 20)；每次返回最多 20 条（query_count 范围 20–1000）。当 query_count > 20 时，先告知用户预计调用次数。
• 其余脚本（customs 分析/公司/宏观；global/linkedin 列表与详情接口）：按次计费。游标分页脚本每次返回一页——传入上次响应的 cursor 获取下一页；单记录脚本（统计、汇总、日期、学校详情）每次返回一条。
• 所有调用均收费——本技能没有免费查询。
• 各接口计费细则见对应 references/-api.md。

计费确认原则

任何收费操作必须先告知用户并在单独的消息中等待明确确认，不得在通知的同一消息中执行。 当 query_count 超过一页时，先告知用户预计调用次数。

错误处理

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

API 文档参考

customs-analysis（路由：indexes/customs-analysis.md）

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

customs-company（路由：indexes/customs-company.md）

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

customs-overview（路由：indexes/customs-overview.md）

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

global-depth（路由：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（路由：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

注意事项

• countryType：1 = 出口国（供应商），2 = 进口国（买家）。
• ID 按数据源隔离：global-depth 的 pid/hid 与 LinkedIn 的 pid/hid 不通用 —— 一次调查保持在单一数据源内。
• 大型搜索查询（global/linkedin *_search）返回 task_id + file_url；用 --task_id 续跑可追加数据。customs 与列表类脚本用游标分页--把上次响应返回的 cursor 放入 --params 获取下一页。
• task_data/ 按 UUID 子目录存放结果。
• 所有平台文件路径使用正斜杠。
• 禁止输出技术参数格式：回复中把代码式参数转为自然语言。
• 不要估算每次调用费用 —— 用 auth.py --price_info 获取准确定价。
• 不要猜测参数名 —— 先读 references/-api.md。

关联技能

其他可能有用的 UpKuaJing 技能：

• b2b-outreach - 发邮件/短信、地图采集商户、校验联系方式（phone/email/domain）
• upkuajing-customs-trade-company-search（= upkuajing-trade-company-search）- 搜索有真实海关贸易记录的公司
• upkuajing-company-people-search（= upkuajing-global-company-people-search）- 快速浅层查公司/人 + 联系方式
• upkuajing-contact-info-validity-check - 独立校验联系方式（phone/email/domain）
• upkuajing-email-tool - 独立的邮件发送与任务跟踪
• upkuajing-sms-tool - 独立的短信发送与任务跟踪
• upkuajing-map-merchants-search - 独立的 Google Maps 商户采集