출처

개요

OfficeCLI는 Word, Excel, PowerPoint 파일을 AI 에이전트가 명령줄에서 읽고, 수정하고, 생성할 수 있도록 만든 오픈소스 도구입니다. 별도의 .NET 런타임이나 Microsoft Office 설치 없이 단일 바이너리로 실행되며, 모든 명령은 --json 옵션을 통해 구조화된 출력을 제공합니다. 내장 HTML 렌더링 엔진을 이용해 문서를 HTML이나 PNG로 변환할 수 있어, 에이전트가 결과물을 확인하고 수정하는 render → look → fix 작업 흐름을 구성할 수 있습니다. 문서 조작은 의미 단위 읽기, DOM 요소 수정, Raw XML 접근의 3계층으로 나뉘며, 필요할 때만 저수준 제어로 내려갑니다. Excel 수식 계산, 피벗 테이블, 템플릿 병합, 문서 덤프·재생, MCP 연동 등의 기능도 제공합니다.

핵심 포인트

  • .docx, .xlsx, .pptx를 하나의 officecli 명령 체계로 읽기·수정·생성할 수 있습니다.
  • view html, view screenshot, watch 기능으로 문서 레이아웃과 시각적 결과를 확인할 수 있습니다.
  • L1 읽기 계층, L2 DOM 계층, L3 Raw XML 계층으로 구성되어 간단한 작업부터 세밀한 OOXML 제어까지 지원합니다.
  • Excel에서 350개 이상의 함수와 동적 배열을 계산하고, 피벗 테이블을 생성할 수 있다고 설명합니다.
  • merge 명령으로 문서 내부의 {{key}} 자리표시자를 JSON 데이터로 치환할 수 있습니다.
  • dumpbatch를 사용해 기존 문서 구조를 JSON으로 추출한 뒤 다른 문서에 재생할 수 있습니다.
  • MCP 서버를 내장해 Claude Code, Cursor, VS Code/Copilot 등 AI 도구와 연결할 수 있으며 Apache License 2.0으로 공개되어 있습니다.

왜 중요한가

기존에는 Word, Excel, PowerPoint를 다루기 위해 형식별 Python 라이브러리를 별도로 사용하고, 결과물의 시각적 상태를 사람이 직접 확인해야 하는 경우가 많았습니다. OfficeCLI는 문서 조작과 렌더링 확인을 하나의 명령줄 인터페이스로 묶어, 화면이 없는 CI·Docker 환경에서도 에이전트가 문서를 만들고 검증하는 흐름을 구성하려는 접근을 제시합니다. 특히 템플릿 병합과 문서 덤프·재생 기능은 반복 보고서 생성이나 기존 문서 양식의 자동화에 활용될 수 있습니다. 다만 게시글의 기능 설명과 프로젝트 측 주장을 바탕으로 한 소개이므로, 실제 지원 범위와 렌더링 품질은 공식 문서와 직접 실행을 통해 확인할 필요가 있습니다.

후속으로 볼 링크 및 키워드

관련 위키

원문 보존 위치

원문 전체는 2026-07-25-pytorchkr-topic-11347-officecli-ai-word-excel-powerpointsource_url 및 HTML 원문과 함께 저장되어 있습니다.