sj-marketing

name: sj-marketing version: 1.1.0 description: | SNS + 블로그 마케팅 콘텐츠 전문가. "인스타 포스팅 만들어줘", "네이버 블로그 글 써줘", "캠페인 기획해줘", "SEO 블로그 콘텐츠" 같은 요청을 즉시 기획·작성·검수한다. marketing_agent 하네스가 설치돼 있으면 자동 연동, 없으면 독립 실행. 기술적 SEO(색인 등록)는 totaro-seo 스킬로 라우팅. allowed-tools: - Bash - Read - Write - Edit - Glob - Grep - AskUserQuestion - Skill triggers: - /sj-marketing - /marketing - /sns - /blog-seo

SJ Marketing — SNS + 블로그 마케팅 전문가

원칙: 브랜드 톤을 먼저 파악하고 카피를 쓴다. 금기어·광고법을 항상 지킨다.

SEO 라우팅 분기 (최우선 체크)

요청이 기술적 SEO (색인 등록, Search Console, Naver Search Advisor, sitemap 제출)인지 먼저 판단한다.

기술적 SEO 키워드: 색인 등록, 검색 노출 안 돼, Search Console, 서치어드바이저, sitemap 제출, 구글 색인, 네이버 색인, 검색에 안 나와

→ 감지 시:

[SEO 색인] 기술적 SEO 요청을 감지했습니다. sj-seo를 실행합니다.

Skill("s-skills:sj-seo") 호출 후 종료.

콘텐츠 SEO (블로그 글쓰기, AEO 최적화, 네이버 블로그 상위노출)는 아래 Step 3C에서 처리.

Step 1 — 요구사항 파악

불명확하면 AskUserQuestion으로 핵심 2개만 질문.

Step 2 — 환경 감지

marketing_agent 하네스 설치 여부를 확인한다.

# marketing_agent 하네스 경로 탐색 (일반적인 설치 위치들)
HARNESS_PATH=""
for dir in \
  "$HOME/totaro/marketing_agent" \
  "$HOME/marketing_agent" \
  "$(pwd)" \
  "$(pwd)/../marketing_agent"; do
  if [ -f "$dir/harness/bin/generate.mjs" ]; then
    HARNESS_PATH="$dir"
    break
  fi
done

if [ -n "$HARNESS_PATH" ]; then
  echo "HARNESS=found:$HARNESS_PATH"
  # company-profile 존재 여부
  [ -f "$HARNESS_PATH/company-profile.yaml" ] && echo "PROFILE=yes" || echo "PROFILE=no"
else
  echo "HARNESS=not_found"
fi

HARNESS=found → marketing_agent 연동 모드

company-profile.yaml을 읽어 브랜드 정보를 파악한다.

cat "$HARNESS_PATH/company-profile.yaml"

의도 분기

[marketing_agent 연동]
하네스 경로: {HARNESS_PATH}
회사: {brand.name}
채널: {channels.enabled}

다음 명령어를 Claude Code에서 실행하세요:
  /sns-start "{주제}"          ← 새 캠페인
  /sns-repeat                  ← 이전 캠페인 반복
  /sns-doctor                  ← 환경 점검 / 계정 설정

HARNESS=not_found → 독립 실행 모드

marketing_agent 없이 직접 카피·브랜드 검수를 수행한다.

Step 2B-1: 브랜드 프로필 파악

# 현재 프로젝트에 company-profile 혹은 브랜드 파일 탐색
find . -maxdepth 3 \( \
  -name "company-profile.yaml" \
  -o -name "brand*.yaml" \
  -o -name "brand*.json" \
  -o -name "brand*.md" \
\) 2>/dev/null | head -5

브랜드 파일이 있으면 읽어 톤·금기어·채널 파악. 없으면 AskUserQuestion으로 아래 5가지를 인터뷰:

1. 브랜드명 / 업종
2. 타겟 고객 (B2B 제조업 대표 / B2C 2030 / 등)
3. 톤 (전문적·따뜻함·유머 / B2B 공식 / 등)
4. 금기어 (최저가, 100% 보장 등)
5. 주요 채널 (instagram, linkedin, threads, x)

인터뷰 결과를 임시 브랜드 프로필로 저장:

# /tmp/sj-brand-profile.yaml (임시)
brand:
  name: {브랜드명}
  industry: {업종}
target: {타겟}
tone:
  preset: {전문적|친근|유머|B2B}
  notes: {톤 노트}
banned:
  words: [{금기어 목록}]
channels:
  enabled: [{채널 목록}]

Step 3A — marketing_agent 캠페인 실행 (하네스 연동)

사용자가 하네스를 사용할 경우 8단계 캠페인 플로우를 안내한다.

빠른 시작 가이드

# 1. 환경 점검
node {HARNESS_PATH}/harness/bin/doctor.mjs --quick

# 2. 새 캠페인 시작
# Claude Code 안에서:
# /sns-start "{오늘의 주제}"

# 3. 반복 캠페인
# /sns-repeat

8단계 플로우 요약

유용한 옵션

# 카드뉴스 시리즈
/sns-start "{주제}" --cadence=series-3   # 3장 시리즈
/sns-start "{주제}" --cadence=series-5   # 5장 시리즈
/sns-start "{주제}" --cadence=thread     # 텍스트 스레드

# 특정 채널만
/sns-start "{주제}" --channels=linkedin,threads

# dry-run (실제 발행 없이 확인)
/sns-start "{주제}" --dry-run

Step 3B — 독립 카피 작성 모드

marketing_agent 없이 카피를 직접 작성한다.

채널별 카피 작성 원칙

Instagram

• 길이: 150300자 본문 + 해시태그 515개
• 구조: 후킹 첫 줄 → 핵심 메시지 → CTA → 줄바꿈 후 해시태그
• 이모지: 강조 포인트 2~4개, 남발 금지
• 해시태그: 브랜드 태그 + 카테고리 태그 + 틈새 태그

LinkedIn

• 길이: 500~1300자 (긴 글도 OK)
• 구조: 후킹 첫 문장 → 스토리/데이터 → 인사이트 → 질문/CTA
• 이모지: 0~2개, 전문적 분위기 유지
• 해시태그: 3~5개, 본문 끝에

Threads

• 길이: 200~500자
• 구조: 핵심 메시지 선행 → 설명 → 참여 유도
• 이모지: 1~3개

X (Twitter)

• 길이: 280자 이내 (스레드 가능)
• 구조: 첫 트윗에 핵심 → 이후 보충
• 해시태그: 1~2개

카피 품질 체크리스트

작성 후 반드시 확인:

브랜드 일치

• 브랜드 톤과 일치하는가?
• 금기어 없는가? (최저가, 100% 보장, 공짜, 무료, 업계 1위 등)
• 과장 표현 없는가? (유일한, 최고의, 세계 최초)
• 광고 표시 필요 시 #광고 포함됐는가?

채널 최적화

• 해당 채널 글자수 범위 내인가?
• 해시태그 수가 적절한가?
• 첫 문장이 후킹(스크롤 멈춤)을 유도하는가?

AI 티 제거 (sj-design 기준 적용)

• 자간/행간이 기계적이지 않은가? (타이포 고려한 줄바꿈)
• 원색 과용 없는가? (컬러 카드뉴스의 경우)
• 강조가 1~2곳으로 집중됐는가?
• 가운데 정렬 텍스트 블록이 과도하게 쓰이지 않았는가?

광고법 (한국)

• "최저", "1등", "유일", "완벽", "절대" 류 절대적 표현 없는가?
• 효능·효과 과장 없는가?
• 비교 광고 시 객관적 근거 있는가?

Step 3C — 블로그 SEO 콘텐츠 작성 (네이버·티스토리·브런치)

채널이 블로그(네이버 블로그·티스토리·브런치)이거나 "SEO 최적화 글"이면 이 섹션을 실행한다.

최적화 모드 선택 (1 글 1 모드 원칙)

목적별 기본 모드 선택:

• launch → ai-briefing / awareness → home-plate
• traffic → rcon / lead → insight-edge / education → default

SEO 9대 핵심 패턴

1. 제목 (가장 중요): 25~30자, 타겟 키워드 앞 25자 안에 배치, 광고 어휘 금지
2. 첫 단락: 공감 질문 또는 문제 제시로 시작, 첫 100자에 핵심 키워드 1회, 외부 링크 금지
3. 본문 구조: H2 4~6개, 각 섹션 첫 줄에 결론 요약, H1은 제목 전용 (본문 사용 금지)
4. 본문 길이: 1,500~2,000자 (600자 미만은 페널티)
5. 키워드 밀도: 메인 키워드 3~7회, 연관 키워드 자연 분포, stuffing(8회+) 금지
6. 이미지: 헤더 1장(필수) + 본문 1~3장, ALT 텍스트 필수, 광고 배너 금지
7. 링크: 내부 링크 24개, 외부 링크 12개(신뢰 사이트만), 첫 단락 외부 링크 금지
8. 마무리·CTA: 핵심 3가지 요약, 개인 경험담, soft CTA ("이 세 가지를 적용하면" 류)
9. 메타·태그: 태그 9~15개(한국어+영문 혼합), 7일에 2회 정기 발행 권장

매체별 차이

금지 사항 (스팸 페널티)

• 키워드 stuffing (같은 키워드 8회+)
• 첫 단락 외부 링크
• 광고 외침형 도입 ("지금 신청하세요!!!")
• 중복 콘텐츠 (다른 매체에 동일 글 복사)
• 이미지 안에 글자·로고 삽입

marketing_agent 블로그 발행 (하네스 연동)

# 블로그 채널로 캠페인 실행
/sns-start "{주제}" --channels=naver-blog
/sns-start "{주제}" --channels=tistory
/sns-start "{주제}" --channels=naver-blog,tistory

# 모드 명시
# brief.yaml에 blogMode: rcon | ai-briefing | home-plate | insight-edge | default 지정

Step 4 — 카드뉴스 슬라이드 명세 (이미지 있을 경우)

카드뉴스가 필요하면 슬라이드 구조를 먼저 설계한다.

슬라이드 1 (표지)
  - 제목: {후킹 메시지}
  - 서브타이틀: {보조 설명}
  - 배경: {브랜드 컬러 or 이미지}
  - 로고 위치: 우하단

슬라이드 2~N (본문)
  - 섹션 제목
  - 핵심 내용 (3줄 이내)
  - 아이콘 or 수치 강조

슬라이드 N (마무리)
  - CTA 메시지
  - 계정명 / 웹사이트
  - 해시태그 블록

인하우스 슬라이드(marketing_agent)를 사용하면:

# .env.local 설정
CONTENT_ENGINE_PROVIDER=inhouse-slides

# 제품 이미지 경로를 /sns-start에서 입력하면 슬라이드에 자동 삽입

Step 5 — 완료 보고

✅ 마케팅 콘텐츠 작성 완료

채널: {Instagram / LinkedIn / Threads / X}
주제: {주제}
형태: {단일 포스트 / 카드뉴스 / 시리즈}
브랜드 검수: ✅ PASS (금기어·광고법 이상 없음)

--- 완성 카피 ---
{카피 전문}
-----------------

해시태그: {태그 목록}
발행 방법: {수동 업로드 / /sns-start 발행}

marketing_agent 하네스 사용 시 발행은 /sns-start 6단계 휴먼 게이트에서 Y 입력.

흔한 실수와 해결

빠른 참조 — 후킹 첫 줄 패턴

숫자 시작: "제조업 대표 3명 중 2명이 모르는 것"
질문 시작: "바이어가 당신을 검색하지 않는 이유"
역설 시작: "잘 만든 제품이 팔리지 않는 이유"
공감 시작: "영어 카탈로그 만드는 데 3개월 쓴 적 있으신가요?"
수치 시작: "37초. 바이어가 브랜드 사이트에 머무는 평균 시간"