
moai-threads-poster
Threads·Instagram(Meta) 자율 발행 전담 AI 코워커 — 직접 Graph API 연결 MCP(월정액 없음)로 텍스트·이미지·비디오 2단계 발행. 세션 안에서 직접 발행. 예약·정기 발행은 사용 중인 앱의 지원 여부를 확인합니다. Facebook 개인 계정은 API 미지원(정책)이라 복붙만 지원합니다. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 1인 브랜드·콘텐츠 크리에이터·Threads/Instagram 정기 운영자.
- version
- 2.0.7
- GitHub stars
- 316
Install
/plugin install moai-threads-poster@moai-coworkRun it inside Claude Code after adding the marketplace with /plugin marketplace add modu-ai/moai-cowork.
Contents
Discovered from sourceSkills 5
Instagram 댓글 관리 (instagram-comments)
개요
발행된 Instagram 미디어의 댓글을 조회하고, 답글을 달고, 댓글을 숨긴다. 이 스킬은 Instagram Graph API 의 댓글 엔드포인트(instagram_manage_comments 권한 게이트) 를 통해 instagram_comments_list / instagram_comments_reply / instagram_comments_hide 도구를 호출한다.
권한: 세 가지 도구 모두 Meta 앱에
instagram_manage_comments권한이 부여되어 있어야 한다. 권한이 없으면 API 가 거부한다.
트리거 키워드
댓글, comment, 답글, reply, 숨김, hide, 모더레이션, 스팸, 정리
워크플로우
1단계: 댓글 목록 조회
특정 미디어(media_id) 의 댓글을 나열한다:
instagram_comments_list(media_id="<미디어 ID>")
# → {"data": [{"id", "text", "username", "timestamp", "hidden": false}, ...]}
media_id는instagram_publish_image등 발행 도구가 반환한 값이나 사용자가 확인해 준 게시물 ID를 사용한다.instagram_insights는 게시물 목록을 조회하지 않는다.
2단계: 답글 초안 작성
특정 댓글에 달 답글을 먼저 초안으로만 쓴다. 이 단계에서는 아직 아무것도 발행하지 않는다.
답글 본문도 저장된 문체 프로필을 반영해 작성한다 (있으면). 공격적/스팸 댓글에는 답글 대신 숨김을 권장.
3단계: 답글 최종 점검 (발행 전 필수)
답글은 브랜드 계정 이름으로 공개된다. 사용자에게 보여주기 전에 대상 댓글과 답글을 대조해 사실·수치·고객 개인정보·미공개 정보·말투·맞춤법을 직접 확인한다. 근거 또는 공개 가능 여부를 확인할 수 없으면 답글을 보류하고 사유를 알린다.
- [HARD] 점검을 마친 답글 그대로 승인받는다. 승인 뒤 수정하면 다시 점검하고 재승인받는다.
moai-coworker:ai-slop-reviewer,moai-writer:korean-spell-check,moai-writer:korean-humanize가 현재 세션에 있으면 보조 검수에 사용할 수 있다. 별도 플러그인 설치를 답글 조건으로 삼지 않는다. 외부 맞춤법 서비스를 쓰기 전에는 고객 개인정보와 미공개 정보의 전송 여부를 확인한다.- 보조 검수에서
hold_and_report가 나오거나 의미 보존을 확인할 수 없으면 답글을 발행하지 않고 2단계로 돌아간다. 보조 검수 뒤에도 최종 답글을 직접 다시 읽는다.
4단계: 승인 게이트 (답글·숨김 공통)
[HARD] 답글 발행과 댓글 숨김은 승인 없이 실행하지 않는다. 둘 다 고객이 보는 자리에서 일어나는 일이다.
- [HARD] 승인은 §승인 요청 계약의 경로로 받는다. 산문으로 "올릴까요?"라고 묻지 않는다. 물을 수 없다는 이유로 게이트를 건너뛰지 않는다 — 경로 선택은 §승인 요청 계약을 따른다.
- [HARD] 요약하지 말고 실제로 넘어가는 인자 전부를 그대로 보여준다:
| 보여줄 것 | 답글 | 숨김 |
|---|---|---|
발행 계정 (IG_USER_ID) | ✓ | ✓ |
대상 게시물 media_id | ✓ | ✓ |
대상 댓글 comment_id | ✓ | ✓ |
| 대상 댓글 원문 전문과 작성자 | ✓ | ✓ |
| 점검을 마친 답글 전문과 글자 수 | ✓ | — |
| 최종 점검에서 무엇이 바뀌었는지 한 줄 | ✓ | — |
| 숨김 사유 (스팸 / 비난 / 기타) | — | ✓ |
승인 선택지는 이렇게 구성한다:
| 선택지 | 뜻 |
|---|---|
| 이대로 실행 (권장) | 보여준 인자 그대로 답글 발행 또는 숨김 |
| 고쳐 쓰기 / 대상 바꾸기 | 2단계로 복귀 → 최종 점검 → 재승인 |
| 취소 | 아무것도 실행하지 않고 종료 |
- [HARD] 여러 댓글을 한꺼번에 처리할 때도 건별로 보여준다. "스팸 5건 숨김" 같은 묶음 승인은 금지한다 — 5건 중 하나가 정당한 고객 불만이어도 사용자가 알 수 없다. 목록으로 한 번에 제시하되, 각 건의 댓글 원문·작성자·사유가 모두 보여야 한다.
숨김은 되돌릴 수 있다(아래 5단계). 그래도 승인을 받는 이유는, 숨김이 누군가를 침묵시키는 결정이기 때문이다. 되돌릴 수 있다는 것과 해도 된다는 것은 다르다. 특히 스팸으로 잘못 분류된 정당한 불만을 숨기면, 고객은 자기 댓글이 사라진 것을 보고 브랜드를 떠난다.
5단계: 실행
승인된 것만 실행한다.
# 답글
instagram_comments_reply(comment_id="<댓글 ID>", text="<점검을 마치고 승인된 답글>")
# → {"id": "<새 답글 ID>"}
# 숨김 (삭제가 아님 — 작성자와 페이지 관리자만 안 보이거나, 정책에 따라 전체 숨김)
instagram_comments_hide(comment_id="<댓글 ID>")
# → {"hidden": true}
숨김은 가역적이다 — Meta 정책에 따라 다시 보이게 할 수 있다. 답글은 가역적이지 않다.
- [HARD] 실패해도 자동 재시도하지 않는다. 답글 발행이 애매하게 실패하면(타임아웃·응답 없음) 재시도하지 않고 멈춘다. 성공 신호가 없다는 것은 답글이 달리지 않았다는 증거가 아니며, 확인 없는 재시도는 같은 답글을 두 번 단다.
- [HARD] 이 서버에는 답글이 달렸는지 확인할 수단이 없다.
instagram_comments_list(media_id)는 그 미디어의 댓글 목록만 가져온다 — 특정 댓글에 달린 답글(replies) 은 조회하지 않는다(instagram_api.pycomments_list). 게다가 그 엔드포인트 경로 자체가 아직 검증 대상(@MX:TODO)이다. 이 도구로 "답글 없음"을 판정하면 성공한 답글을 못 본 채 두 번 달게 된다. - 따라서 애매한 실패 뒤에는 사용자에게 Instagram 앱·웹에서 해당 댓글을 직접 열어 확인해 달라고 요청하고, 달리지 않았다는 사용자의 확인을 받은 뒤에만 다시 실행한다. 스킬이 혼자 판정하지 않는다.
- 나중에 replies 를 조회하는 도구가 실제로 노출되면 그때 이 조항을 바꾼다. 도구가 있을 것이라 가정하고 미리 써 두지 않는다.
승인 요청 계약 (런타임 중립)
[HARD] 이 스킬의 게이트는 특정 도구 이름에 묶이지 않는다. AskUserQuestion은 Claude 런타임의 수단일 뿐이고, Codex를 비롯한 다른 런타임에는 그 도구가 없다. 도구 이름으로 계약을 쓰면 그 도구가 없는 런타임에서 게이트가 영구 blocker가 되어, 승인이 필요한 모든 작업이 그냥 멈춘다. 그건 안전이 아니라 고장이다.
승인은 아래 순서로 구한다. 위에서부터 실제로 가능한 첫 번째를 쓴다.
승인의 정의는 수단이 아니라 결과다: 승인서를 사용자에게 그대로 보여주고, 그에 대한 명시적 응답을 받는 것. 아래는 그 결과를 만드는 경로들이며, 위에서부터 가능한 첫 번째를 쓴다.
| 순위 | 경로 | 조건 |
|---|---|---|
| 1 | 런타임의 구조화 질문 도구 (AskUserQuestion 등) | 그 도구가 현재 세션에 노출돼 있을 때 |
| 2 | 일반 대화로 승인서를 제시하고 다음 턴에서 응답을 받는다 | 사용자와 직접 대화 중일 때. 도구가 없어도 이 경로는 언제나 열려 있다 |
| 3 | 구조화 blocker 반환 → 상위 오케스트레이터가 물어봄 | 서브에이전트로 실행 중일 때 |
[HARD] 런타임의 도구 실행 권한 프롬프트는 승인이 아니다. 그 프롬프트는 "이 도구를 호출해도 되는가"를 물을 뿐, 게이트가 보여주기로 한 인자·견적·동의 문항을 표시하지 않는다. 승인서 전체와 선택지를 실제로 표시하는 경우에만 2번 경로로 인정한다.
[HARD] 2번 경로가 있으므로 "물을 수단이 없다"는 상황은 사실상 없다. 대화가 가능한 곳에서는 언제나 승인서를 글로 제시할 수 있다. fail-closed는 대화도 blocker 반환도 불가능한 완전 무인 실행에만 해당한다 — 그 경우에만 실행하지 않고 멈춘다.
[HARD] 3번을 쓸 때 blocker는 그 자체로 승인 요청서여야 한다. 상위가 무엇을 물어야 할지 모르면 되물을 수 없고, 그러면 교착된다. 다음을 모두 담는다:
- 승인받을 행위 한 줄 (무엇이 되돌릴 수 없는지 / 얼마가 나가는지)
- 게이트가 요구하는 인자 전부 (요약하지 않은 값)
- 선택지 목록 — 상위가 그대로 사용자에게 제시할 수 있는 형태
- 재개 방법 — 어떤 답을 받으면 무엇을 이어서 실행하는지
[HARD] 세 경로가 모두 불가능한 무인 실행에서는 실행하지 않는다(fail-closed). 물을 수단이 없다는 것은 승인을 받았다는 뜻이 아니다. 이때는 "승인 수단이 없어 진행하지 못했다"고 기록하고 멈춘다 — 조용히 진행하지 않는다. 반대로 대화가 가능한데 도구가 없다는 이유로 멈추는 것도 잘못이다. 2번 경로를 쓴다.
이 승인 계약은 Claude와 ChatGPT 데스크톱 앱 모두에 적용한다. 한 앱에서만 동작하는 게이트는 미완성으로 본다.
주의사항
| 상황 | 대응 |
|---|---|
instagram_manage_comments 권한 없음 | Meta 앱 검수(App Review) 로 권한 추가 필요 |
setup_required 에러 | 앱 설정 또는 사용자 자격증명 파일에서 IG_ACCESS_TOKEN / IG_USER_ID 확인 |
| Personal 계정 | Graph API 미지원 — Professional 계정 필요 |
| 엔드포인트 미검증 | comments 엔드포인트 경로는 run-phase 검증 대상(@MX:TODO) — 최초 사용 시 공식 문서로 경로 재확인 권장 |
출처·공개 가능 여부 미확인 또는 보조 검수 hold_and_report | 답글을 발행하지 않음. 사유를 보여주고 2단계로 복귀 |
| 답글에 미공개 정보·고객 개인정보가 섞임 | 공개 범위를 확인할 때까지 답글 보류. 외부 맞춤법 서비스에 전송하지 않음 |
| 사용자가 승인 게이트에서 취소 | 아무것도 실행하지 않고 종료. 부분 실행 금지 |
출력 형식
## 댓글 관리 결과
**미디어**: <media_id>
**댓글 수**: N
| 댓글 ID | 작성자 | 본문 | 상태 |
|---|---|---|---|
| ... | ... | ... | 표시/숨김 |
**조치**: (답글/숨김 내역)
발행 전 설정 (최초 1회)
Threads 발행 자격증명과 별개로 Instagram용 IG_ACCESS_TOKEN / IG_USER_ID가 필요하며, Meta 앱에 instagram_manage_comments 권한도 부여되어야 한다. 발급 절차는 mcp-servers/moai-mcp-threads-poster/CONNECTORS.md의 Instagram 섹션을 따른다.
관련 스킬
| 스킬 | 사용 시점 |
|---|---|
instagram-post | 포스트 발행 (댓글 관리 전에 발행이 선행) |
이 스킬을 사용하지 말아야 할 때
- 포스트 발행:
instagram-post스킬 - 인사이트 조회:
instagram_insights도구 직접 호출 - Threads 댓글: Threads API 는 본 플러그인 범위 밖
Instagram 포스트 작성·직접 발행 (instagram-post)
개요
주제를 받아 Instagram 초안(캡션 + 미디어)을 작성하고, 발행 전에 사실·개인정보·문장·미디어를 점검한 뒤, 최종본을 사용자가 승인하면 즉시 Graph API 로 발행합니다. 이 스킬은 instagram_publish_image / instagram_publish_video / instagram_publish_reel 도구를 호출합니다.
발행은 공개된 사업 계정에 되돌릴 수 없이 나가는 일입니다. 맞춤법이 틀렸거나 AI 티가 나는 캡션이 한 번 올라가면 그대로 남습니다 — 그래서 감사가 선택이 아니라 필수 단계입니다.
Instagram Professional(Business 또는 Creator) 계정만 지원 됩니다. Personal 계정은 Graph API 로 발행할 수 없습니다.
본 스킬은 즉시 발행만 합니다. 예약·정기 발행은 사용 중인 앱에서 해당 기능이 실제로 제공되는지 확인합니다.
트리거 키워드
Instagram, 인스타, 인스타그램, 릴, REEL, 캡션, 이미지 발행, 비디오 발행
워크플로우
0단계: 문체 적용 (있으면)
초안 작성 전 에 threads_style_load 로 저장된 문체 프로필을 확인한다 (Threads 스킬이 저장한 프로필을 Instagram 캡션에도 재사용). 프로필이 있으면 그 차원(말투·문장 길이·오프닝·이모지·시그니처) 을 캡션에 반영한다.
1단계: 미디어 타입 결정 + 캡션 작성
| 미디어 | 도구 | 비고 |
|---|---|---|
| 이미지 | instagram_publish_image | JPEG-only (PNG 거부됨 — Threads 와 상이) |
| 비디오 | instagram_publish_video | 공개 URL, container 폴링 후 발행 |
| 릴 | instagram_publish_reel | share_to_feed=True (기본) 면 피드에도 공유 |
- 캡션: Instagram 캡션은 2200자 권장(해시태그 포함). 핵심 메시지는 첫 2줄에.
- 해시태그: 5-15개 권장. 본문과 분리해 마지막에 배치하거나 첫 댓글로.
- 이미지 URL: 반드시 공개 접근 가능 해야 한다 (Meta 가 서버에서 cURL 로 가져간다). 비공개/서명 URL 은 거부된다.
2단계: 발행 전 최종 점검 (필수)
캡션을 사용자에게 보여주기 전에 주장·수치·고유명사와 미디어를 원자료와 대조하고, 미공개 정보·개인정보가 없는지 확인한다. 맞춤법·띄어쓰기·어색한 반복을 직접 읽어 고친 뒤 원래 뜻을 다시 대조한다. 출처나 공개 가능 여부를 확인하지 못하면 발행을 보류한다.
- [HARD] 점검이 승인보다 앞이다. 사용자는 발행될 바로 그 캡션과 미디어를 보고 승인해야 한다.
- [HARD] 캡션 길이는 최종본 기준으로 다시 센다. 해시태그를 포함해 한도를 확인한다.
moai-coworker:ai-slop-reviewer,moai-writer:korean-spell-check,moai-writer:korean-humanize가 현재 세션에 있으면 보조 검수에 사용할 수 있다. 별도 플러그인 설치를 발행 조건으로 삼지 않는다. 외부 맞춤법 서비스를 쓰기 전에 미공개 정보나 개인정보가 전송되는지 확인한다.- 보조 검수에서
hold_and_report가 나오거나 의미 보존을 확인할 수 없으면 발행하지 않고 1단계로 돌아간다. 보조 검수 뒤에도 최종본을 직접 다시 읽는다.
3단계: 최종본 확인 (승인 게이트)
점검을 마친 최종본을 사용자에게 보여주고 승인을 받는다. 승인 없이는 발행하지 않는다 ("자동 아닌 자율").
-
[HARD] 승인은 사용자에게 승인서를 그대로 보여주고 명시적 응답을 받는다. 대화체로 "괜찮으세요?"라고 묻지 않는다 — 발행은 되돌릴 수 없으므로 사용자가 명시적으로 고르게 한다.
-
[HARD] 실제로 넘어가는 인자를 전부 보여준다. 요약이 아니라 다음을 그대로 제시한다:
보여줄 것 왜 점검을 마친 캡션 전문 + 최종 글자 수 발행될 문장 그 자체 미디어 타입 (IMAGE / VIDEO / REEL) 어느 도구가 호출되는지 결정 image_url/video_url원문 그대로어떤 이미지·영상이 올라가는지 릴이면 share_to_feed값True면 피드에도 공유된다 — 요약에 묻히면 사용자가 모른 채 승인한다발행 계정 ( instagram_get_profile의 username)여러 계정을 쓰는 경우 오발행 방지 해시태그 목록 최종 점검 결과 한 줄 무엇이 바뀌었는지 -
사용자가 수정을 요청하면 1단계로 돌아가 다듬고, 최종 점검을 다시 한 뒤 재승인을 받는다.
-
사용자가 승인하면 4단계로 간다.
선택지는 「이대로 발행」 / 「수정 요청」 / 「발행 취소」로 구성한다.
4단계: 즉시 발행 (승인 시)
승인된 초안을 미디어 타입에 맞춰 즉시 발행한다:
instagram_publish_image(text="<캡션>", image_url="https://example.com/photo.jpg")
# → {media_id, container_id, permalink_hint, platform: "instagram"}
instagram_publish_reel(text="<캡션>", video_url="https://example.com/reel.mp4", share_to_feed=True)
# REELS/VIDEO 는 container 가 FINISHED 될 때까지 폴링 후 발행된다.
[HARD] 애매하게 실패하면 재시도하지 않는다. Instagram 발행은 컨테이너 생성 → 발행 2단계이고, 릴·비디오는 컨테이너가 FINISHED 될 때까지 폴링한다. 타임아웃·응답 없음으로 끝나면 1단계만 성공했을 수 있다 — 그대로 다시 호출하면 같은 글이 두 번 올라가거나 중복 컨테이너가 남는다.
[HARD] 이 서버에는 발행 여부를 되물을 도구가 없다. instagram_get_profile은 계정 정보만 반환하고, instagram_insights·instagram_comments_list는 조회하려면 이미 media_id가 있어야 하는데 애매한 실패에서는 그 값이 없다. 따라서 사용자에게 Instagram 앱에서 직접 확인해 달라고 요청하고, 올라가지 않았다는 확인을 받은 뒤에만 다시 발행한다. 스킬이 혼자 판단하지 않는다.
발행은 세션 안에서 즉시 일어난다. 백그라운드 자동 발행은 없다. 예약이 필요하면 사용 중인 앱의 지원 여부를 확인한다.
주의사항
| 상황 | 대응 |
|---|---|
| 이미지가 PNG | JPEG 로 변환 후 재시도 (.png URL 은 빠른 실패) |
| 미디어 URL 이 비공개 | 공개 URL 사용 (Meta 가 서버에서 fetch) |
setup_required 에러 | 앱 설정 또는 사용자 홈의 .moai/mcp/threads.json에 IG_ACCESS_TOKEN, IG_USER_ID 설정 (CONNECTORS.md 참조) |
| Personal 계정 오류 | Instagram Professional(Business/Creator) 계정만 지원 — 계정 전환 필요 |
| 예약·정기 발행 요청 시 | 앱에서 지원 여부를 확인하고, 본 스킬은 즉시 발행만 한다고 안내 |
출처·공개 가능 여부 미확인 또는 보조 검수 hold_and_report | 발행하지 않음. 사유를 보여주고 1단계로 복귀 |
| 캡션에 미공개 정보가 섞임 | 공개 여부를 확인할 때까지 발행 보류. 외부 맞춤법 서비스에 전송하지 않음 |
| 발행 도구가 애매하게 실패 | 재시도 금지. 사용자에게 Instagram 앱 확인을 요청한 뒤 판단 |
| "점검 건너뛰고 바로 올려줘" 요청 | 점검을 마친 최종본을 승인받은 뒤 발행 |
출력 형식
## Instagram 포스트 (발행 완료)
<캡션>
**미디어**: IMAGE / VIDEO / REEL — <URL>
**해시태그**: # ...
**결과**:
- media_id: ... · permalink_hint: 서버가 반환한 참고값 (실제 게시물 링크는 Instagram에서 확인)
발행 전 설정 (최초 1회)
Instagram 자격증명(Threads 와 별개) 이 필요하다:
토큰은 .mcp.json에 직접 쓰지 않는다. 이 파일은 저장소에 커밋되므로 값을 그대로 넣으면
토큰이 git 이력·diff·배포 패키지에 남는다. 파일에는 참조만 둔다.
{
"env": {
"IG_ACCESS_TOKEN": "${IG_ACCESS_TOKEN}",
"IG_USER_ID": "${IG_USER_ID}"
}
}
실제 값은 앱 설정 또는 사용자 홈의 .moai/mcp/threads.json에 넣는다. 서버의 자격증명 읽기 순서는 CONNECTORS.md를 따른다. 아래 환경변수 예시는 개발자가 셸에서 직접 실행할 때만 사용한다.
macOS / Linux:
export IG_ACCESS_TOKEN="<Facebook Page 장기 액세스 토큰>"
export IG_USER_ID="<Instagram Professional 계정 ID>"
Windows (PowerShell):
$env:IG_ACCESS_TOKEN = "<Facebook Page 장기 액세스 토큰>"
$env:IG_USER_ID = "<Instagram Professional 계정 ID>"
발급 절차(Meta App → Facebook Login → 장기 Page 토큰 → IG_USER_ID 해석) 는 mcp-servers/moai-mcp-threads-poster/CONNECTORS.md 의 Instagram 섹션 참조.
동작 확인: instagram_get_profile 도구 호출 → 프로필 정보 반환되면 연동 성공.
관련 스킬
| 스킬 | 사용 시점 |
|---|---|
instagram-comments | 발행 후 댓글 관리 (목록/답글/숨김) |
threads-post-draft | Threads 용 초안 작성·발행 |
threads-style-learn | 문체 프로필 분석·저장 (본 스킬이 초안에 적용) |
moai-coworker:ai-slop-reviewer | 노출된 경우 AI 문구 추가 검토 |
moai-writer:korean-spell-check | 노출되고 외부 전송이 허용된 경우 맞춤법 제안 |
moai-writer:korean-humanize | 노출된 경우 장르: 카피로 추가 윤문·의미 검수 |
이 스킬을 사용하지 말아야 할 때
- 댓글 관리:
instagram-comments스킬 사용 - Threads 발행:
threads-*스킬 / 도구 사용 - 예약·정기 발행: 사용 중인 앱의 지원 여부 확인 (본 플러그인은 즉시 발행만)
멀티 채널 포맷 (threads-multichannel)
개요
하나의 원본 텍스트를 세 채널의 제약에 맞춰 각각 포맷합니다. 발행은 하지 않습니다 — 채널별로 출력을 만들어 사용자에게 전달합니다.
| 채널 | 제약 | 출력 | 발행 경로 |
|---|---|---|---|
| Threads | 500자 | 다듬은 텍스트 + 글자 수·잘림 여부 | 직접 발행 (threads_publish_text 등) |
| 글자 수 제한 없음 (개인 계정) | 대화체 텍스트 | 복붙 only (API 발행 불가) | |
| X (free) | 트윗당 280자 | 1/ ·2/ 번호 트윗 리스트 | 복붙 only |
| X (premium) | 25,000자 | 단일 문자열 | 복붙 only |
왜 Facebook·X 는 복붙인가: Facebook 개인 계정은 API 발행이 정책상 불가합니다. X 도 무료 tier 에선 트윗 체인을 직접 올리는 게 보통이고, 이 플러그인은 Threads API 만 직접 다룹니다. 그래서 Facebook·X 출력은 사용자가 직접 복붙 합니다 — 본 스킬은 텍스트를 준비만 해 드립니다.
트리거 키워드
멀티 채널, 페이스북, 엑스, 트위터, X, Facebook, 복붙, 스레드 분할, 280자, premium, 프리미엄, 무료, 채널별, 포맷
워크플로우
1단계: 원본 텍스트 + X tier 확인
원본 텍스트(초안) 와 사용자의 X tier 를 확인합니다:
- 원본:
threads-post-draft로 작성한 초안, 또는 사용자가 직접 준 텍스트. - X tier: 무료면
"free"(기본), 유료(X Premium) 면"premium". 모르면 기본"free"로.
tier 확인이 애매하면 사용자에게 "X 가 무료입니까, 프리미엄입니까?" 만 물어봅니다. 무료=280자 분할, 프리미엄=25,000자 단일.
2단계: MCP 도구 호출 — 멀티 채널 포맷
threads_format_multi_channel(
text="<원본 텍스트>",
x_tier="free", # "free" (기본) 또는 "premium"
channels=None, # 기본 ["threads","facebook","x"]. 특정 채널만 원하면 리스트로.
)
반환 구조:
{
"channels": ["threads", "facebook", "x"],
"x_tier": "free",
"note": "Threads 출력은 threads_publish_text 로 직접 발행하세요. Facebook·X 출력은 *복붙용*...",
"threads": {"text": "<≤500자 텍스트>", "chars": 412, "max_chars": 500, "truncated": False},
"facebook": "<복붙용 텍스트 문자열>",
"x": ["1/ ...", "2/ ...", "3/ ..."], # free → 리스트 / premium → 문자열
}
threads출력은threads_publish_text(또는threads_publish_image/threads_publish_video) 에 바로 넘길 수 있는 형태다.threads.truncated가True이면 도구가 끝부분을 잘랐다는 뜻이다. 원문과 잘린 결과를 대조하고 뜻이 빠졌다면 먼저 직접 다시 써야 한다. 잘린 글을 자동으로 발행하지 않는다.facebook/x출력은 사용자에게 보여줄 복붙용 이다 — 본 도구는 발행하지 않는다.- X 가
free면out["x"]가 리스트(각 트윗 ≤280자, 번호 붙음).premium이면 문자열(≤25,000자).
3단계: 채널별 출력을 사용자에게 표시 (복붙 블록)
결과를 채널별로 펜스드 코드 블록 으로 나눠 보여줍니다. 각 블록 위에 한 줄 안내를 붙입니다:
## Threads (직접 발행 가능)
<412 / 500자>
\```
<threads.text>
\```
→ 승인하시면 `threads_publish_text(text="<위 텍스트>")` 로 즉시 발행할 수 있습니다.
## Facebook (복붙해서 올리세요)
\```
<facebook 문자열>
\```
→ Facebook 개인 계정은 API 발행이 안 됩니다 — 위 텍스트를 복사해 직접 올려주세요.
## X (무료 tier — 트윗 체인, 복붙해서 올리세요)
3개 트윗:
\```
1/ <첫 트윗>
2/ <둘째 트윗>
3/ <셋째 트윗>
\```
→ 각 트윗을 순서대로 복붙해 스레드로 올려주세요 (280자 제한 자동 분할됨).
- Threads 만 따로 빼서 "승인하시면 제가 발행해 드릴 수 있습니다" 라고 안내.
- Facebook·X 는 명시적으로 "복붙해서 올리세요" 라고 안내 — 본 스킬이 발행하지 않음을 분명히.
4단계 (선택): Threads 즉시 발행
사용자가 Threads 발행까지 원하면, threads-post-draft 스킬의 2~4단계(최종 점검 → 현재 앱에서 명시적 승인 → 발행)를 그대로 따릅니다.
- [HARD] 포맷만 하고 바로 발행하지 않는다.
threads_publish_text를 직접 호출하면threads-post-draft의 최종 점검·승인 절차를 건너뛰게 됩니다. 발행은 반드시 그 스킬로 넘깁니다. - 넘길 때 전달하는 것은
out["threads"]["text"]한 덩어리입니다. 점검에서 문장이 바뀔 수 있으므로 글자 수는threads-post-draft가 점검 뒤 다시 셉니다 — 여기서 센 값은 포맷 시점의 참고값입니다. - 최종 점검에서 출처나 공개 가능 여부를 확인할 수 없거나 보조 검수가
hold_and_report를 반환하면 발행을 보류하고 사유를 알립니다.
Facebook·X 까지 한 번에 "올려달라" 고 하면 거절 합니다 — 본 스킬은 Facebook/X 발행을 하지 않습니다. 복붙 블록을 드린 것으로 끝입니다.
복붙 출력(Facebook·X)에 관하여: 사용자는 이 텍스트를 공개 계정에 붙여 넣을 수 있습니다. 전달 전에 사실·개인정보·맞춤법·의미 보존을 직접 점검합니다. 보조 검수 스킬이 노출되면 추가로 사용할 수 있습니다.
출력 형식 예시
## 멀티 채널 포맷 완료
**원본**: <첫 30자>...
**X tier**: free (280자 분할)
---
### Threads (직접 발행 가능)
412 / 500자
\```
오늘 점심에 먹은 김치찌개가 진짜 맛있었습니다. ...
\```
→ 발행을 원하시면 `threads-post-draft` 로 넘겨 최종 점검과 승인을 거쳐 발행합니다.
---
### Facebook — 복붙해서 올리세요
\```
오늘 점심에 먹은 김치찌개가 진짜 맛있었습니다. ...
\```
(Facebook 개인 계정은 API 발행 불가 — 직접 올려주세요.)
---
### X (free, 3 트윗) — 복붙해서 올리세요
\```
1/ 오늘 점심에 먹은 김치찌개가 진짜 맛있었습니다. ...
2/ ...
3/ ...
\```
(각 트윗을 순서대로 올려 스레드를 만드세요.)
주의사항
| 상황 | 대응 |
|---|---|
| 사용자가 "Facebook/X 에 올려줘" | 거절 — 본 스킬은 포맷만. 복붙 블록 제공으로 끝. |
| X tier 를 모를 때 | "무료입니까 프리미엄입니까?" 만 질문 (기본 free) |
잘못된 x_tier ("bogus") | 도구가 error dict 반환 — free/premium 만 허용 안내 |
| Threads 500자 초과 | 도구가 자동으로 단어 경계+말줄표로 다듬음 — "의미 보존 요약이 필요하면 원본을 먼저 줄여주세요" 안내 |
| 특정 채널만 원할 때 | channels=["x"] 처럼 지정 (나머지는 생략) |
| 원본이 아주 짧을 때 | X free 도 1 트윗, Threads 도 그대로 — 정상 |
References
이 스킬은 참조 파일 없이 본 문서만으로 자족합니다. 채널 제약값(Threads 500자/X 280자·25000자) 은 threads_format_multi_channel 도구(mcp-servers/moai-mcp-threads-poster/src/moai_mcp_threads_poster/server.py) 에 하드코딩된 baseline 이다.
관련 스킬
| 스킬 | 사용 시점 |
|---|---|
threads-post-draft | 원본 초안 작성·Threads 직접 발행 (저장된 문체 적용) |
threads-style-learn | 문체 프로필 분석·저장 |
이 스킬을 사용하지 말아야 할 때
- Threads 초안 작성·발행:
threads-post-draft스킬 - Facebook/X 에 자동 발행 — 불가. 이 스킬은 복붙용 텍스트만 만든다.
발행 경로 요약
- Threads: 본 스킬 포맷 →
threads-post-draft(최종 점검 → 승인 → 발행). 본 스킬이 직접 발행하지 않는다. - Facebook: 본 스킨 포맷 → 사용자가 직접 복붙 (API 발행 불가).
- X: 본 스킨 포맷(free 분할/premium 단일) → 사용자가 직접 복붙.
Threads 초안 작성·직접 발행 (threads-post-draft)
개요
주제를 받아 Threads 초안을 작성하고, 발행 전에 사실·개인정보·문장을 점검한 뒤, 최종본을 사용자가 승인하면 즉시 Graph API 로 발행합니다. 큐·예약·상태머신은 없습니다.
발행된 글은 공개 계정에 남습니다. 따라서 최종 점검과 사용자 승인을 필수 단계로 둡니다.
예약·정기 발행(예: "매주 수요일 12시")은 현재 앱에 별도 기능이 있는지 확인해 안내합니다. 본 스킬은 즉시 발행만 합니다.
트리거 키워드
Threads, 스레드, 초안, 작성, 발행, 포스트, 게시글, 주제, 변환
워크플로우
0단계: 문체 적용 (있으면)
초안 작성 전 에 저장된 문체 프로필이 있는지 확인합니다:
threads_style_load(path=None)
# → {path, exists: bool, profile: <markdown or None>}
- 프로필이 있으면 (
exists: True): 반환된 마크다운의 차원(말투·문장 길이·오프닝·클로징·이모지·시그니처 구절 등) 을 아래 1단계 초안 작성에 반영합니다. 프로필은threads-style-learn스킬이 만들어 저장한 것입니다. - 프로필이 없으면 (
exists: False): 브랜드 톤이 지정됐으면 그것을, 아니면 합리적 기본 톤(캐주얼 대화체) 으로 작성합니다. 프로필 없어도 초안 작성은 정상 동작합니다.
프로필을 새로 만들거나 갱신하려면
threads-style-learn스킬을 먼저 호출하세요.
1단계: 주제 분석 및 초안 작성
사용자의 주제/블로그 글/뉴스를 분석하여 Threads 최적화 초안을 작성합니다:
- 길이 제한: 최대 500자 (아래 글자 수 확인 규칙 참조)
- 구조: 짧은 문장, 대화 유도, 핵심 메시지 1-2개
- 톤: 브랜드 톤 일치 (지정 시), 기본값은 캐주얼한 대화체
- 토픽 태그·링크: 선택사항. 현재 계정의 작성 화면과 공식 API 제한을 확인하고 사용한다. 노출 증가를 보장하지 않는다.
2단계: 발행 전 최종 점검 (필수)
사용자에게 보여주기 전에 초안의 주장과 수치를 원자료와 대조하고, 미공개 정보·개인정보가 없는지 확인합니다. 맞춤법·띄어쓰기·어색한 반복을 직접 읽어 고친 뒤 원래 뜻이 유지되는지 다시 대조합니다. 출처나 공개 가능 여부를 확인할 수 없으면 발행을 보류하고 이유를 알립니다.
- [HARD] 점검이 승인보다 앞입니다. 승인 뒤에 문장을 고치면 사용자가 승인한 글과 발행되는 글이 달라집니다.
- [HARD] 500자 제한은 점검을 마친 최종본으로 확인합니다. 수정했다면 다시 셉니다.
moai-coworker:ai-slop-reviewer,moai-writer:korean-spell-check,moai-writer:korean-humanize가 현재 세션에 있으면 보조 검수에 사용할 수 있습니다. 별도 플러그인 설치를 발행 조건으로 삼지 않습니다. 외부 맞춤법 서비스를 쓰기 전에는 미공개 정보나 개인정보가 전송되는지 확인합니다.- 보조 검수에서
hold_and_report가 나오거나 의미 보존을 확인할 수 없으면 발행하지 않고 1단계로 돌아갑니다. 보조 검수 뒤에도 최종본을 직접 다시 읽습니다.
이미지·링크가 있다면 본문뿐 아니라 실제 연결 대상도 승인 전에 확인합니다.
3단계: 최종본 확인 (승인 게이트)
점검을 마친 최종본을 사용자에게 보여드리고 승인을 받습니다. 승인 없이는 발행하지 않습니다 ("자동 아닌 자율").
- [HARD] 승인은 사용자에게 승인서를 그대로 보여주고 명시적 응답을 받는다. 산문으로 "괜찮으세요?"라고 묻지 않습니다 — 발행은 되돌릴 수 없으므로 사용자가 명시적으로 고르게 합니다.
- [HARD] 요약이 아니라 발행될 문장 그대로를 보여준다. 최종본 전문 + 최종 글자 수 + 토픽 태그/링크를 함께 제시하고, 최종 점검에서 무엇이 바뀌었는지 한 줄로 알려드립니다.
- 사용자가 수정을 요청하면 1단계로 돌아가 다시 쓰고, 최종 점검을 다시 한 뒤 재승인을 받습니다.
- 사용자가 승인하면 4단계로 갑니다.
현재 세션에 구조화 질문 도구가 있으면 승인서 전문과 선택지를 그 도구로 보여줍니다. 없으면 대화에 같은 승인서를 제시하고 다음 사용자 응답을 기다립니다. 서브에이전트가 사용자에게 직접 물을 수 없으면 승인서 전문·선택지·재개 조건을 상위 에이전트에 반환합니다. 도구 실행 권한 팝업은 게시 내용에 대한 승인이 아니며, 명시적 응답을 받기 전에는 발행하지 않습니다.
선택지는 이렇게 구성합니다:
| 선택지 | 뜻 |
|---|---|
| 이대로 발행 (권장) | 최종본 그대로 threads_publish_text 호출 |
| 수정 요청 | 1단계로 복귀 → 최종 점검 → 재승인 |
| 발행 취소 | 아무것도 발행하지 않고 종료 |
4단계: 즉시 발행 (승인 시)
승인된 최종본을 threads_publish_text 도구로 즉시 Graph API 발행합니다:
threads_publish_text(text="<승인된 최종본>")
# → {media_id, container_id, permalink_hint, note}
- 텍스트만 발행할 때는
threads_publish_text를 사용합니다. - 이미지/비디오 포스트도 2~3단계의 본문·미디어 점검과 명시적 승인을 먼저 거친 뒤
threads_publish_image(text, image_url)/threads_publish_video(text, video_url)를 호출합니다. [HARD] 승인 화면에는 점검을 마친 본문과 실제로 넘어가는 인자 전부(미디어 종류·image_url/video_url원문·발행 계정)를 그대로 보여줍니다. 승인 뒤 인자가 바뀌면 다시 점검하고 승인받습니다. - 자격증명(
THREADS_ACCESS_TOKEN,THREADS_USER_ID) 이 미설정이면setup_required에러를 반환합니다 — 서버는 크래시하지 않습니다. 발급 절차는mcp-servers/moai-mcp-threads-poster/CONNECTORS.md참조. - [HARD] 실패해도 자동 재시도하지 않는다. 발행 도구가 애매하게 실패하면(타임아웃·응답 없음) 재시도하지 않고 멈춥니다. 성공 신호가 없다는 것은 발행되지 않았다는 증거가 아니며, 확인 없는 재시도는 같은 글을 두 번 올립니다. 발행은 컨테이너 생성 → 발행 2단계라, 1단계만 성공한 상태에서 재시도하면 중복 컨테이너가 남습니다.
- [HARD] 이 서버에는 발행 여부를 조회할 도구가 없다.
threads_get_profile은username·id·followers_count·profile_picture_url만 반환합니다(server.py:281) — 타임라인도 게시글 상태도 없습니다. 나머지 도구도 발행·프로필·문체 저장뿐이라 게시 여부를 되물을 수단이 없습니다. 따라서 애매한 실패 시에는 사용자에게 Threads 앱/웹에서 직접 확인해 달라고 요청하고, 올라가지 않았다는 사용자의 확인을 받은 뒤에만 다시 발행합니다. 스킬이 혼자 판단하지 않습니다.
발행은 세션 안에서 즉시 일어납니다. 백그라운드 자동 발행은 없습니다. 예약이 필요하면 현재 앱의 지원 여부를 확인하세요.
글자 수 확인 (500자 제한)
Meta 공식 소개는 일반 Threads 게시글을 최대 500자로 안내합니다. 서버의 사전 검사는 Python len(text)로 세며, 한글 한 글자를 UTF-8 3바이트로 환산해 한도를 줄이지 않습니다. 결합 문자·복합 이모지의 세부 계산은 API와 다를 수 있으므로 최종 발행 오류가 있으면 그 응답을 확인하고 본문을 조정합니다.
출력 형식
최종 점검을 마친 뒤, 승인 요청은 현재 앱의 질문 도구 또는 대화로 이 형식을 그대로 보여줍니다:
## 발행 최종본 (승인 요청)
<점검을 마친 최종본 — 발행될 문장 그대로>
**글자 수**: N / 500 ← 최종 점검 뒤 다시 센 값
**토픽 태그**: (선택사항) #태그이름
**링크**: (선택사항) URL
**최종 점검**: 사실·개인정보·맞춤법·의미 보존 확인 결과와 변경 사항
승인 후 발행이 끝나면:
## 발행 완료
**media_id**: ...
**permalink**: https://www.threads.net/@<username>/post/<media_id>
주의사항
| 상황 | 대응 |
|---|---|
| 500자 초과 시 | 초안을 줄이거나 두 개의 포스트로 분할 제안 |
| 토픽 태그·링크가 여러 개인 경우 | 현재 API의 제한과 초안의 읽기 흐름을 확인한다 |
| 이미지/비디오 포함 요청 시 | threads_publish_image, threads_publish_video 도구 직접 호출 제안 |
| 브랜드 톤 미지정 시 | 업종·타겟 기반 캐주얼 톤 초안 제안 후 확인 |
setup_required 에러 | 앱 설정 또는 사용자 자격증명 파일에서 THREADS_ACCESS_TOKEN, THREADS_USER_ID 확인 (CONNECTORS.md 참조) |
| 예약·정기 발행 요청 시 | 현재 앱의 지원 여부를 확인해 안내 (본 스킬은 즉시 발행만) |
출처·공개 가능 여부 미확인 또는 보조 검수 hold_and_report | 발행하지 않음. 사유를 보여주고 1단계로 복귀 |
| 초안에 미공개 정보가 섞임 | 공개 여부를 확인할 때까지 발행 보류. 외부 맞춤법 서비스에 전송하지 않음 |
| 점검 후 500자 초과 | 최종본 기준으로 다시 판정 — 줄이거나 두 포스트로 분할 제안 |
| 발행 도구가 애매하게 실패 | 자동 재시도 금지. 실제 발행 여부를 먼저 확인한 뒤 판단 |
| "점검 건너뛰고 바로 올려줘" 요청 | 점검을 마친 최종본을 승인받은 뒤 발행 |
References
| 파일 | 로드 조건 |
|---|---|
| references/threads-spec.md | Threads 글자 수와 미디어 규격 확인 시 |
관련 스킬
| 스킬 | 사용 시점 |
|---|---|
threads-style-learn | 문체 분석·저장 (이 스킨이 초안 작성 시 자동 적용) |
threads-multichannel | 초안을 Threads/Facebook/X 용으로 멀티 채널 포맷 |
moai-marketer:content-sns-content | 브랜드 톤 가이드·채널별 최적화 패턴 |
moai-coworker:ai-slop-reviewer | 노출된 경우 AI 문구 추가 검토 |
moai-writer:korean-spell-check | 노출되고 외부 전송이 허용된 경우 맞춤법 제안 |
moai-writer:korean-humanize | 노출된 경우 장르: 카피로 추가 윤문·의미 검수 |
이 스킬을 사용하지 말아야 할 때
- Facebook/X 용 텍스트 포맷:
threads-multichannel스킬 - 문체 분석·저장:
threads-style-learn스킬 - 예약·정기 발행: 현재 앱의 지원 여부 확인 (본 플러그인은 즉시 발행만)
발행 전 설정 (최초 1회)
발행에는 Threads 장기 액세스 토큰과 사용자 ID가 필요합니다. 발급 절차는 mcp-servers/moai-mcp-threads-poster/CONNECTORS.md를 따릅니다. 토큰은 저장소의 .mcp.json에 직접 쓰지 않습니다.
앱이 플러그인 자격증명 입력 화면을 제공하면 거기에 값을 입력합니다. 값이 서버에 전달되지 않는 환경에서는 사용자 홈의 .moai/mcp/threads.json에 UTF-8 JSON 객체로 저장합니다. macOS·Linux는 ~/.moai/mcp/threads.json, Windows는 사용자 프로필 아래 .moai/mcp/threads.json입니다. 서버는 실제 값이 든 환경변수, 이 파일 순서로 읽으며 미확장 ${...}는 자격증명으로 취급하지 않습니다.
{
"THREADS_ACCESS_TOKEN": "<장기 액세스 토큰>",
"THREADS_USER_ID": "<Threads 사용자 ID>"
}
이 파일과 토큰 값은 대화 결과나 저장소에 남기지 않습니다. 환경변수로 설정하는 개발자용 절차는 CONNECTORS.md에 있습니다.
동작 확인: threads_get_profile 도구 호출 → 프로필 정보 반환되면 연동 성공.
Threads 문체 학습 (threads-style-learn)
개요
과거 Facebook/Threads 포스팅 3-10개를 받아 문체(style profile) 를 분석하고, 안정적인 경로에 저장합니다. 저장된 프로필은 threads-post-draft 스킬이 초안 작성 시 자동으로 불러와 적용합니다.
왜 필요한가: 같은 내용이어도 "내 글투" 로 쓰인 글이 훨씬 자연스럽게 다가갑니다. 이 스킬은 일회성 분석이 아니라 — 한 번 저장하면 이후 모든 초안 작성에 재사용되는 영구 프로필을 만듭니다.
트리거 키워드
문체, 스타일, 학습, 분석, 글투, 톤앤매너, 톤, 말투, 프로필, 저장, 과거 포스팅, 이전 글
워크플로우
1단계: 과거 포스팅 수집 (3-10개)
사용자에게 과거 Facebook/Threads 포스팅을 붙여넣어 달라고 요청합니다. 최소 3개, 권장 5-10개가 있어야 문체가 안정적으로 잡힙니다.
요청 예시:
문체를 분석하려면 과거에 직접 쓰신 포스팅 3-10개를 붙여넣어 주세요.
- Threads, Facebook, 블로그 어디든 상관없습니다
- *직접 쓰신 글* 이어야 합니다 (공유/인용글 X)
- 짧은 글·긴 글 섞여 있을수록 더 좋습니다
- 파일 경로를 알려주셔도 됩니다 (예: `~/posts.txt`)
또는 사용자가 파일 경로를 알려주면 Read 도구로 읽어옵니다.
2단계: 문체 차원 분석
수집된 포스팅에서 아래 차원들을 추출합니다. 각 차원은 references/style-profile-template.md 의 항목과 1:1 로 대응합니다.
| 차원 | 분석 포인트 |
|---|---|
| 말투(톤) | 경어체(해요체/하십시오체) · 반말(해체) · 혼합. 비율(%) 로 기록 |
| 문장 길이 | 평균 글자 수, 가장 긴/짧은 문장. 짧고 끊어 쓰는지 길게 쓰는지 |
| 단락 리듬 | 한 문단에 몇 문장? 줄바꿈을 자주 하는지. 리스트/번호 자주 쓰는지 |
| 이모지 빈도·스타일 | 포스팅당 평균 이모지 수. 잘 쓰지 않는지 / 풍부하게 / 특정 이모지 반복 |
| 오프닝 훅 | 첫 문장 패턴 (질문 · 인사 · 선언 · 사실 인용). "자주 시작하는 방식" |
| 클로징 패턴 | 마무리 패턴 (질문 던지기 · 행동 유도 · 여운 남기기 · 인사) |
| 해시태그/토픽태그 습관 | 쓰는지 안 쓰는지. 쓰면 몇 개, 어떤 종류 |
| 유머/위트 수준 | 거의 없음 / 가끔 / 적극적. 말장난·드립 스타일 |
| 시그니처 구절 | 반복되는 표현·정어구 (예: "~입니다", "~봅시다", 특정 이모티콘) |
| 어휘 레벨 | 전문 용어 자주 쓰는지 / 일상어 위주인지 |
| 띄어쓰기/맞춤법 | 엄격한지 / 여느 정도 느슨한지 |
분석은 추측이 아니라 수집된 글에서 실제로 관찰된 증거 에 기반해야 합니다. 예시:
- 좋음: "10개 중 8개가 해요체, 문장 평균 15자로 짧게 끊어 씀"
- 나쁨: "아마 친근한 톤일 것 같습니다" (근거 없음)
3단계: 프로필 작성 → 저장
분석 결과를 references/style-profile-template.md 양식으로 채워 마크다운을 만듭니다. 그리고 threads_style_save 도구로 저장합니다:
threads_style_save(
profile_markdown="""# <사용자명> 문체 프로필
## 말투 (톤)
- 해요체 80% / 해체 20% 혼합
- ...
## 시그니처 구절
- "~ 어떻게 생각하세요?" (질문으로 마무리)
...
""",
path=None # 기본 경로: 사용자 홈의 .moai/mcp/threads-style-profile.md
)
path=None이면 사용자 데이터 경로에 저장됩니다 — 한 번 저장하면 이후threads-post-draft가 자동으로 불러옵니다.- 다른 경로에 저장하려면
path=로 지정 (권장하지 않음 — 기본 경로가 자동 적용 대상).
4단계: 저장 확인 + 다음 단계 안내
저장 결과({path, saved: True, chars: N}) 를 사용자에게 알려주고, 다음을 안내합니다:
- 프로필이 저장되었으니 이제
threads-post-draft로 초안을 작성하면 자동으로 이 문체가 적용됩니다. - 프로필을 다시 분석/갱신하려면 이 스킬을 다시 호출 (덮어쓰기).
출력 형식
## 문체 프로필 저장 완료
**분석 샘플**: N개 포스팅
**저장 경로**: <path>
**분석 차원**: 11개 (말투·문장 길이·단락 리듬·이모지·오프닝·클로징·해시태그·유머·시그니처·어휘·띄어쓰기)
### 핵심 특징 (요약)
- 말투: 해요체 중심 (80%)
- 문장: 평균 15자, 짧게 끊어 씀
- 오프닝: 질문으로 시작 (7/10)
- 클로징: 독자에게 질문 던지기 (8/10)
- 이모지: 포스팅당 평균 2개
- 시그니처: "~ 어떻게 생각하세요?"
**다음 단계**: 이제 `threads-post-draft` 로 초안을 작성하면 저장된 문체가 자동 적용됩니다. 프로필 갱신은 이 스킬을 다시 호출하면 덮어쓰기됩니다.
주의사항
| 상황 | 대응 |
|---|---|
| 샘플이 3개 미만 | "최소 3개는 필요합니다" 안내, 더 붙여넣어 달라고 요청 |
| 샘플이 직접 쓴 글이 아닐 때 (인용/공유) | "직접 쓰신 글로 다시 주시면 정확합니다" 안내 |
| 차원이 모호할 때 (예: 유머 수준 판단 안 됨) | "이 샘플만으로는 판단 어렵습니다 — '관찰되지 않음' 으로 기록" (추측 금지) |
| 분석이 주관적일 때 | 가능한 한 숫자(%·횟수·평균) 로 근거 제시 |
| 다시 분석 요청 | 기존 프로필을 덮어쓴다고 안내 후 재진행 |
References
| 파일 | 로드 조건 |
|---|---|
| references/style-profile-template.md | 프로필 작성 시 — 차원 양식·예시 구조 확인 |
관련 스킬
| 스킬 | 사용 시점 |
|---|---|
threads-post-draft | 저장된 프로필을 적용해 초안 작성·즉시 발행 |
threads-multichannel | 작성된 초안을 Threads/Facebook/X 용으로 포맷 |
이 스킬을 사용하지 말아야 할 때
- 초안 작성·발행:
threads-post-draft스킬 사용 (이 스킨은 프로필 저장까지) - 멀티 채널 포맷(Facebook/X):
threads-multichannel스킬 사용 - 프로필 없이 한 번만 글 쓰기:
threads-post-draft가 프로필 없을 때 기본 톤으로 작성하므로 이 스킬은 생략 가능
저장 경로·자격증명
- 저장 경로(기본): 사용자 홈의
.moai/mcp/threads-style-profile.md(macOS·Linux는~/.moai/mcp/, Windows는 사용자 프로필 아래의.moai/mcp/). 기존 플러그인 내부.data/style-profile.md가 있으면 새 파일을 저장하기 전까지 읽습니다. - 자격증명 불필요: 이 스킬의 저장 도구(
threads_style_save/threads_style_load)는 Threads API 자격증명 없이 동작합니다 — 로컬 파일 I/O 전용입니다. - 발행 전 설정(Threads 자격증명)은 초안 발행 시에만 필요 —
threads-post-draft의 "발행 전 설정" 섹션 참조.
MCP servers 1
Sponsors
Details
- Marketplace
- modu-ai/moai-cowork
- Source
- plugins/moai-threads-poster
- Category
- 소셜미디어
More from modu-ai/moai-cowork
All 18- moai-tutorv1.3.5
- moai-writerv1.5.14
- moai-accountantv1.3.9
- moai-analystv1.3.7
- moai-careerv1.2.7
- moai-consultantv1.2.8
- moai-coworkerv1.2.28
- moai-csv1.2.9
- moai-designerv1.4.73
- moai-lawyerv1.4.18
- moai-marketerv1.2.24
- moai-mediav3.3.16
- moai-officerv1.3.9
- moai-pmv1.7.0
- moai-recruiterv2.0.9
- moai-sellerv1.4.33
- moai-storyv1.2.5