⚡ GitHub OAuth 다중 플랫폼 수집 프레임워크
확장 가능한 ID 생성, 실시간 IMAP OTP 캡처 및 다중 플랫폼 OAuth 토큰 수집을 위한 프로덕션급, AI Agent 친화적 자동화 프레임워크.
📖 개요
GitHub OAuth Harvester는 개발자 팀과 AI Agents가 다중 플랫폼 OAuth 세션을 안전하게 간소화하도록 설계된 모듈형 자동화 프레임워크입니다. RFC를 준수하는 이메일 별칭(aliasing), 클린 프록시 강제 적용, SSL IMAP 리스너 및 범용 데이터베이스 수집 기능을 결합하여 개발자는 주요 개발자 플랫폼 전반에 걸쳐 API 접근을 체계적으로 유지할 수 있습니다.
🎯 대상 플랫폼 및 허용 매트릭스
| Platform | Authentication Flow | Currency / Unit Type | Welcome Allowance | Periodic Allocation | Portal & Signup |
|---|
| Tabi AI | GitHub OAuth | USD Balance ($) | $120.00 USD | +$5–$10 / Daily Check-in | tabitoken.com |
| ... | | | | | |
🛡️ 필수 네트워크 및 보안 전제 조건
1. 필수 클린 프록시 규칙
GitHub의 Web Application Firewall (WAF)는 이상 패턴에 대해 가입 요청을 엄격하게 모니터링합니다. 즉각적인 계정 플래깅이나 섀도우밴(shadowbans)을 방지하려면:
- 필수: Mobile 4G/5G (CGNAT) 또는 클린 주거용 ISP 프록시를 사용해야 합니다.
- 금지: 데이터센터 / 상업 호스팅 ASN 프록시(Cloudflare, AWS, DigitalOcean)는 즉시 WAF 제한을 유발합니다 (
Access is temporarily restricted).
- 규칙: 등록 세션당 1개의 클린 IP를 할당해야 합니다.
2. Google IMAP 16자리 앱 비밀번호 설정
웹메일 상호작용 없이 자율적인 OTP 검색을 활성화하려면:
- 마스터 Google 계정에서 **2단계 인증(2-Step Verification)**을 활성화합니다.
- myaccount.google.com/apppasswords로 이동합니다.
- 전용 앱 비밀번호를 생성합니다 (예:
GitHub Harvester).
- 설정에 16자리 문자열 (
abcdefghijklmnop)을 제공합니다.
🤖 AI 에이전트 친화적 인터페이스 (--json)
본 프레임워크는 AI 에이전트(Hermes, Codex, Claude Code)를 위해 네이티브하게 구축되었습니다. 모든 CLI 명령어는 기계가 읽을 수 있는 출력을 위해 --json 플래그를 지원합니다:
python3 main.py generate --user masteruser --domain gmail.com --count 10 --json
...
🚀 빠른 시작 가이드
1. 설정 구성 (Configuration Setup)
cp config/config.example.toml config/config.toml
2. 이메일 변형 생성 (Generate Email Variations)
python3 main.py generate --user dannboss --domain gmail.com --type dot --count 20
* **ProtonMail Plus-Addressing:**
```bash
python3 main.py generate --user masterboz --domain proton.me --type plus --count 20
3. 실시간 OTP 캡처 (Real-Time OTP Capture)
python3 main.py listen-otp --user [email protected] --password your_16_digit_app_password --timeout 120
4. 로컬 AI 게이트웨이 (9Router)에 직접 세션 주입 (Direct Session Injection to Local AI Gateway)
python3 main.py inject --platform codebuddy --token "<RAW_JWT_TOKEN>"
🌐 커뮤니티 및 공식 지원
📄 라이선스
MIT License에 따라 배포되었습니다. 작성자: D4NNBOZ.