GitHub 專案與貢獻者搜尋器 API 技能
📖 簡介
此技能利用 BrowserAct 的 GitHub 專案與貢獻者搜尋 API，從 GitHub 提取專案細節與貢獻者聯絡資訊。只需提供關鍵字、最低星數與更新日期篩選條件，BrowserAct 便會遍歷搜尋結果、擷取倉庫指標，並獲取詳細貢獻者個人檔案，全部直接透過 API 回傳，無需建置爬蟲腳本或處理速率限制。
✨ 特點
- 無幻覺問題：預設工作流程避免 AI 生成的幻覺，確保穩定且精確的資料提取。
- 無驗證碼問題：無需處理 reCAPTCHA 或其他驗證挑戰。
- 無 IP 限制：無需處理區域性 IP 限制或地理封鎖。
- 執行更快：相較於純 AI 驅動的瀏覽器自動化解決方案，任務執行速度更快。
- 成本效益高：相較於高 Token 消耗的 AI 解決方案，能顯著降低資料獲取成本。
🔑 API 金鑰設定
開始執行前，請檢查 BROWSERACT_API_KEY 環境變數。若未設定，請勿採取其他措施，應詢問並等待使用者提供。
代理必須通知使用者：
「由於您尚未設定 BrowserAct API 金鑰，請前往 BrowserAct Console 取得您的金鑰。」
🛠️ 輸入參數
代理應根據使用者需求靈活設定下列參數：
-
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 帳號。
⚠️ 錯誤處理與重試
若在腳本執行期間發生錯誤（例如網路波動或任務失敗），代理應依照以下邏輯處理：
- 檢查輸出內容：
- 若輸出包含 `