기능 설명서

홍보 주제·키워드·스타일·하루 게시 수·보낼 곳(URL)을 묶은 단위입니다. 모든 자동화는 캠페인 단위로 돕니다. [올릴 곳]에서 계정을 고르면 그 계정에만 올립니다 (고르지 않으면 연결된 모든 계정). [웹에서 찾아 읽고 내 말로 새로 쓰기]를 켜면 내 PC 의 Claude 가 주제 안에서 아직 안 쓴 소주제를 골라 웹에서 찾아 읽고, 문장을 옮기지 않고 새 정보 글을 씁니다 (한 편에 3~6분).

쓰는 법 · 캠페인 → 새 캠페인 만들기. 보낼 곳을 넣어야 클릭·문의가 집계됩니다. 예: 「쇼핑몰 운영 노트」 블로그는 올릴 곳을 그 네이버 블로그 하나로, 웹에서 찾아 쓰기를 켭니다.

Ollama(qwen3:8b)로 제목·본문·태그·검색 키워드를 만듭니다. AI 사용료가 없습니다.

쓰는 법 · 설정 → AI 탭에서 Ollama 선택 후 [연결 테스트]. 캠페인이 활성이면 매일 자동, 컨트롤에서 [지금 글 생성]으로 즉시.

초안 품질은 손질이 필요한 경우가 많습니다. 최근 21편 중 그대로 쓸 수 있던 건 4편이었습니다.

키를 넣으면 글 생성을 유료 모델로 바꿀 수 있습니다.

쓰는 법 · 설정 → AI 탭에 키 입력.

키가 없어 실제로 돌려 보지 않았습니다.

AI 티가 나는 글은 점수를 매겨 한 번 고쳐 쓰고, 고친 뒤에도 기준(종합 60·사람다움 50·본문 300자) 미달이면 대기열에 올리지 않고 보류합니다. 텔레그램으로 알립니다.

쓰는 법 · 자동. 보류된 글은 컨트롤에서 다시 쓰기 / 그래도 게시 / 버리기. 기준은 .env QUALITY_MIN_SCORE, QUALITY_MIN_AI.

점수는 규칙 기반 추정치입니다. 플랫폼의 실제 판정과 같지 않습니다.

계정마다 글쓴이를 지정하면 같은 글을 그 사람 말투로 다시 써서 내보냅니다. 원문을 베낀 결과는 걸러 냅니다.

쓰는 법 · 내 분신에서 사람을 만들고, 플랫폼 연결에서 계정마다 선택.

시험 통과. 계정 여러 개로 실제 운영은 아직.

글 내용에 맞는 사진풍 이미지를 내 PC에서 만들어 글에 끼웁니다.

쓰는 법 · pwsh scripts/start-comfyui.ps1 로 켜 두면 글 생성 때 자동. 설정 → AI → 이미지 생성.

그래픽카드가 있어야 하고, Ollama와 메모리를 번갈아 씁니다. 장당 약 1분.

전환·화면 움직임·색감·자막·목소리·음악 크기를 스타일로 저장합니다. 자동이면 AI 가 주제에 맞는 스타일을 고르고(안 되면 키워드, 그다음 첫 번째), 캠페인·영상마다 직접 지정할 수도 있습니다.

쓰는 법 · 영상·음악 스타일에서 직접 추가·수정하거나, [AI 에게 시키기]에 말로 적고 제안을 확인한 뒤 적용. [미리보기 만들기]로 올리지 않고 확인.

AI 의 제안은 사람이 적용을 눌러야 반영됩니다. 미리보기까지 확인했고, 실제 YouTube 업로드와 함께 돌린 적은 아직 없습니다(계정 미연결).

빠르기·조·코드 진행·악기로 반주를 프로그램이 직접 합성합니다. 남의 곡을 쓰지 않아 저작권 문제가 없고 무료입니다.

쓰는 법 · 영상·음악 스타일 → 배경음악 탭 → [12초 듣기].

가사·보컬이 있는 노래는 아닙니다.

영상 스타일의 목소리를 "내 목소리"로 고르면 이 PC 의 미러 음성 서버에 등록된 목소리로 읽습니다. 기준 목소리와 토큰은 이 PC 주소로만 보냅니다.

쓰는 법 · .env 의 MIRROR_TTS_* 네 값 설정 → 미러 음성 서버를 켠 상태에서 영상 생성.

서버가 꺼져 있으면 기본 음성으로 대신하고 알려 줍니다. 요청 형식은 확인했고, 켜진 서버로 실제 영상을 만든 적은 아직 없습니다.

데스크톱 에이전트가 브라우저를 열어 제목·문단·사진·태그를 넣고 발행합니다. 사진은 문단 사이에 나눠 넣습니다.

쓰는 법 · 플랫폼 연결에서 네이버 계정 추가 → 설정 → 데스크톱 앱에서 토큰 발급 → pwsh scripts/start-agent.ps1

실제 블로그에 발행해 확인했습니다. 에이전트가 꺼져 있으면 글은 대기에 머뭅니다.

공식 API로 글을 올립니다. 하루 25편 절대 상한, 새 계정은 점진적 증가.

쓰는 법 · Meta 개발자 앱에서 토큰 발급 → 플랫폼 연결 → Threads 카드에 토큰 입력 → .env THREADS_PUBLISHING_ENABLED=true

토큰이 없어 실제 게시는 아직. 연결 화면은 토큰을 검증합니다.

준비된 영상(D:\CrownyClass-videos 등 지정 폴더)을 비공개로 올리고, 확인 뒤 공개합니다. 글→쇼츠 자동 영상도 있습니다.

쓰는 법 · Google Cloud OAuth 키를 .env에 → YouTube 화면 [계정 연결] → [준비된 영상] 탭.

OAuth 키가 없어 실제 업로드는 아직. 영상 합성(ffmpeg)은 확인됨.

REST API로 바로 올립니다. 추적 링크는 a 태그로 들어갑니다.

쓰는 법 · 플랫폼 연결에서 사이트 주소·앱 비밀번호 입력.

코드 경로는 있으나 이 PC에서 실제 사이트로 확인하지 않았습니다.

데스크톱 에이전트 경로가 코드에 있습니다.

쓰는 법 · 계정 연결 후 에이전트 실행.

실제 사이트에서 확인한 적 없음. 화면이 바뀌어 안 될 수 있습니다.

공식 Instagram API로 사진 게시물을 올립니다(무료). 하루 10편 절대 상한, 새 계정은 점진적 증가, 캡션은 LLM 변형. 브라우저 자동화는 일부러 만들지 않았습니다.

쓰는 법 · 인스타를 비즈니스/크리에이터로 전환 → Meta 개발자 앱에 Instagram 추가, instagram_content_publish 권한 토큰 → 플랫폼 연결 → Instagram 카드 → .env INSTAGRAM_PUBLISHING_ENABLED=true

이미지가 있는 글만 나갑니다. 이미지가 공개 주소(PUBLIC_BASE_URL)여야 Meta 가 받아 갑니다. 토큰이 없어 실제 게시는 아직. 캡션 속 링크는 눌리지 않아 프로필 링크로 유도합니다.

스레드·인스타 팔로워 수를 매일 적어 무엇을 올린 날 늘었는지 보여 줍니다. 스레드는 내 키워드로 방금 올라온 남의 글을 찾아 AI 가 답글 초안을 쓰고, 승인한 것만 공식 API 로 올립니다(하루 최대 5건, 25~60분 간격, 같은 사람에게는 7일에 한 번). 팔로우·좋아요 자동화는 일부러 만들지 않았습니다.

쓰는 법 · 팔로워 늘리기 화면 → 키워드 추가 → [켬] → [지금 찾기] → 초안을 고쳐 [승인]. 올라가려면 .env THREADS_PUBLISHING_ENABLED=true

남의 글 검색은 Meta 앱 심사에서 threads_keyword_search 권한을 받아야 됩니다(받기 전에는 내 글만 검색됨). 팔로워 수는 threads_manage_insights 권한이 필요합니다. 가짜 서버로 흐름은 확인했고, 실제 스레드 계정으로는 아직 올리지 않았습니다.

슈퍼관리자가 모아 둔 재료(편집 본뜰 영상·노래, 목소리, 이미지 스타일)를 골라 20초 샘플 영상을 만들어 보고, 마음에 들면 조합으로 저장해 SNS 마다 그 조합으로 만들게 정해 둡니다. 편집 본뜰 영상은 컷 길이와 색만, 노래는 빠르기와 조만 따 옵니다. 만화·수채화 같은 이미지 스타일을 고르면 장면 그림을 그 그림체로 새로 그립니다.

쓰는 법 · 영상 조합 화면 → 재료를 고르고 주제를 적어 [샘플 영상 만들기] → 이름을 붙여 [조합 저장] → [SNS별 조합]에서 YouTube·TikTok·Instagram 릴스에 지정

YouTube 는 영상을 만들어 올릴 때 저절로 적용되고, TikTok·Instagram 릴스는 여기서 영상 파일을 만들어 둔 뒤 각 화면에서 올립니다. 장면 그림은 이 PC 의 그림 생성기(무료)가 켜져 있을 때만 새로 그립니다. 녹음을 따라 읽는 목소리는 목소리 서버가 필요합니다. 스레드·블로그는 영상을 올리지 않아 해당이 없습니다.

Reddit·네이버 카페·지식iN 같은 커뮤니티에서 도움이 되는 답글과 글로 계정의 믿음을 쌓도록 돕습니다. 답글 달 글을 찾고(Reddit 은 공개된 새 글을 읽어 옵니다) AI 가 초안을 쓰며, 올린 수에 따라 1~3단계로 나눠 지금 해도 되는 일을 알려 줍니다. 추천 커뮤니티 28곳의 홍보 규칙도 함께 보여 주고, [추천 N곳 모두 추가]로 한 번에 넣을 수 있습니다. 글은 곳마다 따로 씁니다 (같은 글을 여러 곳에 올리면 도배로 지워집니다). [주제 하나로 여러 곳 초안]에 주제를 적으면 고른 곳(한 번에 8곳까지)마다 그곳에 맞게 다르게 쓴 초안을 만듭니다. 네이버 지식iN 은 검색어로 답이 적은 새 질문을 찾아(검색어의 낱말이 모두 들어간 질문만) 내 PC 의 Claude 가 답 초안을 씁니다. [3시간마다 스스로 찾아 초안 써 두기]를 켜면 알아서 쌓아 둡니다. 지식iN 은 카드에서 [올릴 때 로그인할 네이버 계정]을 고르면 초안마다 [에이전트가 올리기]가 생기고, 데스크톱 에이전트가 그 계정으로 답을 올립니다. [바로 올리기]로 바꾸면 찾은 질문의 답을 승인 없이 맡깁니다.

쓰는 법 · 커뮤니티 활동 → [활동할 곳 추가]에 내가 아는 것을 적기 → [답글 달 글 찾기] 또는 [글 붙여 넣어 초안 받기] → 초안을 읽고 고친 뒤 [복사하고 원글 열기]로 그 사이트에 직접 올리기 → [올렸어요]

지식iN 말고는 올리는 것을 사람이 직접 합니다. 커뮤니티 대부분이 자동 글쓰기를 금지하기 때문입니다. 지식iN 에이전트는 네이버 계정당 하루 5건(새 계정은 더 적게), 답 사이 40~90분, 계정에 정한 시간대에만 올리고, 캡차·답변 제한이 뜨면 바로 올리기를 스스로 끄고 텔레그램으로 알립니다. 올리지 못한 답은 오류 문구와 함께 기다리는 초안으로 돌아옵니다. 내 것(제품) 얘기는 3단계(올린 글 30건·21일)부터, 만든 사람임을 밝히고, 올린 글 열에 하나까지만 초안에 넣습니다. 지식iN 은 처음부터, 질문과 맞을 때만, 답 열에 셋까지 넣습니다. 비밀번호는 넣지 않습니다.

공식 Instagram API로 준비된 영상이나 앱이 만든 영상을 릴스로 올립니다(무료). 하루 5편 절대 상한, 새로 연결한 계정은 1편부터 늘어납니다. 예약 시각을 주면 그때 올립니다. 공개 도메인이 없어도 이 컴퓨터에서 영상을 직접 보냅니다.

쓰는 법 · 플랫폼 연결에서 인스타그램 연결(사진 게시와 같은 토큰) → Instagram 릴스 화면 [준비된 영상]에서 [릴스로 올리기] → .env INSTAGRAM_PUBLISHING_ENABLED=true

인스타가 영상을 처리하는 데 보통 10초~2분 걸리고, 끝나면 저절로 게시됩니다. 글 속 주소는 눌리지 않아 프로필 링크로 안내해야 합니다. 가짜 서버로 흐름은 확인했고, 실제 인스타 계정으로는 아직 올리지 않았습니다.

공식 TikTok API로 준비된 영상이나 앱이 만든 영상을 올립니다(무료). 하루 5편 절대 상한, 새 계정은 점진적 증가. 예약 시각을 주면 그때 올립니다. 브라우저 자동화는 일부러 만들지 않았습니다.

쓰는 법 · TikTok for Developers 에서 앱 등록 → .env TIKTOK_CLIENT_KEY/SECRET → TikTok 화면 [TikTok 연결] → [준비된 영상] 에서 올리기 → .env TIKTOK_PUBLISHING_ENABLED=true

로그인 콜백은 https 공개 도메인이 필요합니다(없으면 플랫폼 연결에서 토큰 직접 입력). 앱 심사 전에는 "나만 보기"로만 올라가고, 심사 뒤 공개 게시가 됩니다. 가짜 서버로 흐름은 확인했고, 실제 틱톡 계정으로는 아직 올리지 않았습니다.

계정 나이에 따라 1주차 20% → 90일 100%로 게시량을 늘립니다. 상한을 넘기는 버튼은 없습니다.

쓰는 법 · 자동.

내 워드프레스·스레드 글에 남이 단 댓글을 30분마다 읽어 와서 글쓴이 말투로 답 초안을 씁니다. 답은 그 글을 올린 계정 이름으로 나갑니다. 광고·인사만 있는 댓글은 건너뜁니다. 내 다른 계정이 단 댓글은 읽지 않습니다.

쓰는 법 · 댓글 답하기 → 초안을 읽고 [올리기 승인] (3~25분 뒤에 올라갑니다). 계정마다 [자동 답글]을 켜면 승인 없이 올립니다. [지금 읽어 오기]로 바로 확인할 수 있습니다.

계정당 하루 20건까지. 스레드는 답글 읽기 권한(threads_manage_replies)과 .env THREADS_PUBLISHING_ENABLED=true 가 필요합니다. 네이버 블로그 댓글은 아직 읽어 오지 못합니다.

계정마다 하루 최대 글 수와 올리는 시간대를 정합니다. 시간대 안 아무 시각에 올리고, 그날 최대를 채우면 다음 날로 넘깁니다. 같은 플랫폼에 계정이 여럿이면 같은 글감은 계정마다 하루씩 다른 날 나갑니다. 스레드 「먼저 답글 달기」는 내 다른 스레드 계정의 글에는 답하지 않습니다.

쓰는 법 · 플랫폼 연결 → 계정 칸의 [하루 최대]·[시작]·[끝]을 고르면 바로 저장됩니다. 비우면 자동(플랫폼 한도 · 하루 종일).

플랫폼 하루 상한(네이버 10건 등)과 새 계정 점진 증가는 이 값과 상관없이 그대로 걸립니다.

세션이 풀리면 그 계정만 멈추고 텔레그램으로 알립니다. 비밀번호 재시도는 안 합니다.

쓰는 법 · 플랫폼 연결에서 안내대로 한 번 직접 로그인 후 [재개].

캠페인에 보낼 곳이 있으면 게시마다 /go/코드 짧은 주소가 본문 끝에 붙습니다. 누르면 클릭을 세고 업체 URL로 보냅니다(UTM 자동).

쓰는 법 · 캠페인에 보낼 곳(URL)과 링크 앞 문구 입력.

봇 클릭은 따로 표시해 집계에서 뺍니다. IP는 해시만 저장합니다. 남이 누르려면 PUBLIC_BASE_URL에 공개 도메인이 필요합니다.

세 길로 들어옵니다: 업체 사이트의 픽셀, 업체 서버의 호출, 사람이 수기로 입력.

쓰는 법 · 분석 → 게시 성과 탭 아래 코드를 업체 완료 페이지에 붙이거나, 글 옆 [+ 문의/구매].

게시물별 클릭·전환·조회수와 채널별·스타일별·시간대별 "글당 클릭·전환" 비교.

쓰는 법 · 분석 → 게시 성과.

조회수는 스레드·유튜브만 자동 수집됩니다. 네이버는 공개 API가 없어 아직 비어 있습니다.

성과가 좋은 채널·시간대·스타일에 자동으로 더 배정하는 기능.

쓰는 법 · -

다음 단계. 리포트 데이터가 2주 이상 쌓인 뒤 만듭니다.

아이콘 하나로 데이터베이스·서버·화면·글 AI·이미지 AI 를 순서대로 켜고, 꺼지면 되살립니다. 창을 닫아도 시계 옆 아이콘에서 계속 돌고, 윈도우를 켜면 함께 켜집니다. 사이트와 관제를 앱 창으로 엽니다. 내 목소리 서버는 영상을 만들 때만 켜고 다 쓰면 5분 뒤 끕니다.

쓰는 법 · 바탕화면의 secretAD 아이콘 (없으면 pwsh scripts/start-secretad.ps1 -MakeShortcut 으로 만들기). 상태 창에서 이미지 AI·에이전트를 켜고 끄고, 문제가 난 것은 [다시 켜기].

데스크톱 에이전트는 기본으로 꺼 둡니다 — 켜는 순간 대기 중인 글이 실제로 올라가서, 상태 창에서 한 번 확인을 받고 켭니다. 데이터베이스는 앱 안에 들어 있어 Docker 가 필요 없고(무설치 PostgreSQL), 하루 한 번 자동으로 백업합니다(최근 14개 보관). 이 PC 는 저장소 폴더에서 실행합니다(고친 것이 바로 반영됨).

설치 파일 하나로 서버·화면·에이전트·데이터베이스가 들어갑니다. 처음 켜면 그 PC 에서 비밀값과 데이터베이스를 스스로 만들고, 새 판으로 바뀌면 늘어난 데이터 구조만 적용합니다. 배포 주소(UPDATE_URL)를 정해 두면 새 판을 스스로 받아 두고 [지금 설치]를 누를 때 설치합니다.

쓰는 법 · node scripts/build-app.mjs → release/secretAD-Setup-<버전>.exe 와 latest.json. 새 판은 apps/desktop/launcher/package.json 의 version 을 올리고 다시 빌드.

빈 자료 폴더로 새 PC 를 흉내 내 설치·첫 실행·0.1.0→0.1.1 업데이트까지 확인했고, 실제 다른 PC 에는 아직 깔아 보지 않았습니다. 업데이트 설치는 10분 안팎 걸리고 그동안 서버가 꺼집니다. 글 AI(Ollama)·이미지 AI(ComfyUI)·ffmpeg·edge-tts 는 설치 파일에 들어 있지 않아 따로 깔아야 합니다(없으면 상태 창이 알려 줌). 코드 서명이 없어 윈도우가 "알 수 없는 게시자" 경고를 띄웁니다. 배포 주소는 아직 정하지 않아 자동 업데이트는 꺼져 있습니다.

전체가 지금 어떻게 도는지 한 장으로 봅니다. 위쪽 흐름도는 일정→만들기→품질 검사→게시 대기→채널→성과 순서이고, 지나갈 일이 있는 구간만 점이 그 방향으로 움직입니다. 막힌 구간은 빨간 선과 이유가 보입니다. 아래 나무에서 엔진·예약 주기·캠페인·채널·성과를 펼쳐 봅니다.

쓰는 법 · 관제 메뉴를 누르면 메뉴 없는 전체 화면 창이 따로 뜹니다. 맨 위에 쓰는 AI 들의 사용량(그래픽카드 메모리, 대기, 오늘 만든 개수)이 있고, 단계마다 담당 AI 가 칩으로 붙습니다. [동시에 진행 중인 일]은 업무 종류별로 지금 진행·대기·막힘을 한 건씩 보여 줍니다. 30초마다 스스로 새로 읽습니다.

보여 주기만 하는 화면입니다. 실행·멈춤은 컨트롤에서 합니다. [예시: 가장 바쁠 때 보기]는 가짜 자료이고, 그 안의 쇼핑몰 상품 쇼츠·앱 제작 루틴은 아직 없는 기능입니다. 만드는 중인 영상은 아직 잡히지 않고 올리는 단계부터 보입니다.

연결 계정·홍보 이력·규칙·즉시 실행을 한 화면에.

쓰는 법 · 컨트롤 메뉴.

재로그인 필요 등 사람이 해야 할 일을 보냅니다.

쓰는 법 · 설정 파일 ~/.claude/team-config/telegram.env

다른 프로그램이 /api/v1 로 글·분신을 읽어 갈 수 있습니다.

쓰는 법 · 설정 → 외부 API 키.

Stripe 결제 모듈이 있습니다.

쓰는 법 · -

키 없음. 검증한 적 없음.