sofq/confluence-cli

confluence-cli은(는) 무엇을 하나요?

개발자와 AI 에이전트를 위한 Confluence CLI — 구조화된 JSON 출력, jq 필터링, 배치 작업 및 워크플로 자동화. Jira의 OpenAPI 스펙을 기반으로 구축되었습니다.

설치

npm install -g @sofq/confluence-cli

또는

yarn global add @sofq/confluence-cli

설정

다음 환경 변수를 설정하세요:

• CONFLUENCE_BASE_URL - Confluence 인스턴스의 기본 URL (예: https://your-domain.atlassian.net/wiki)
• CONFLUENCE_USERNAME - 이메일 주소 또는 사용자 이름
• CONFLUENCE_API_TOKEN - API 토큰 (Atlassian 계정 설정에서 생성)

사용법

기본 명령어

confluence-cli get /rest/api/content?limit=1

구조화된 JSON 출력

confluence-cli get /rest/api/content/12345 | jq '.title'

페이지 목록 보기

confluence-cli get "/rest/api/content?spaceKey=DEV&limit=50"

특정 페이지 상세 조회

confluence-cli get "/rest/api/content/12345?expand=body.storage,version"

페이지 생성

confluence-cli post /rest/api/content -d '{
  "type": "page",
  "title": "새 페이지",
  "space": {"key": "DEV"},
  "body": {
    "storage": {
      "value": "<p>내용입니다</p>",
      "representation": "storage"
    }
  }
}'

고급 기능

jq 필터링

confluence-cli get /rest/api/content?spaceKey=DEV | jq '.results[] | {id, title, version}'

배치 작업

confluence-cli batch "/rest/api/content?spaceKey=DEV" --method delete --confirm

워크플로 자동화

confluence-cli run-workflow --space-key DEV --template "주간 보고서" --assignee "[email protected]"

API 참조

모든 엔드포인트는 Atlassian Confluence REST API 문서를 참조하세요.

지원 플랫폼

이 CLI는 Cursor, Claude Code, Codex와 같은 AI 에이전트 플랫폼과 호환됩니다.

라이선스

MIT