编程

支持海外公司内部校友列表查询，按公司 ID 与人员 ID 从全球公司数据库找校友与昔日同事。帮助招聘人员、销售团队与 B2B线索构建者发掘职业关系网、追溯职业履历、扩展联系清单——适合人才寻源、背调调研与人脉关系分析。

试用

依托全球企业数据库检索目标公司对应的校友以及离职前员工名单，梳理企业历史人员脉络，挖掘潜在商务联系人并拓展业务合作机会。

它能做什么

依托全球企业数据库检索目标公司对应的校友以及离职前员工名单，梳理企业历史人员脉络，挖掘潜在商务联系人并拓展业务合作机会。

技能文档

全球企业库校友查询

使用跨境魔方开放平台API从全球企业库数据查询人物的校友信息。

概述

本技能提供对跨境魔方全球企业库校友信息的查询。通过人物ID（hid）和学校ID（sid）获取校友列表。

  • hid（人物ID）可从 global-company-person-search（人物搜索）结果中获取
  • sid（学校ID）可从 global-company-person-education（教育经历查询）结果中获取

脚本运行

环境准备

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

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

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

校友列表查询 (person_alumni_list.py)

  • 返回粒度：每条校友记录为一行
  • 适用场景：查询指定人员在指定学校的校友
  • 示例：
    • "查询H_67890在S_001学校的校友"
    • "获取下一页校友数据"
  • 参数：查看参数说明 校友列表 API

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密钥与跨境魔方账号

费用

所有API调用都会产生费用，不同接口计费方式不同。

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

查询计费规则

按调用次数计费，每次返回一页校友记录：

  • 每次API调用产生一次费用
  • 使用 --cursor 获取更多页（每一页独立计费）
  • 执行前必须：
    1. 告知用户本次查询会产生费用
    2. 停止，等待用户在独立消息中明确确认后，再执行脚本

费用确认原则

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

工作流程

决策指南

用户意图使用API
"查询H_67890在S_001学校的校友"校友列表查询

使用示例

查询校友列表

用户请求："查询H_67890在S_001学校的校友"

python scripts/person_alumni_list.py --hid H_67890 --sid S_001

获取下一页（使用上一次响应返回的cursor）：

python scripts/person_alumni_list.py --hid H_67890 --sid S_001 --cursor '上一次响应返回的cursor字符串'

错误处理

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

API Documentation Reference

  • 校友列表：查看 references/person-alumni-list-api.md

最佳实践

  1. 查看API文档：

    • 执行查询前，必须先查看对应的 API 参考文档
    • 查看 references/person-alumni-list-api.md
    • 不要猜测参数名称，从文档中获取准确的参数名称和格式

  2. 分页查询：

    • 当响应返回非空的 cursor 时，表示还有更多数据
    • 将 cursor 值传入即可获取下一页
    • cursor 为空表示没有更多数据

  3. 跨技能使用：

    • sid（学校ID）可从 global-company-person-education（教育经历查询）结果中获取
    • hid（人物ID）可从 global-company-person-search（人物搜索）结果中获取

注意事项

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

相关技能

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

  • global-company-search — 全球企业库找公司
  • global-company-person-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 — 全球企业库学校详情查询
  • linkedin-person-search — 领英找人
  • linkedin-company-search — 领英找公司
  • upkuajing-global-company-people-search — 全来源统一的企业与人物搜索
  • upkuajing-customs-trade-company-search — 海关贸易企业搜索
  • upkuajing-contact-info-validity-check — 联系方式有效性检测
  • phone-validity-check — 电话号码有效性检测
  • email-validity-check — 邮箱地址有效性检测
  • domain-validity-check — 域名有效性检测

相关技能

Identify corporate alumni and former coworkers via company ID and personnel ID lookups across global business databases. Generate complete alumni rosters forany target enterprise.Recruiters, sales teams and B2B lead generation specialists map professional

Find corporate alumni and former colleagues with company ID and personnel ID. Trace career history and expand professional networks for recruitment and B2B lead development. Trigger: corporate alumni search, find former coworkers, career‑history lookup, B2B network expansion, talent sourcing from alumni groups

1 星标

支持海外企业员工信息查询 / 公司人员名单查询，按公司 ID从海外企业数据库获取员工名单、职位、职级与部门。帮助招聘人员、销售团队、B2B线索构建者、丰富联系人与职位数据——适合人才调研、竞品组织分析、关键人（决策人）定位与线索资格筛选，适用于找采购/技术决策人、招聘挖角与销售线索

依托全球企业数据库查询企业员工清单与人员规模（Headcount），摸清企业内部组织架构，帮外贸销售、猎头从业者挖掘目标企业潜在对接人员。

1 星标

Identifies alumni connections from LinkedIn datasets using school-ID and personnel-IDinputs. It maps out alumni-related ties linked to individuals and educationalinstitutions. Recruiters, sales teams and B2B lead-generation specialists explore alumninetwor

Find alumni connections via school ID and personnel ID from LinkedIn. Trace educational‑based networks to source talents and grow your B2B contact list. Trigger: LinkedIn alumni discovery, educational‑network mapping, alumni‑connection research, talent sourcing, B2B contact enrichment, institutional relationship analysis

3 次安装

支持海外公司同事查询 / 同事团队挖掘，按公司 ID + 人员 ID从全球企业数据库一键找出其公司同事。帮助招聘人员、销售团队、B2B线索构建者、批量寻找潜在联系人——适合关系网拓展、人才背调调研、客户内部决策圈摸排，常用于找到关键人后挖出更多对接人与决策人。

依托全球企业资料库查找目标人员或企业对应的同事及内部团队成员，梳理企业内部人脉网络，助力外贸销售和猎头人员拓展业务人脉，实现精准客户触达。