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 기여도와 프로필을 기반으로 숙련된 개발자 데이터베이스를 구축합니다.