준비 중인 채널

Ghost

포샌디로 AI가 Ghost 블로그에 올리게 될 방법이에요. 통합 키 연결, 사진이 들어간 마크다운, 초안과 수정을 정리했어요.

준비 중인 채널이에요. 아래는 연결이 열리면 쓰게 될 방법이에요. 열리면 블로그와 이 페이지에 알려드려요.

연결 방법: 내 Ghost 사이트로

플랫폼 심사 없이 내 Ghost 사이트를 연결하게 돼요.

Ghost 관리 화면에서 설정 > 통합으로 가요.
커스텀 통합을 하나 만들어요.
그 통합에 보이는 API URL과 Admin API 키를 대시보드에 붙여넣어요.

Ghost 종류	연결
Ghost(Pro) Starter 플랜	안 됨 (커스텀 통합이 없어요)
Ghost(Pro) Publisher 이상	됨
직접 설치한 Ghost 5.68 이상	됨

한눈에

항목	종류	값
글자 수	텍스트	30,000
이미지	미디어	글 하나에 40장까지. 더 넣으면 앞의 40장만 올라가고 경고가 붙어요
캐러셀	미디어	없음. 이미지는 본문에 차례로 들어가요
영상	미디어	안 됨
텍스트만	미디어	가능
24시간 발행	한도	1,000
24시간 삭제	한도	Admin API로 처리, 하루 한도와 기간 제한은 공개된 값 없음
상태	상태	준비 중

연결이 열리면 서버가 이 값으로 검사하게 돼요. 제목은 필수이고 코드포인트로 세요. 미디어는 사진만 올라가요.

본문이 Ghost로 가는 방식

본문은 마크다운이고, Ghost가 쓴 그대로 그려요.

사진은 한 줄에 하나씩, 아래 형식으로 넣어요. 포샌디가 그 사진을 Ghost 사이트로 복사하게 돼요.
@group이나 {.small} 같은 네이버 블로그 전용 문법은 거절해요.

![사진 설명](media:med_...)

첫 글 올리기

마크다운 본문과 options.ghost.title을 넣어 publish를 부르게 돼요. Ghost에 초안으로만 두려면 options.ghost.draftOnly를 더해요.

curl -X POST https://api.posendy.com/v1/posts \
  -H "Authorization: Bearer $POSENDY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Intro.\n\n![Cover](media:med_...)",
    "accountIds": ["conn_..."],
    "options": { "ghost": { "title": "Release notes", "tags": ["news"] } }
  }'

options.ghost 값

이름	타입	설명
`title` (필수)	string	필수. 글 제목이에요. 255자까지.
`tags`	string[]	태그 이름이에요. 없는 태그는 Ghost가 새로 만들어요. `#`으로 시작하는 이름은 거절해요(Ghost가 숨김 내부 태그로 만들어 버려요). 수정할 때 빼면 지금 태그를 그대로 둬요.
`featureImageMediaId`	string	대표 이미지로 쓸 JPEG, PNG, GIF, WebP의 미디어 id예요. 포샌디가 복사본을 Ghost에 올려요. 수정할 때 빼면 지금 이미지를 그대로 둬요.
`draftOnly`	boolean	발행하지 않고 Ghost 초안으로 저장해요. 이때 글 주소는 Ghost 에디터 페이지예요. 글을 포샌디에 두는 글의 `draft`와는 달라요.
`content`	string	이 채널에만 보낼 본문이에요. 넣으면 공통 본문 대신 이 값이 나가고, 글자 수와 미디어 검사도 이 값으로 해요. 안 넣으면 공통 본문을 써요.

연결이 열리면 GET /v1/platforms도 같은 내용을 돌려주게 돼요.

안 되는 것

뉴스레터 메일: 포샌디는 메일을 보내지 않아요. 글은 사이트에만 올라가요.
회원 전용 글, 영상, 댓글, 조회수: 지원하지 않아요.

update_post는 글을 같은 자리에서 다시 써요. 보내지 않은 태그와 대표 이미지는 그대로 둬요.

자주 묻는 것

글쓴이는 누구로 나오나요?

통합 키로 올린 글은 Ghost가 사이트 소유자를 글쓴이로 정해요. 스태프 액세스 토큰을 쓰면 그 토큰 주인 이름으로 올라가요.

연결할 때 API URL이 틀렸다고 나와요

공개 사이트 주소가 아니라, 커스텀 통합 화면에 보이는 API URL을 넣어요. Ghost(Pro)는 사이트가 자기 도메인을 써도 API URL은 .ghost.io로 끝나요.

다른 사람이 Ghost에서 같은 글을 고치고 있으면요?

포샌디가 글을 한 번 다시 읽고 다시 써요. 그래도 누가 고치는 중이면 update_post는 덮어쓰지 않고 ghost_update_collision으로 실패해요.

이전Discord 다음발행