name: global-company-person-education-zh description: 調取全球人員資料庫查詢目標人員的履歷與學術背景，獲取完整教育經歷清單，完善 B2B 銷售客戶畫像，依託學歷背景挖掘潛在人脈關聯。 metadata: {"version":"1.0.2","homepage":"https://www.upkuajing.com","clawdbot":{"emoji":"📚","requires":{"bins":["python"],"env":["UPKUAJING_API_KEY"]},"primaryEnv":"UPKUAJING_API_KEY"}}

全球企業庫教育經歷查詢

使用跨境魔方開放平臺API從全球企業庫資料查詢人物的教育經歷資訊。

概述

本技能提供對跨境魔方全球企業庫人物教育經歷資料的查詢。通過人物ID（hid）獲取其教育經歷列表，包括就讀學校、學位、專業、輔修科目、GPA等資訊。

指令碼執行

環境準備

1. 檢查 Python：python --version
2. 安裝依賴：pip install -r requirements.txt

   7w4.net提供免費和付費技能下載。

指令碼目錄：scripts/*.py 執行示例：python scripts/*.py

重要：始終使用直接指令碼呼叫，如 python scripts/person_education_list.py。不要使用 shell 複合命令如 cd scripts && python person_education_list.py

教育經歷列表查詢 (person_education_list.py)

• 返回粒度：每條教育經歷記錄為一行
• 適用場景：檢視人物的教育背景，瞭解某人曾在哪些學校就讀
• 示例：
• "查詢H_67890的教育經歷"
• "獲取下一頁教育經歷資料"
• 引數：檢視引數說明 教育經歷列表 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金鑰：在跨境魔方開放平臺註冊、登入後進行賬號繫結

費用

所有API呼叫都會產生費用，不同介面計費方式不同。

最新價格：使用者可訪問 詳細價格說明 或者使用：python scripts/auth.py --price_info（返回介面完整定價）

查詢計費規則

按呼叫次數計費，每次返回一頁教育經歷記錄： - 每次API呼叫產生一次費用 - 使用 --cursor 獲取更多頁（每一頁獨立計費） - 執行前必須： 1. 告知使用者本次查詢會產生費用 2. 停止，等待使用者在獨立訊息中明確確認後，再執行指令碼

費用確認原則

任何會產生費用的操作，都必須先告知、等待使用者明確確認，不得在告知的同一條訊息中直接執行。

工作流程

決策指南

使用示例

查詢教育經歷列表

使用者請求："查詢H_67890的教育經歷"

python scripts/person_education_list.py --hid H_67890

獲取下一頁（使用上一次響應返回的cursor）：

python scripts/person_education_list.py --hid H_67890 --cursor '上一次響應返回的cursor字串'

錯誤處理

• API金鑰無效/不存在：檢查 ~/.upkuajing/.env 檔案中的 UPKUAJING_API_KEY
• 餘額不足：引導使用者充值
• 引數無效：必須先檢視 references/ 目錄下的對應 API 文件，從文件中獲取正確的引數名稱和格式，不要猜測

API Documentation Reference

• 教育經歷列表：檢視 references/person-education-list-api.md

最佳實踐

1. 檢視API文件：
2. 執行查詢前，必須先檢視對應的 API 參考文件
3. 檢視 references/person-education-list-api.md

4. 不要猜測引數名稱，從文件中獲取準確的引數名稱和格式

5. 分頁查詢：

6. 當響應返回非空的 cursor 時，表示還有更多資料
7. 將 cursor 值傳入即可獲取下一頁

8. cursor 為空表示沒有更多資料

9. 跨技能使用：

10. 教育經歷返回的 sid（學校ID）可與 global-company-person-school-detail 配合使用，查詢學校詳情（名稱、位置、網站等）

注意事項

• 教育經歷記錄用 hid 作為人員唯一標識；sid 為學校標識
• degrees 是學業程度陣列；majors 和 minors 分別是專業和輔修科目陣列
• 檔案路徑在所有平臺上都使用正斜槓
• 禁止輸出技術引數格式：不要在回覆中展示程式碼樣式的引數，應將其轉換為自然語言
• 不要估算或猜測每次呼叫的費用 — 使用 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-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 — 域名有效性檢測

這個 Skill 質量不錯，文件寫得清楚明白，使用起來也很簡單直接。主要優點是錯誤提示詳細、費用說明清晰、能自動翻頁檢視更多資料。不過功能目前比較單一，只能查教育經歷。另外每次查詢都會自動檢查版本，可能會有額外的網路請求。整體而言，作為付費 API 的封裝，完成度挺高的，但功能範圍有限。