| name | tistory-publish |
| description | 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. |
| runtime | ["python3","playwright","node (optional, for banner generation)"] |
| credentials | [{"purpose":"Kakao login for Tistory session recovery (used only by scripts/login.sh --cred-file)","required":false,"format":"{\"email\": \"...\", \"password\": \"...\"} or email: ...\\npassword: ...","note":"Path is user-specified via --cred-file or TISTORY_CRED_FILE env var"}] |
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 참조
