Tistory publish

Skill garibong-labs/openclaw-skills/tistory-publish

OpenClaw skills by Garibong Labs

Install

npx -y skills add garibong-labs/openclaw-skills --skill tistory-publish

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Automate Tistory blog publishing via OpenClaw Playwright CDP. Supports any post format — handles TinyMCE editor manipulation, OG card insertion, banner upload, tag registration, category setting, and representative image selection. Includes template presets (mk-review, daum-trends, simple-post). Works around Tistory's isTrusted event filtering.

SKILL.md

8.8 KB, as published. Nobody here has run it

Tistory Publish

티스토리 블로그 범용 자동 발행 스킬. 어떤 형식의 글이든 자동 발행할 수 있습니다.

Tistory Open API 종료(2024.02) 이후 유일한 자동화 경로인 브라우저 자동화를 제공합니다.

전제 조건

OpenClaw 브라우저 서비스 (Chrome CDP, 기본 port 18800)
티스토리 카카오 로그인 완료 (OpenClaw Chrome에서)
Python 3 + Playwright (pip install playwright)
Node.js 18+ (배너 생성 시, 선택)
(선택) 카카오 자격증명 파일 — 로그인 세션 만료 시 복구용 (scripts/login.sh --cred-file <경로>)
- JSON 형식: {"email": "...", "password": "..."}
- 또는 key-value 형식: email: ...\npassword: ...
- publish.sh는 자격증명을 읽지 않음 (로그인은 login.sh에서만 처리)
- publish-post.sh 자동 복구는 현재 --blog와 --cdp-port를 login.sh로 전달함

구조

tistory-publish/
├── SKILL.md                     # 이 파일
├── scripts/
│   ├── tistory-publish.js       # 코어 — 에디터 조작 함수 모음
│   ├── publish.sh               # 범용 발행 스크립트
│   ├── seo_check.py             # 발행 전 SEO 정적 검사
│   └── login.sh                 # 카카오 로그인 세션 복구
└── templates/
    └── simple-post/             # 예시: 단순 글 발행
        └── RUNBOOK.md

빠른 시작

# 가장 단순한 발행
bash scripts/publish.sh \
  --title "글 제목" \
  --body-file body.html \
  --category "카테고리명" \
  --blog "your-blog.tistory.com"

# 매경 리뷰 (템플릿 사용)
bash scripts/publish.sh \
  --template mk-review \
  --article-title "기사 제목" \
  --body-file body.html \
  --banner /tmp/banner.jpg \
  --tags "매경,경제뉴스" \
  --blog "anthropic.tistory.com" \
  --category "재테크 이야기/경제신문 리뷰" \
  --cdp-port 18800

# 배너 + 태그 + 비공개
bash scripts/publish.sh \
  --title "글 제목" \
  --body-file body.html \
  --category "카테고리명" \
  --banner /tmp/banner.jpg \
  --tags "태그1,태그2,태그3" \
  --private

발행 스크립트 옵션 (`publish.sh`)

옵션	필수	설명
`--title`	✅	글 제목
`--body-file`	✅	본문 HTML 파일 경로
`--category`	✅	카테고리 이름 (에디터에 표시되는 이름 그대로)
`--template`		템플릿 preset (mk-review, daum-trends, simple-post)
`--article-title`		mk-review용 기사 제목 (자동 날짜 접두사)
`--tags`		쉼표 구분 태그 목록
`--banner`		배너 이미지 파일 경로
`--banner-alt`		배너 이미지 alt 텍스트 (기본: 제목 — 빈 alt로 업로드되지 않도록)
`--blog`		블로그 도메인 (기본: tistory.com 첫 번째 블로그)
`--cdp-port`		OpenClaw Chrome CDP 포트 (기본: `TISTORY_CDP_PORT` 또는 스크립트 기본값)
`--helper`		tistory-publish.js 경로 (기본: scripts/ 내)
`--private`		비공개 발행
`--seo-check`		발행 전 SEO 검사 모드: `off`(기본)/`warn`/`strict`. `strict`는 error 발견 시 발행 중단
`--seo-keyword`		SEO 핵심 키워드 (기본: 제목 첫 단어). 제목/도입부/소제목 내 키워드 배치 검사에 사용
`--seo-min-body-chars`	`1000`	SEO 본문 최소 노출 글자수. `strict`에서는 미달 시 발행 중단

템플릿 preset

이름	카테고리	블로그	제목 형식	배너
`mk-review`	재테크 이야기/경제신문 리뷰	anthropic.tistory.com	`[매경] YYYY.MM.DD(요일) - 기사 제목`	필수
`simple-post`	(직접 지정)	(직접 지정)	(직접 지정)	선택

자신만의 preset을 추가하려면 templates/ 아래에 폴더를 만들고 publish.sh --template <이름> 으로 사용하세요.

Daum Trends preset

Use --template daum-trends for Daum 실시간 트렌드 posts. This preset supplies content defaults such as tags only. The caller must still pass --blog and --category explicitly.

ALLOW_DIRECT_TISTORY_PUBLISH=1 bash scripts/publish-post.sh \
  --template daum-trends \
  --title "Daum 실시간 트렌드 ..." \
  --body-file body.html \
  --blog "$DAUM_TRENDS_TISTORY_BLOG" \
  --category "$DAUM_TRENDS_TISTORY_CATEGORY" \
  --cdp-port "$TISTORY_CDP_PORT"

세션 복구를 직접 실행할 때도 같은 포트를 명시한다:

bash scripts/login.sh \
  --cred-file "$TISTORY_LOGIN_CRED_FILE" \
  --blog "$DAUM_TRENDS_TISTORY_BLOG" \
  --cdp-port "$TISTORY_CDP_PORT"

자동 처리 항목

스크립트가 순서대로 처리:

SEO 검사 (--seo-check warn|strict 지정 시, 발행 전 정적 검사)
새 글 페이지 열기
JS 헬퍼 함수 주입
카테고리 선택 (ARIA combobox → Playwright click)
제목 입력 (base64 디코딩으로 한글 처리)
본문 HTML 삽입
배너 이미지 업로드 (첨부→사진 메뉴 → file input) + alt 텍스트 설정
OG 카드 생성 (placeholder URL → Enter 키 → 카드 렌더링)
대표이미지 설정
태그 등록
발행 (공개/비공개)

본문 HTML 작성 규칙

<p data-ke-size="size16"> 태그 사용
단락 = 여러 문장 묶음 (<p> 하나에 2~4문장)
OG 카드 위치: <p data-og-placeholder="URL"></p>
구분선: <hr contenteditable="false" data-ke-type="horizontalRule" data-ke-style="style1">

SEO 규칙 (검색 노출용 — `--seo-check`가 검사하는 항목)

Tistory는 본문 시작부를 meta description / og:description으로 사용하므로 본문 구조가 곧 검색 스니펫이다.

도입부 필수: 첫 <h2> 이전에 80~150자 요약 문단 1개. 핵심 키워드를 첫 150자 안에 배치 (검색 결과 요약문으로 노출됨)
제목: 핵심 키워드를 앞쪽(20자 이내)에 배치, 전체 60자 이하 (SERP에서 한글 30~35자만 노출)
소제목: h2 2개 이상, 최소 1개 h2/h3에 핵심 키워드 포함
이미지 alt: 본문 내 모든 <img>에 alt 필수, 배너는 --banner-alt로 지정
내부 링크: 같은 블로그의 관련 글 2~3개 링크 (크롤링 경로 + 체류시간)
외부 출처: 원문 링크 또는 OG 카드 1개 이상
본문 분량: 노출 텍스트 1,000자 이상 (단순 발췌는 저품질 콘텐츠로 분류될 수 있음)
태그: 5~10개, 중복 금지, 범용 키워드 + 롱테일 키워드 혼합

단독 실행:

python3 scripts/seo_check.py \
  --title "글 제목" --body-file body.html \
  --tags "태그1,태그2" --keyword "핵심키워드" \
  --blog "your-blog.tistory.com" --mode strict --min-body-chars 1000

템플릿 추가하기

templates/ 디렉토리에 새 폴더를 만들어 자신만의 워크플로우를 추가할 수 있습니다:

templates/my-template/
├── RUNBOOK.md       # 발행 순서
├── TEMPLATE.md      # 원고 작성 템플릿
└── banner.js        # 배너 생성 스크립트 (선택)

주요 JS 함수 (`tistory-publish.js`)

콘텐츠

insertContent(html) — TinyMCE에 HTML 삽입
buildBlogHTML({intro, articles}) — 구조화된 데이터 → HTML 변환

OG 카드

getOGPlaceholders() — placeholder URL 목록
prepareOGPlaceholder(url) — placeholder → URL 텍스트 교체
verifyOGCard(url) — 카드 렌더링 확인

메타데이터

setTags(tags[]) — 태그 등록
setRepresentImageFromEditor() — 대표이미지 설정
setImageAlt(alt, index) — 에디터 내 이미지 alt 텍스트 설정 (SEO)
setImageAltForUploadedImage(alt, filename, previousCount) — 업로드 직후 새 이미지 alt 텍스트 설정 (기존 이미지 덮어쓰기 방지)

배너

verifyBannerUpload() — 업로드 확인

알려진 제약

isTrusted=false 이벤트 무시 → OG/태그에 우회 로직 필요
카테고리가 ARIA combobox → Playwright click 필요
대표이미지 셀렉터가 Tistory 업데이트마다 변경 가능

변경 이력

CHANGELOG.md 참조