全球學校詳情查詢

使用跨境魔方開放平臺API從全球企業庫資料查詢學校的詳細資訊。

概述

本技能提供對跨境魔方全球企業庫學校詳情資訊的查詢。通過學校ID（sid）獲取學校的名稱、型別、所在地、網址、社交媒體連結等資訊。此為單條記錄查詢，無需翻頁。

• sid（學校ID）可從 global-company-person-education（教育經歷查詢）結果中獲取

指令碼執行

環境準備

1. 檢查 Python：python --version
2. 安裝依賴：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金鑰，請提示並讓使用者選擇：

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呼叫產生一次費用
• 無需翻頁，所有資料一次性返回
• 執行前必須：
  1. 告知使用者本次查詢會產生費用
  2. 停止，等待使用者在獨立訊息中明確確認後，再執行指令碼

費用確認原則

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

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

工作流程

決策指南

使用示例

查詢學校詳情

使用者請求："查詢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

最佳實踐

1. 檢視API文件：

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

2. 跨技能使用：

   • 學校ID（sid）可從 global-company-person-education 或 global-company-person-alumni 查詢結果中獲取

注意事項

• 學校詳情一次性返回完整資訊，無需翻頁
• 學校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 — 域名有效性檢測

整體質量不錯。文件清晰易懂，操作步驟明確，查詢使用方便，錯誤提示友好，費用和風險提示做得很到位，使用者體驗良好。缺點是功能比較單一，只能查學校詳情一個內容，如果需要查詢更多維度的企業人員資訊，可能需要找其他工具配合使用。