CLIAPI

터미널에서 예약하고 게시하세요

fopost는 FoPost 공식 CLI입니다. 따로 설치할 것 없는 단일 정적 바이너리로, 게시물 작성, 미디어 첨부, 연결된 모든 계정에 예약, 각 전송 상태 확인까지 셸, 스크립트, CI 작업에서 처리할 수 있습니다.

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

하나의 바이너리

macOS, Linux, Windows의 amd64와 arm64를 지원합니다. Homebrew, go install, 릴리스 아카이브로 설치하세요.

스크립트를 위한 설계

모든 명령이 --json을 지원하고, 오류는 stderr로 출력되며, 실패마다 고유한 종료 코드가 있습니다.

예고 없는 게시는 없습니다

--publish를 붙이거나 posts publish를 실행하거나 예약을 설정하기 전까지 게시물은 초안으로 남습니다.

게시물

명령 하나로 작성, 예약, 게시

posts create에 계정, 본문, 로컬 미디어 파일, 시간을 전달하세요. 파일은 미디어 라이브러리에 업로드되어 자동으로 첨부됩니다. 긴 본문은 파일이나 파이프로 가져올 수 있고, 프리플라이트가 전송 전에 모든 대상 네트워크 기준으로 게시물을 점검합니다.

게시물 명령 읽기
게시물
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

예약 또는 게시

시간을 주면 예약, --publish를 주면 즉시 전송, 아무것도 주지 않으면 초안으로 유지됩니다.

프리플라이트

게시 전에 어떤 계정이 준비되었고 어떤 계정이 막혔는지, 그 이유와 함께 확인하세요.

전송 상태

계정별 상태, 시도 횟수, 네트워크가 링크를 발급하면 실제 게시물 링크까지 확인할 수 있습니다.

스크립팅

JSON으로 출력, 종료 코드로 응답

어떤 명령에든 --json을 붙여 결과를 jq로 넘기세요. 401, 404, 속도 제한, 잘못된 요청은 각각 다른 코드로 종료되므로 텍스트를 파싱하지 않고도 스크립트가 구분할 수 있습니다. 재시도와 백오프는 모든 요청에서 내부적으로 처리됩니다.

스크립팅 가이드 읽기
확인이 필요한 계정
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

어디서나 --json

리소스 자체를 들여쓰기하여 stdout으로 출력합니다. 표는 사람을 위한 것입니다.

구분되는 종료 코드

잘못된 입력, 인증, 권한 범위, 찾을 수 없음, 속도 제한, 서버 오류 각각에 코드가 있습니다.

재시도 내장

속도 제한, 서버 오류, 네트워크 장애는 백오프와 함께 재시도됩니다.

CI

파이프라인에서 바로 게시

API 키를 시크릿으로 설정하고 워크스페이스를 지정하면 저장된 설정이 필요 없습니다. 릴리스 공지, 변경 내역 공유, 프리플라이트 실패 시 병합 차단까지 가능합니다. GitHub에는 같은 흐름을 감싼 공식 Action도 있습니다.

지금 시작하기
태그마다 릴리스 노트 게시
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

환경 변수에서 키 읽기

FOPOST_API_KEY를 자동으로 읽습니다. CI에서 로그인 단계가 필요 없습니다.

모든 CI 시스템 지원

GitHub Actions, GitLab CI, 셸을 실행할 수 있는 모든 환경에서 사용할 수 있습니다.

자동화와 웹훅

같은 도구에서 자동화를 실행하고 웹훅 구독을 관리하세요.

CLI에 대해 자주 묻는 질문

CLI는 어떻게 설치하나요?

brew install fopost/tap/fopost 또는 go install github.com/fopost/fopost-cli@latest를 실행하거나, GitHub 릴리스 페이지에서 사용 중인 플랫폼용 아카이브를 받아 fopost를 PATH에 추가하세요.

계정이 필요한가요?

네. CLI는 호스팅된 FoPost API와 통신하므로 대시보드의 설정, API 키에서 만드는 API 키가 필요합니다. fopost auth login으로 저장하거나 대신 FOPOST_API_KEY를 설정하세요.

API 키는 어디에 저장되나요?

사용자 설정 폴더에 본인만 읽을 수 있게 저장됩니다. CLI는 키를 다시 출력하지 않습니다. auth status는 가려진 접두사만 보여주며, 상세 출력에도 포함되지 않습니다.

무엇을 할 수 있나요?

게시물, 계정과 계정 상태, 워크스페이스, 미디어 업로드, 라벨, 분석, 자동화, 웹훅을 다룹니다. 모든 명령은 fopost --help 또는 CLI 문서에서 확인하세요.

오픈 소스인가요?

네. CLI는 MIT 라이선스이며 소스는 GitHub의 fopost/fopost-cli에 있습니다.

오늘 바로 CLI로 개발하세요

무료로 시작할 수 있고 전체 API가 포함돼요. 키를 만들고 몇 분 만에 첫 호출을 해 보세요.

API 키 받기