GitHub 프로젝트 및 기여자 찾기 API 스킬
📖 개요
이 스킬은 BrowserAct의 GitHub 프로젝트 및 기여자 찾기 API를 활용하여 GitHub에서 프로젝트 세부 정보와 기여자 연락처 정보를 추출합니다. 키워드, 최소 별표 수, 업데이트 날짜 필터만 제공하면 BrowserAct가 검색 결과를 탐색하고 저장소 지표를 추출한 후 상세한 기여자 프로필을 가져와 API를 통해 직접 반환합니다. 크롤러 스크립트를 작성하거나 속도 제한을 처리할 필요가 없습니다.
✨ 특징
- 환각 없음: 사전 설정된 워크플로우는 AI 생성 환각을 방지하여 안정적이고 정확한 데이터 추출을 보장합니다.
- 캡차 문제 없음: reCAPTCHA 또는 기타 인증 문제를 처리할 필요가 없습니다.
- IP 제한 없음: 지역별 IP 제한이나 지리적 차단을 처리할 필요가 없습니다.
- 더 빠른 실행: 순수 AI 기반 브라우저 자동화 솔루션에 비해 작업 실행 속도가 빠릅니다.
- 비용 효율적: 높은 토큰을 소비하는 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 기여 및 프로필을 기반으로 숙련된 개발자 데이터베이스를 구축합니다.