領英校友查詢

使用跨境魔方開放平臺API從領英資料查詢人物的校友資訊。

概述

本技能提供對跨境魔方領英校友資訊的查詢。通過人物ID（hid）和學校ID（sid）獲取校友列表。

• hid（人物ID）可從 linkedin-person-search（人物搜尋）結果中獲取
• sid（學校ID）可從 linkedin-person-education（教育經歷查詢）結果中獲取

指令碼執行

環境準備

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

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

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

校友列表查詢 (linkedin_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金鑰：在跨境魔方開放平臺註冊、登入後進行賬號繫結

費用

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

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

查詢計費規則

按呼叫次數計費，每次返回一頁校友記錄：

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

費用確認原則

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

工作流程

決策指南

使用示例

查詢校友列表

使用者請求："查詢H_67890在S_001學校的校友"

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

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

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

錯誤處理

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

API Documentation Reference

• 校友列表：檢視 references/linkedin-person-alumni-list-api.md

最佳實踐

1. 檢視API文件：

   • 執行查詢前，必須先檢視對應的 API 參考文件
   • 檢視 references/linkedin-person-alumni-list-api.md
   • 不要猜測引數名稱，從文件中獲取準確的引數名稱和格式

2. 分頁查詢：

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

     訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

   • cursor 為空表示沒有更多資料

3. 跨技能使用：

   • sid（學校ID）可從 linkedin-person-education（教育經歷查詢）結果中獲取
   • hid（人物ID）可從 linkedin-person-search（人物搜尋）結果中獲取

注意事項

• 校友記錄用 hid 作為人員唯一標識；sid 為學校標識
• 檔案路徑在所有平臺上都使用正斜槓
• 禁止輸出技術引數格式：不要在回覆中展示程式碼樣式的引數，應將其轉換為自然語言
• 不要估算或猜測每次呼叫的費用 — 使用 python scripts/auth.py --price_info 獲取準確定價資訊
• 不要猜測引數名稱，從文件中獲取準確的引數名稱和格式

相關技能

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

• linkedin-person-search — 領英找人
• linkedin-person-education — 領英教育經歷查詢
• linkedin-company-search — 領英找公司
• global-company-person-alumni — 全球企業庫校友查詢
• linkedin-person-colleague — 領英同事查詢
• global-company-person-search — 全球企業庫找人
• upkuajing-global-company-people-search — 全來源統一的企業與人物搜尋
• upkuajing-contact-info-validity-check — 聯絡方式有效性檢測
• phone-validity-check — 電話號碼有效性檢測
• email-validity-check — 郵箱地址有效性檢測
• domain-validity-check — 域名有效性檢測- upkuajing-email-tool — 郵件驗證與傳送工具
• upkuajing-sms-tool — 簡訊工具

這個 Skill 質量較好，文件齊全、教程詳細，新手也能快速上手。程式碼結構清晰，錯誤提示友好，費用資訊展示貼心。不足之處是部分敏感操作沒有二次確認，版本更新偶爾有點小瑕疵。總體來說，是一個可靠實用的領英校友查詢工具，值得使用。