CLI

문서 버전: 20261024

macOS / Windows 데스크톱에서 사용할 수 있습니다. iOS와 Android에는 이 명령이 없습니다. 사용하기 전에 ApiCatcher를 여세요.

CLI를 쓰면 AI가 ApiCatcher에 이미 있는 기능을 호출할 수 있습니다. HTTP 요청 검색과 분석, 스크립트와 재작성 규칙 관리가 여기에 해당합니다.

명령 위치

시스템 터미널에서 실행합니다. macOS는 「터미널」, Windows는 「명령 프롬프트」 또는 PowerShell입니다.

macOS에서는 설치한 앱 안에 명령이 있습니다.

/Applications/ApiCatcher.app/Contents/MacOS/apicatcher-cli tools

ApiCatcher가 「응용 프로그램」 폴더에 없으면 /Applications/ApiCatcher.app을 실제 ApiCatcher.app 위치로 바꾸세요.

지금 연 터미널 창에만 짧은 이름을 붙여 두면, 이후에는 apicatcher라고 입력할 수 있습니다.

alias apicatcher="/Applications/ApiCatcher.app/Contents/MacOS/apicatcher-cli"

Windows에서는 ApiCatcher를 설치한 폴더의 apicatcher-cli.exe를 실행합니다. 기본 위치는 다음과 같습니다.

%LOCALAPPDATA%\Programs\ApiCatcher\apicatcher-cli.exe tools

바탕화면의 ApiCatcher 아이콘은 창을 여는 프로그램이며, 이 명령이 아닙니다.

아래 예시는 apicatcher로 적었습니다. 컴퓨터에 있는 실제 경로로 바꾸세요.

앱을 열고 CLI를 켜야 합니다

CLI는 기본으로 꺼져 있으며 포트를 쓰지 않습니다. 명령을 쓰려면:

1. ApiCatcher를 엽니다.
2. 사이드바의 CLI를 열고 스위치를 켭니다.
3. 앱을 완전히 종료한 뒤 다시 엽니다. 이번 실행부터 이 컴퓨터에서 명령을 받습니다.

스위치를 꺼도 멈추는 것은 다음 실행부터입니다.

앱이 꺼져 있거나, 스위치가 꺼져 있거나, 스위치를 바꾼 뒤 다시 시작하지 않았으면 명령은 실패합니다.

명령

현재 버전의 도구와 인자를 봅니다. 파라미터는 이 출력을 기준으로 합니다.

apicatcher tools

도구를 하나 호출합니다. --args는 JSON 객체입니다.

apicatcher call search_requests --args '{"host":"api.example.com","limit":10}'

표준 입력으로도 전달할 수 있습니다.

printf '%s' '{"host":"api.example.com"}' | apicatcher call search_requests

--args가 없고 표준 입력이 터미널이면 인자는 {}입니다.

apicatcher call get_capture_status

출력

표준 출력은 JSON 객체 하나입니다. 성공 여부는 ok로 봅니다. 도구 결과가 JSON이면 result에 넣고, 그렇지 않으면 문자열로 둡니다.

{"ok":false,"error":"ApiCatcher is not running"}

search_requests의 자주 쓰는 인자는 keyword, search_target(url, host, req_header, resp_header, req_body, resp_body), method, host, status_code, file_type, session_id, limit, skip입니다.

보안

• 명령은 이 컴퓨터에서만 동작하며, 같은 네트워크의 다른 기기에서는 연결할 수 없습니다.
• 출력은 실제 캡처 내용이며 쿠키, 토큰, 본문이 들어 있을 수 있습니다. 공개된 곳에 붙이지 마세요.