설치하거나 한 번 실행
공개 패키지는 @anakonn/ankk이고 binary는 ankk입니다. 현재 CLI는 Bun을 필요로 합니다.
bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health
Developers
CLI, API, AI 도구에서 Ankk 사용하기
Bun 기반 CLI를 설치하고 공개 API 키를 설정한 뒤, Codex, Claude Code, ChatGPT, 스크립트, 자동화 도구에서 준비한 콘텐츠를 Ankk 예약 발행으로 넘깁니다.
terminal
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --brand-ref acme --file payload.json
빠른 시작
패키지, API 키, 브랜드 단위 발행 흐름이 맞는지 가장 짧게 확인하는 경로입니다.
안전하게 설정
Ankk에서 발급한 API 키를 사용합니다. 출력에는 전체 키를 보여주지 않고, CI에서는 환경 변수를 사용할 수 있습니다.
ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --brand-ref <brand_ref> --api-key-env ANKK_API_KEY --yes
ankk config show
준비한 콘텐츠 발행
JSON payload를 만들고 API 클라이언트와 같은 공개 예약 계약으로 넘깁니다.
ankk brands list --json
ankk contents publish --brand-ref <brand_ref> --file payload.json
ankk contents publish --brand-ref <brand_ref> --file payload.json --scheduled-for 2026-07-01T09:00:00Z
Payload
폼을 다시 만들지 말고 JSON을 넘기세요
콘텐츠 본문은 --file을 사용하세요. 스크립트와 AI 도구가 많은 flag 조합 없이 구조화된 payload를 만들 수 있습니다.
- 고객 데이터가 들어간 임시 payload는 git 밖에 둡니다.
- 반복 자동화에는 idempotency key를 사용합니다.
- accepted는 예약 접수이지 provider 성공이 아닙니다.
{
"connection_id": "<connection_id>",
"idempotency_key": "launch-thread-2026-07-01",
"sns_type": "threads",
"text": "Ankk 출시 소식",
"scheduled_for": "2026-07-01T09:00:00Z"
}
API
공개 API를 직접 호출할 수 있습니다
모든 CLI 흐름은 공개 /v1 API로 이어집니다. 자동화 클라이언트는 Bearer 인증과 브랜드 단위 route를 사용합니다.
- 접근 가능한 브랜드는 GET /v1/brands로 확인합니다.
- 공개 계약은 /v1/docs와 /v1/openapi.json에서 확인합니다.
- 전체 API 키를 로그나 이슈에 붙여넣지 마세요.
curl -X POST https://api-public.ankk.app/v1/brands/<brand_ref>/contents \
-H "Authorization: Bearer spk_..." \
-H "Content-Type: application/json" \
--data @payload.json
Status
접수 이후 상태를 추적하세요
발행은 비동기입니다. API는 검증된 작업을 저장하고 예약하며, provider 완료는 이후 실행 흐름에서 일어납니다.
- accepted, queued, publishing, published, failed, retry 상태를 예상해야 합니다.
- 다른 시스템에 상태를 알려야 하면 서명된 웹훅을 사용합니다.
- 운영 상태는 AI 프롬프트가 아니라 Ankk에서 추적합니다.
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json
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 키, 웹훅, 상태 확인을 사용합니다.