Obtain detailed school information including classification, locations and social‑media links. Conduct institution verification and academic‑network research with global institutional‑data resources. Trigger: global institution lookup, educational‑institution verification, academic‑network analysis, institutional‑data enrichment, degree validation research
数据分析
全球公司学校详情查询,从全球公司数据库获取含名称、类型、地理位置与社媒链接的详细学校信息。帮助招聘人员、研究人员与分析师核验教育机构、研究学术关系网、丰富机构数据——适合学历核验、院校研究与学术关系网分析
试用依托全球企业数据库调取人员对应的院校详细资料,获取完整教育档案,梳理目标人员就读院校及整体教育背景,辅助开展客户尽调与人脉分析。
它能做什么
依托全球企业数据库调取人员对应的院校详细资料,获取完整教育档案,梳理目标人员就读院校及整体教育背景,辅助开展客户尽调与人脉分析。
技能文档
全球学校详情查询
使用跨境魔方开放平台API从全球企业库数据查询学校的详细信息。
概述
本技能提供对跨境魔方全球企业库学校详情信息的查询。通过学校ID(sid)获取学校的名称、类型、所在地、网址、社交媒体链接等信息。此为单条记录查询,无需翻页。
sid(学校ID)可从 global-company-person-education(教育经历查询)结果中获取
脚本运行
环境准备
- 检查 Python:
python --version - 安装依赖:
pip install -r requirements.txt
脚本目录:scripts/*.py
运行示例:python scripts/*.py
重要:始终使用直接脚本调用,如 python scripts/school_detail.py。不要使用 shell 复合命令如 cd scripts && python school_detail.py
学校详情查询 (school_detail.py)
- 返回粒度:所有学校详情一次性返回
- 适用场景:根据学校ID查询学校名称、位置、网址和社交媒体信息
- 示例:
- "查询S_001学校的详细信息"
- "查询学校ID aue1fd986ee5cb5d906f9d36286714ed33的学校信息"
- 参数:查看参数说明 学校详情 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密钥,请提示并让用户选择:
- 用户有,由用户提供(手动添加到 ~/.upkuajing/.env 文件)
- 用户没有,你可使用接口进行申请(
auth.py --new_key),申请到新密钥后,会自动保存到 ~/.upkuajing/.env 等待用户选择;
账户充值
如果调用接口响应账户余额不足时,需说明并引导用户进行账户充值:
- 创建充值订单(
auth.py --new_rec_order) - 根据订单响应,发送支付页面URL给用户,引导用户打开地址付款,付款成功后告诉你;
获取账户信息
可通过此脚本,获取UPKUAJING_API_KEY对应的账户信息 auth.py --account_info
API密钥与跨境魔方账号
- 新申请的API密钥:在跨境魔方开放平台注册、登录后进行账号绑定
费用
所有API调用都会产生费用,不同接口计费方式不同。
最新价格:用户可访问 详细价格说明
或者使用:python scripts/auth.py --price_info(返回接口完整定价)
查询计费规则
按调用次数计费,每次查询返回完整的学校详情:
- 每次API调用产生一次费用
- 无需翻页,所有数据一次性返回
- 执行前必须:
- 告知用户本次查询会产生费用
- 停止,等待用户在独立消息中明确确认后,再执行脚本
费用确认原则
任何会产生费用的操作,都必须先告知、等待用户明确确认,不得在告知的同一条消息中直接执行。
工作流程
决策指南
| 用户意图 | 使用API |
|---|---|
| "查询S_001学校的详细信息" | 学校详情查询 |
使用示例
查询学校详情
用户请求:"查询S_001学校的详细信息"
python scripts/school_detail.py --sid S_001
错误处理
- API密钥无效/不存在:检查
~/.upkuajing/.env文件中的UPKUAJING_API_KEY - 余额不足:引导用户充值
- 参数无效:必须先查看 references/ 目录下的对应 API 文档,从文档中获取正确的参数名称和格式,不要猜测
API Documentation Reference
- 学校详情:查看 references/school-detail-api.md
最佳实践
-
查看API文档:
- 执行查询前,必须先查看对应的 API 参考文档
- 查看 references/school-detail-api.md
- 不要猜测参数名称,从文档中获取准确的参数名称和格式
-
跨技能使用:
- 学校ID(
sid)可从 global-company-person-education 或 global-company-person-alumni 查询结果中获取
- 学校ID(
注意事项
- 学校详情一次性返回完整信息,无需翻页
- 学校ID(
sid)可从教育经历记录(global-company-person-education)或校友记录(global-company-person-alumni)中获得 - 文件路径在所有平台上都使用正斜杠
- 禁止输出技术参数格式:不要在回复中展示代码样式的参数,应将其转换为自然语言
- 不要估算或猜测每次调用的费用 — 使用
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 — 全球企业库教育经历查询
- 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 — 域名有效性检测
相关技能
调取全球人员资料库查询目标人员的履历与学术背景,获取完整教育经历清单,完善 B2B 销售客户画像,依托学历背景挖掘潜在人脉关联。
调取 LinkedIn 个人档案里面的院校详细资料,获取目标人员就读院校、求学履历和相关学术信息,辅助外贸拓客以及猎头开展背景调研。
Pull detailed school information from LinkedIn. Verify education institutions and analyze academic networks for recruiters and research specialists. Trigger: LinkedIn school data lookup, educational institution verification, academic‑network research, institutional‑data enrichment, degree validation
Verify overseas candidates’ education history including degrees, majors and GPA. Help HR teams run background checks and select qualified applicants for hiring. Trigger: educational background verification, candidate qualification assessment, overseas applicant screening, GPA check, hiring background validation
调取全球企业人员数据库获取目标人员的任职履历和完整工作时间线,充实 B2B 销售线索画像,梳理联系人过往任职经历,研判对方职业发展轨迹。