naverworks

네이버웍스(NAVER WORKS) REST API v1.0용 CLI 도구

naverworks는 프로필 기반 인증(OAuth 2.0, JWT Service Account), 자동 토큰 갱신, JSON/테이블 출력, 페이지네이션 순회를 지원하는 NAVER WORKS CLI입니다.

핵심 기능

• 인증: auth setup, auth login, auth refresh, auth status, auth logout
• 설정/프로필: config set|get|list, --profile, NW_PROFILE
• 주요 도메인: bot, calendar, directory, drive, mail, approval, task, board, contact, attendance, audit, monitoring, scim
• 출력: pretty JSON 기본 출력, 일부 목록형 명령의 --output table
• 페이지네이션: --count, --cursor, --all

설치

npm

npm install -g naverworks

npx

npx naverworks version

설치 스크립트

curl -sSL https://raw.githubusercontent.com/physics91/naverworks-cli/main/install.sh | sh

기본 설치 경로는 /usr/local/bin이며, INSTALL_DIR로 변경할 수 있습니다.

추가 설치 방법과 플랫폼별 바이너리 정보는 Installation 문서를 보면 됩니다.

30초 시작

# 대화형 설정
naverworks auth setup

# 로그인
naverworks auth login

# 상태 확인
naverworks auth status

# 첫 API 호출
naverworks directory list-users --count 20

바로 다른 도메인도 써먹을 수 있습니다.

naverworks bot send --to USER_ID --text "배포 완료"
naverworks drive list --user-id me
naverworks mail send --user-id me --to user@example.com --subject "배포 완료" --body "운영 반영 끝"

문서

• User Guide Home
• Installation
• Quick Start
• Authentication and Profiles
• Configuration Keys and Environment Variables
• Output and Pagination
• Domain Command Guide
• SCIM
• Troubleshooting
• Releases

상세 문서는 GitHub wiki에서 읽고, 원본은 docs/wiki/에서 관리합니다.

전체 명령은 아래처럼 확인할 수 있습니다.

naverworks --help
naverworks <command> --help

개발 검증

빠른 회귀 확인과 전체 검증을 분리해서 돌릴 수 있습니다.

make test-fast   # 핵심 unit/contract + meta + 대표 journey
make test-full   # 전체 테스트 스위트
make build
go vet ./...

라이선스

MIT