Ankk CLI/API 개발자 가이드

빠른 시작

패키지, API 키, 브랜드 단위 발행 흐름이 맞는지 가장 짧게 확인하는 경로입니다.

설치하거나 한 번 실행

공개 패키지는 @anakonn/ankk이고 binary는 ankk입니다. 현재 CLI는 Bun을 필요로 합니다.

bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health

안전하게 설정

Ankk에서 발급한 API 키를 사용합니다. 출력에는 전체 키를 보여주지 않고, CI에서는 환경 변수를 사용할 수 있습니다.

ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --api-key-env ANKK_API_KEY --yes
ankk config show

준비한 콘텐츠 발행

JSON payload를 만들고 API 클라이언트와 같은 공개 예약 계약으로 넘깁니다.

ankk brand get --json
ankk contents publish --file payload.json
ankk contents publish --file payload.json --scheduled-for 2026-07-01T09:00:00Z

폼을 다시 만들지 말고 JSON을 넘기세요

Payload

콘텐츠 본문은 —file을 사용하세요. 스크립트와 AI 도구가 많은 flag 조합 없이 구조화된 payload를 만들 수 있습니다.

{
	"connection_id": "<connection_id>",
	"idempotency_key": "launch-thread-2026-07-01",
	"sns_type": "threads",
	"text": "Ankk 출시 소식",
	"scheduled_for": "2026-07-01T09:00:00Z"
}

고객 데이터가 들어간 임시 payload는 git 밖에 둡니다.
반복 자동화에는 idempotency key를 사용합니다.
accepted는 예약 접수이지 provider 성공이 아닙니다.

공개 API를 직접 호출할 수 있습니다

API

모든 CLI 흐름은 공개 /v1 API로 이어집니다. 자동화 클라이언트는 Bearer 인증과 브랜드 단위 route를 사용합니다.

curl -X POST https://api-public.ankk.app/v1/brand/contents 
  -H "Authorization: Bearer spk_..." 
  -H "Content-Type: application/json" 
  --data @payload.json

API 키에 바인딩된 브랜드는 GET /v1/brand로 확인합니다.
공개 계약은 /v1/docs와 /v1/openapi.json에서 확인합니다.
전체 API 키를 로그나 이슈에 붙여넣지 마세요.

접수 이후 상태를 추적하세요

Status

발행은 비동기입니다. API는 검증된 작업을 저장하고 예약하며, provider 완료는 이후 실행 흐름에서 일어납니다.

ankk contents list --json
ankk contents get --content-id <content_id> --json

accepted, queued, publishing, published, failed, retry 상태를 예상해야 합니다.
다른 시스템에 상태를 알려야 하면 서명된 웹훅을 사용합니다.
운영 상태는 AI 프롬프트가 아니라 Ankk에서 추적합니다.

AI 도구가 Ankk를 쓰게 하세요

AI 도구는 문구, payload, 명령을 준비하고 Ankk는 예약 발행과 상태 추적을 맡습니다.

Codex

이 릴리스 노트로 Threads 출시 payload를 만들고 tmp/launch-thread.json에 저장한 뒤, 설정된 브랜드로 ankk contents publish를 실행해줘.

Claude Code

payload.json에 connection_id, idempotency_key, sns_type, text, scheduled_for가 있는지 확인하고 실행할 ankk contents publish 명령을 보여줘.

ChatGPT

채널에 맞는 게시물 문구 3개를 만들고, ankk contents publish —file payload.json에 넘길 수 있는 JSON payload 하나를 반환해줘.

안전 경계

전체 spk_ API 키를 모델, 로그, 스크린샷, 이슈 코멘트에 노출하지 않습니다.
명령 성공이 provider 발행 성공을 의미한다고 설명하지 않습니다.
숨겨진 CLI 명령이나 검토 중인 기능을 공개 기능처럼 문서화하지 않습니다.
자동화는 직접 DB 접근이 아니라 API 키, 웹훅, 상태 확인을 사용합니다.

CLI, API, AI 도구에서 Ankk 사용하기