TL;DR

GetContact CLI는 GetContact의 비공개 API를 Android 앱이나 브라우저 없이 호출하는 Python standalone CLI tool입니다. 대화형 메뉴와 명령 모드를 통해 단일 번호의 프로필·태그 조회, 계정 quota 확인, CSV 기반 일괄 조회, captcha 처리, 다중 credential 관리를 수행합니다. 요청에는 AES-256-ECB와 HMAC-SHA256이 사용되고, Diffie-Hellman 교환으로 만든 `finalKey`와 계정 token이 로컬 credential 파일에 저장됩니다. 다만 공식 클라이언트가 아니며 개인정보 조회와 서비스 약관 위반 가능성, API 변경과 quota·captcha·계정 제한 위험이 있어 권한 있는 테스트 목적에만 적합합니다.

핵심 포인트

• GetContact의 비공개 API를 Android 앱이나 브라우저 없이 Python CLI에서 호출합니다. `search`, `quota`, `batch`, `captcha` 명령으로 단일 번호와 CSV 목록을 처리하며 조회 결과를 파일로 저장합니다. 공식 클라이언트가 아니고 서비스 약관과 개인정보 보호 규정을 직접 확인해야 합니다.
• 계정 등록 과정에서 VerifyKit과 WhatsApp 인증을 거쳐 토큰과 `finalKey`를 발급받습니다. 요청 본문은 AES-256-ECB로 암호화하고 `x-req-signature`에는 timestamp와 payload를 결합한 HMAC-SHA256을 사용합니다. 자격 증명은 `~/.config/gtc/credentials.json`에 저장되므로 파일과 토큰을 비밀번호처럼 관리해야 합니다.
• 대화형 메뉴와 스크립팅용 명령 모드를 함께 제공해 반복 조회와 자동화 작업을 나눠 처리합니다. 번호는 인도네시아 기준 E.164 형식으로 정규화하고 batch 작업에서는 실패한 행을 기록한 뒤 나머지 입력을 계속 처리합니다. 요청 속도가 높으면 captcha나 계정 제한이 발생할 수 있어 `--delay` 조정이 필요합니다.

이미지 분석