네이버 오픈API(검색 13종, 데이터랩, 캡차)를 터미널에서 바로 쓸 수 있는 CLI를 만들었습니다.

기존에 네이버 API를 래핑한 MCP 서버는 몇 개 있지만, CLI는 없었습니다. MCP는 편리하지만 도구 스키마만으로 컨텍스트 윈도우의 상당 부분을 잡아먹고, TCP 타임아웃으로 실패율도 높습니다.

그래서 에이전트가 직접 호출할 수 있는 CLI를 만들었습니다.

주요 특징:

  • 블로그/뉴스/쇼핑/지역 등 13종 검색 + 데이터랩 트렌드 분석
  • --json 으로 API 파라미터 1:1 매핑, --fields로 필요한 필드만 반환
  • ncli schema search.blog 으로 런타임에 API 스펙 조회 (정적 문서 불필요)
  • --dry-run 으로 실행 전 검증, --sanitize 로 프롬프트 인젝션 방어
  • --page-all 자동 페이지네이션, stdin/파일 JSON 입력 지원
  • OpenClaw 표준 skill files 포함

설계 원칙은 Justin Poehnelt의 "You Need to Rewrite Your CLI for AI Agents" 글과 AXI 프로젝트를 참고해서, agentic-cli-guide로 정리한 7가지 원칙을 적용했습니다.

설치: npm install -g @kiyeonjeon21/ncli