TL;DR

wcctl은 macOS의 WeChat 4.x 로컬 데이터를 AI agent와 스크립트가 읽을 수 있게 만드는 독립형 CLI 도구입니다. 초기에는 SIP를 일시적으로 끄고 WeChat 프로세스에서 데이터베이스 키를 획득해야 하지만, 이후 연락처·채팅방·세션·메시지 조회는 읽기 전용으로 SIP 활성 상태에서 실행됩니다. 각 명령은 JSON 출력을 제공해 최근 대화 선택부터 제한된 메시지 추출까지 shell pipeline으로 연결할 수 있습니다. 다만 첨부파일 자체 export가 없고 라이선스의 사용 지역·데이터 권한·재배포 제한이 강하므로, 개인 Mac에서 허가받은 WeChat 데이터를 로컬 자동화에 연결하려는 경우에 적합합니다.

핵심 포인트

• wcctl은 macOS용 WeChat 4.x 데이터를 읽는 독립형 CLI 도구입니다. 연락처·그룹 채팅·최근 대화·메시지를 조회하고, 목록은 표 형식으로 출력하며 다른 명령은 JSON으로 내보냅니다. Codex 같은 로컬 AI agent나 jq·Python·스프레드시트와 연결할 때 WeChat 데이터베이스 형식을 직접 처리하지 않아도 됩니다.
• 초기 키 획득에는 System Integrity Protection을 일시적으로 비활성화해야 합니다. `wcctl key acquire`가 WeChat을 닫고 계정별 데이터베이스 키를 확인한 뒤 `~/.wcctl/keys.json`에 저장하며, 완료 후 SIP를 다시 활성화해야 합니다. 정상 조회는 SIP가 켜진 상태에서도 가능하지만 설치보다 권한과 재부팅 절차의 부담이 큽니다.
• 조회 명령은 APFS copy-on-write clone 또는 일반 private copy에서 데이터베이스와 WAL을 복제한 뒤 읽기 전용으로 처리합니다. `sessions -json`으로 대화를 찾고 `messages -chat USERNAME -limit N -json`으로 필요한 메시지만 가져오는 파이프라인을 구성할 수 있습니다. 이미지·영상·음성 등의 첨부파일 metadata는 읽을 수 있지만 media 파일 자체 export는 아직 지원하지 않습니다.
• 데이터를 외부 서비스로 자동 업로드하지 않지만 JSON을 전달받는 연결 도구가 이후 처리하는 내용까지 막지는 않습니다. `keys.json`과 retained memory capture에는 데이터베이스 키와 메시지 등 민감한 정보가 포함될 수 있어 별도 관리가 필요합니다. Schedule A는 허가받은 데이터의 computational data analysis만 허용하고 미국·중국 본토·홍콩 밖에서의 사용 등 강한 지역·배포 조건을 둡니다.