dvcrn Tistory Publish
티스토리 블로그 범용 자동 발행 스킬. 어떤 형식의 글이든 agent-browser로 자동 발행할 수 있습니다.
Tistory Open API 종료(2024.02) 이후 유일한 자동화 경로인 브라우저 자동화를 제공합니다.
전제 조건
- agent-browser CLI + 프로필 (Kakao 로그인 완료)
- Node.js 18+ (배너 생성 시, 선택)
구조
tistory-publish/
├── SKILL.md # 이 파일
├── scripts/
│ ├── tistory-publish.js # 코어 — 에디터 조작 함수 모음
│ └── publish.sh # 범용 발행 스크립트
└── templates/
├── mk-review/ # 예시: 신문 리뷰 (배너+OG 4개)
│ ├── RUNBOOK.md
│ ├── TEMPLATE.md
│ ├── banner.js
│ ├── deep-dive.js
│ └── IMAGE-MAP.md
└── simple-post/ # 예시: 단순 글 발행
└── RUNBOOK.md
빠른 시작
# 가장 단순한 발행
bash scripts/publish.sh \
--title "글 제목" \
--body-file body.html \
--category "카테고리명" \
--blog "your-blog.tistory.com"
# 배너 + 태그 + 비공개
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 |
✅ | 카테고리 이름 (에디터에 표시되는 이름 그대로) |
--tags |
쉼표 구분 태그 목록 | |
--banner |
배너 이미지 파일 경로 | |
--blog |
블로그 도메인 (기본: tistory.com 첫 번째 블로그) | |
--helper |
tistory-publish.js 경로 (기본: scripts/ 내) | |
--private |
비공개 발행 |
자동 처리 항목
스크립트가 순서대로 처리:
- 새 글 페이지 열기
- JS 헬퍼 함수 주입
- 카테고리 선택 (ARIA combobox → Playwright click)
- 제목 입력 (base64 디코딩으로 한글 처리)
- 본문 HTML 삽입
- 배너 이미지 업로드 (첨부→사진 메뉴 → file input)
- 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">
템플릿 추가하기
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()— 대표이미지 설정
배너
verifyBannerUpload()— 업로드 확인
알려진 제약
isTrusted=false이벤트 무시 → OG/태그에 우회 로직 필요- 카테고리가 ARIA combobox → Playwright click 필요
- 대표이미지 셀렉터가 Tistory 업데이트마다 변경 가능
변경 이력
v4.0.0 (2026-03-07)
- 범용 스킬로 재설계: 매경 리뷰 전용 → 어떤 포맷이든 발행 가능
- 범용
publish.sh스크립트 추가 (--category,--blog등 인자) - 매경 리뷰를
templates/mk-review/예시로 이동 - 단순 발행 예시
templates/simple-post/추가
v3.0.0 (2026-03-07)
- OpenClaw Playwright → agent-browser 전환
- 카테고리: JS eval → Playwright native ARIA combobox click
- 배너: base64 chunk → agent-browser upload