GitHub 프로젝트 및 기여자 찾기 API 스킬
📖 개요
이 스킬은 BrowserAct의 GitHub 프로젝트 및 기여자 찾기 API를 활용하여 GitHub에서 프로젝트 세부 정보와 기여자 연락처 정보를 추출합니다. 키워드, 최소 별점, 업데이트 날짜 필터만 제공하면 BrowserAct가 검색 결과를 탐색하고 저장소 지표를 추출하며 기여자 프로필을 가져와 API를 통해 직접 반환하므로 크롤러 스크립트를 작성하거나 속도 제한을 처리할 필요가 없습니다.
✨ 기능
- 환각 없음: 사전 설정된 워크플로우는 AI 생성적 환각을 피하여 안정적이고 정확한 데이터 추출을 보장합니다.
- CAPTCHA 문제 없음: 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 기여 및 프로필을 기반으로 숙련된 개발자 데이터베이스를 구축합니다.