snstool

왜 만들었나

제가 만든 프로그램·게임을 SNS로 알리려면 매번 업데이트 내용을 캡션으로 옮기고, 해시태그를 고르고, 이미지를 맞추는 반복 작업이 있습니다. 혼자 하다 보니 이 작업 자체가 밀리기 쉬웠고, 그렇다고 자동화를 "계정이 알아서 돌아가게" 만들면 자동 팔로우·좋아요·DM처럼 계정 정지로 이어지는 행동까지 손대게 될 위험이 있었습니다. 그래서 초안까지는 AI가 만들되, 밖으로 나가는 모든 행동은 반드시 사람이 승인하는 안전한 형태로 직접 만들었습니다.

범용으로 만든 이유

첫 사용 예는 제가 만든 스팀 업적 툴이었지만, 도구 자체를 그 제품에 묶지 않았습니다. 제품은 이름·소개·톤·해시태그·금지어·SNS 계정을 담은 프로필로 등록하고, 소재는 변경 이력·문서·이미지 폴더·직접 입력 메모·git 태그 중 고른 소재 어댑터로 읽습니다. 제품을 하나 더 등록하는 데 코드 수정이 필요하면 설계 실패로 보고, 실제로 코드 어디에도 특정 제품 이름을 박아두지 않았습니다.

만드는 흐름

소재 어댑터가 새 소재(예: 변경 이력에 새로 추가된 절)를 찾으면 대기열에 후보로 올라갑니다. 사람이 후보를 고르면 그때만 AI를 불러 인스타그램·스레드용 캡션과 해시태그, 필요하면 이미지(기존 이미지 규격 변환 / 텍스트 카드 생성 / 이미지 없음 중 하나)를 초안으로 만듭니다. 승인 화면에서 캡션을 고치거나 "이 방향으로 다시 만들어줘" 한 줄을 더해 재생성할 수 있고, 기계 검사(금지어·글자 수·해시태그 한도)와 다른 AI 백엔드의 검수(과장·소재에 없는 기능 언급)가 경고를 붙여줍니다. 지금 단계(A단계)에서는 승인된 초안을 Buffer 같은 예약 도구에 붙여넣을 수 있게 캡션을 복사하고 이미지 폴더를 열어 줍니다. 댓글도 마찬가지로, 붙여넣으면 AI가 답글 후보 2~3개를 원댓글의 언어로 제안하고 사람이 고른 것만 내보냅니다.

안전장치

AGENTS.md 에 못 박아 둔 금지 목록이 있습니다. 자동 팔로우·좋아요·DM, 남의 게시물에 댓글, instagrapi 같은 비공식 API나 브라우저 매크로, 승인 없는 일괄 답글은 전부 금지입니다. 이 도구가 하는 자동화는 "초안을 만드는 것"까지이고, 게시·답글·숨김·삭제는 전부 사람이 버튼을 눌러야 나갑니다.

어떻게 만들었나

이전에 만든 블로그 운영 툴(blogtool)과 같은 구조로, Node.js 엔진(소재 감지·초안 생성·검사 같은 핵심 로직과 AI 호출)과 Python tkinter GUI를 줄 단위 이벤트로 통신시켰습니다. AI 호출 방식도 blogtool과 같습니다. API 키 대신 Claude Code CLI(구독 로그인)·Codex CLI(ChatGPT 로그인)를 헤드리스로 호출하고, 작업별로 백엔드를 지정해 두고 하나가 막히면 다른 쪽으로 넘어갑니다.

지금 상태

2026-09-14에 착수해 A단계 핵심 기능(소재 감지 → 초안 생성 → 검수 → 승인 → 예약 도구 연동, 댓글 답글 추천)을 다 구현했고, 이후 화면을 인스타그램·스레드 느낌으로 다시 그려 메인 화면과 초안 편집·게시 일정·카드 제작·성과 확인 4종 창까지 마쳤습니다. Node 엔진 인수 시험 277개와 GUI 검증 훅 23종이 모두 통과하지만, 아직 진행 중인 프로젝트라 제 실제 제품으로 한 바퀴 써 보는 확인이 남아 있고, Meta 공식 API로 직접 게시·댓글을 처리하는 B단계는 시작 전입니다. 소스 저장소는 비공개로 두고 있습니다.