tistory-publish

# Tistory Publish

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

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

## 전제 조건

- [agent-browser](https://github.com/anthropics/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
# 가장 단순한 발행
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` | | 비공개 발행 |

## 자동 처리 항목

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

1. 새 글 페이지 열기
2. JS 헬퍼 함수 주입
3. 카테고리 선택 (ARIA combobox → Playwright click)
4. 제목 입력 (base64 디코딩으로 한글 처리)
5. 본문 HTML 삽입
6. 배너 이미지 업로드 (첨부→사진 메뉴 → file input)
7. OG 카드 생성 (placeholder URL → Enter 키 → 카드 렌더링)
8. 대...

# tistory-publish

티스토리 블로그 범용 자동 발행 스킬. agent-browser(Playwright CLI)로 TinyMCE 에디터를 조작해 어떤 형식의 글이든 자동 발행합니다.

## 왜 브라우저 자동화?

티스토리 Open API가 2024년 2월에 종료됐습니다. 공식 API 없이 발행하려면 브라우저를 직접 제어하는 수밖에 없습니다.

## 빠른 시작

```bash
# 설치
clawhub install tistory-publish

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

## 기능

- **본문 삽입**: HTML → TinyMCE 에디터 (`data-ke-*` 속성 지원)
- **OG 카드**: URL placeholder → 자동 카드 렌더링 (`isTrusted` 우회)
- **배너/이미지**: 파일 업로드 → 대표이미지 자동 설정
- **카테고리**: ARIA combobox 자동 선택
- **태그**: nativeSetter 패턴으로 `isTrusted` 필터링 우회
- **공개/비공개**: `--private` 플래그로 제어

## 구조

```
scripts/
├── tistory-publish.js    # 코어 — 에디터 조작 함수 모음
└── publish.sh            # 범용 발행 스크립트

templates/
├── mk-review/            # 예시: 신문 리뷰 (배너+OG 카드)
│   ├── RUNBOOK.md
│   ├── TEMPLATE.md
│   └── banner.js
└── simple-post/           # 예시: 단순 글 발행
    └── RUNBOOK.md
```

## 발행 옵션

| 옵션 | 필수 | 설명 |
|------|------|------|
| `--title` | ✅ | 글 제목 |
| `--body-file` | ✅ | 본문 HTML 파일 경로 |
| `--category` | ✅ | 카테고리 이름 |
| `--tags` | | 쉼표 구분 태그 |
| `--banner` | | 배너 이미지 경로 |
| `--blog` | | 블로그 도메인 |
| `--private` | | 비공개 발행 |

## 기술 스택

- **브라우저**: [agent-browser](https://github.com/anthropics/agent-browser) (Playwright CLI)
- **에디터**: TinyMCE DOM API, `execCommand`, nativeSetter
- **배너 생성**: Node.js Canvas (`@napi-rs/canvas`, 선택)
- **OG 카드**: JS(URL 준비) + Playwright(Enter 키) 조합
- **태그**: nativeSetter + InputEvent + KeyboardEvent

## 나만의 템플릿 만들기

`templates/` 안에 폴더를 추가하면 됩니다:

```
templates/my-template/
├── RUNBOOK.md       # 발행 순서
├── TEMPLATE.md      # 원고 작성 가이드
└── banner.js...