GitHub 專案與貢獻者搜尋 API 技能
📖 簡介
此技能使用 BrowserAct 的 GitHub 專案與貢獻者搜尋 API 來提取 GitHub 上的專案詳細資訊和貢獻者聯絡資料。您只需提供關鍵字、最低星數和更新日期過濾條件，BrowserAct 會遍歷搜尋結果、擷取儲存庫指標，並取得詳細的貢獻者個人檔案，全部透過 API 直接回傳，無需自行建立爬蟲腳本或處理速率限制。
✨ 特色
- 無幻覺：預設工作流程避免 AI 生成幻覺，確保穩定且精準的資料提取。
- 無驗證碼問題：無需處理 reCAPTCHA 或其他驗證挑戰。
- 無 IP 限制：無需處理區域 IP 限制或地理封鎖。
- 更快的執行速度：與純 AI 驅動的瀏覽器自動化解決方案相比，任務執行速度更快。
- 成本效益高：與高 Token 消耗的 AI 解決方案相比，大幅降低資料取得成本。
🔑 API 金鑰設定
在執行前，請檢查 BROWSERACT_API_KEY 環境變數。如果未設定，請勿採取其他措施；詢問並等待使用者提供。
代理必須通知使用者：
「由於您尚未設定 BrowserAct API 金鑰，請前往 BrowserAct 控制台 取得您的金鑰。」
🛠️ 輸入參數
代理應根據使用者需求靈活設定以下參數：
-
KeyWords
- 類型：
string - 說明：用於搜尋儲存庫的關鍵字。
- 範例：
browser automation、react framework、machine learning - 預設值：
browser automation
- 類型：
-
stars
- 類型：
number - 說明：儲存庫應擁有的最低星數。
- 範例：
100、1000 - 預設值：
100
- 類型：
-
updated
- 類型：
string - 說明：根據儲存庫最後更新日期進行過濾（格式：
YYYY-MM-DD）。 - 範例：
2026-01-01、2025-06-01 - 預設值：
2026-01-01
- 類型：
-
Page_Turns
- 類型：
number - 說明：要翻頁的搜尋結果頁面數量。例如，如果有 39 頁且您想要前 2 頁，請輸入
2。 - 範例：
1、2 - 預設值：
1
- 類型：
-
date_limit_per_page
- 類型：
number - 說明：每頁搜尋結果清單中要提取的資料項目數量。
- 範例：
5、10 - 預設值：
5
- 類型：
🚀 叫用方法
代理應執行以下命令來叫用此技能：
# 範例叫用（所有參數）
python -u ./scripts/github_project_contributor_finder_api.py "browser automation" 100 "2026-01-01" 1 5
# 最小叫用（僅關鍵字，其餘使用預設值）
python -u ./scripts/github_project_contributor_finder_api.py "react framework"
⏳ 執行監控
由於此任務涉及自動化的瀏覽器操作，可能需要幾分鐘時間。腳本會持續輸出帶時間戳的狀態日誌（例如 [14:30:05] Task Status: running）。
代理指引：
- 在等待期間監控終端機輸出。
- 只要看到新的狀態日誌出現，表示任務正常執行中；請勿誤判為凍結。
- 僅在狀態長時間未改變或輸出中斷且未產生最終結果時，才考慮觸發重試。
📊 資料輸出
執行成功後，腳本會解析並列印來自 API 回應的結構化結果。
專案欄位：
repository_name：GitHub 儲存庫的名稱。repository_url：儲存庫的 URL 連結。repository_owner_name：儲存庫的擁有者/建立者。repository_description：儲存庫的簡短說明。star_count：儲存庫獲得的星數。
貢獻者欄位：
user_name：貢獻者的 GitHub 使用者名稱。profile_url：貢獻者個人檔案的 URL 連結。bio：貢獻者的個人簡介或簡短說明。repositories_summary：貢獻者擁有的其他儲存庫摘要。personal_website：貢獻者的個人網站連結。twitter：貢獻者的 Twitter 帳號。
⚠️ 錯誤處理與重試
如果在腳本執行期間發生錯誤（例如網路波動或任務失敗），代理應遵循以下邏輯：
-
檢查輸出內容：
- 如果輸出包含
"Invalid authorization"，表示 API 金鑰無效或已過期。請勿重試；引導使用者重新檢查並提供正確的 API 金鑰。 - 如果輸出包含
"concurrent"或"too many running tasks"，表示已達到並行任務限制。請勿重試；引導使用者升級方案。 代理必須通知使用者：「目前任務無法執行，因為您的 BrowserAct 帳戶已達到並行任務限制。請前往 BrowserAct 方案升級頁面 升級您的方案。」
- 如果輸出不包含上述錯誤關鍵字但任務失敗（例如輸出以
Error:開頭或回傳空結果），代理應自動重新執行腳本一次。
- 如果輸出包含
-
重試限制：
- 自動重試限制為一次。如果第二次嘗試失敗，請停止重試並向使用者回報具體錯誤。
🌟 典型使用案例
- 技術招募：從熱門儲存庫收集貢獻者個人資料和社群連結，建立候選人管道。
- 開源探索：依關鍵字和星數搜尋熱門儲存庫，發掘有價值的專案。
- 開發者外展：收集活躍貢獻者的個人網站和 Twitter 帳號，用於開發者工具行銷。
- 社群建立：在特定領域識別並聯繫活躍的開源貢獻者。
- 競爭者分析：監控哪些開發者貢獻於競爭對手的專案。
- 合作夥伴搜尋：尋找儲存庫擁有者以進行潛在合作或贊助。
- 市場研究：分析儲存庫指標和說明，了解技術趨勢。
- 潛在客戶產生：透過尋找使用相關技術堆疊的專案，為開發者工具產生目標潛在客戶。
- 學術研究：在特定研究領域中發現近期更新的儲存庫。
- 人才地圖：根據開發者的 GitHub 貢獻和個人檔案，建立技術人才資料庫。