AdsPower CLI: 명령줄에서 브라우저 관리를 자동화하세요

AdsPower는 독립형 CLI(명령줄 인터페이스) 도구를 공식 출시했습니다.

이전에는 AdsPower 데스크톱 인터페이스를 통해 클릭해야 했던 작업들을 이제 단 하나의 명령줄 명령어로 완료할 수 있습니다. 브라우저 프로필 생성 및 관리, 브라우저 실행 및 종료, 프록시 전환, 지문 갱신, 쿠키 검색, 캐시 정리, 그룹 관리, 태그 추가 등 모든 작업을 터미널에서 직접 수행할 수 있습니다.

CLI는 AdsPower 데스크톱 클라이언트와 독립적으로 실행됩니다. 메인 애플리케이션과 로컬 캐시, 브라우저 커널 또는 런타임 환경을 공유하지 않습니다.

설치 방법

설치 방법은 두 가지가 있습니다.

방법 1: npm을 통해 설치 (Node.js 사용자에게 권장)

npm install -g adspower-browser

설치 후에는 다음 명령어를 모두 사용할 수 있으며, 기능은 동일합니다: adspower-browser , adspower , ads

방법 2: 직접 설치

Windows에서:

Windows 사용자는 AdsPower 공식 다운로드 페이지 에서 CLI를 직접 설치할 수도 있습니다.

irm https://www.adspower.com/install.ps1 | iex

macOS에서:

curl -fsSL https://www.adspower.com/install.sh | bash

리눅스에서:

curl -fsSL https://www.adspower.com/install.sh | bash

명령이 성공적으로 실행되지 않으면 설치 프로그램을 로컬에 다운로드하여 수동으로 실행할 수 있습니다.

시작하는 방법

CLI를 시작하세요:

ads start -k <KEY>

이미 ADS_API_KEY 환경 변수를 구성했다면 다음 명령만 실행하면 됩니다. ads start

예시: 브라우저 프로필 열기:

ads open-browser <profile_id>

예시: 브라우저 프로필 닫기:

ads close-browser <profile_id>

단 세 가지 명령만으로 브라우저 인스턴스를 완벽하게 실행하고 관리할 수 있습니다.

일상 업무를 위한 빠른 참조

브라우저 프로필 관리

ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"}}'
ads update-browser '{"profile_id":"..."}'
ads delete-browser '{"profile_id":["..."]}'
ads get-browser-list '{}'

프록시 관리

ads create-proxy '[{"type":"http","host":"127.0.0.1","port":"8080"}]'
ads get-proxy-list '{}'
ads update-proxy '{"proxy_id":"proxy-1","proxy_url":"https://refresh.example.com"}'
ads delete-proxy '{"proxy_id":["..."]}'

지문, 쿠키 및 캐시

ads new-fingerprint <profile_id>
ads get-profile-cookies <profile_id>
ads delete-cache-v2 '{"profile_id":["..."],"type":["cookie","history"]}'
ads get-profile-ua <profile_id>

그룹 및 태그

ads create-group '{"group_name":"My Group"}'
ads get-group-list '{}'
ads create-tag '{"tags":[{"name":"test","color":"darkBlue"}]}'

브라우저 커널 관리

ads get-kernel-list '{"kernel_type":"Chrome"}'
ads download-kernel '{"kernel_type":"Chrome","kernel_version":"..."}'

`ads -h` 또는 `ads -h` 명령어를 사용하면 각 명령어의 전체 매개변수 목록을 볼 수 있습니다.

이것이 실제 비즈니스 운영에 어떻게 도움이 될까요?

다음은 AdsPower CLI를 사용하여 워크플로 효율성을 크게 향상시킬 수 있는 몇 가지 실제 사용 사례입니다.

대량 계정 생성

• 이전 방식: GUI에서 프로필을 하나씩 생성했습니다.
• 이후: 프록시 자동 할당 및 그룹 태깅 기능을 갖춘 프로필을 한 번에 50개 또는 100개 생성하는 반복 스크립트를 작성하세요.

정기 유지보수

지문 갱신, 캐시 정리 및 기타 유지 관리 작업을 이제 예약된 작업에 추가하여 매일 자동으로 실행할 수 있습니다.

수동 모니터링이 필요하지 않습니다. 모든 것이 서버 환경에서 직접 실행될 수 있습니다.

배치 작업

수백 개의 계정 에 대한 프록시를 업데이트해야 하시나요? 여러 프로필을 새 그룹으로 이동해야 하시나요? 지문을 일괄적으로 갱신해야 하시나요?

CLI를 사용하면 반복적인 수동 클릭 대신 단일 명령으로 대규모 계정 관리 작업을 완료할 수 있습니다.

서버 배포 및 Docker 지원

AdsPower CLI는 Docker 배포도 지원합니다.

docker-compose -f ./docker-compose.yml up -d
docker-compose exec adspower-cli /bin/bash

컨테이너 내부에 들어가면 사용자는 ads 명령어를 사용하여 브라우저 인스턴스를 직접 관리할 수 있습니다.

이를 통해 AdsPower는 그래픽 인터페이스 없이도 헤드리스 서버 환경에서 완벽하게 작동할 수 있습니다.

AI 통합: MCP 및 스킬

AI 코딩 도우미

CLI의 GitHub 저장소에는 AI 코딩 도우미를 위한 Skill 지원 기능이 포함되어 있습니다. Cursor 및 유사 도구에 한 번의 명령으로 설치하세요.

npx skills add AdsPower/adspower-browser

MCP(모델 컨텍스트 프로토콜) 지원

이 저장소는 MCP 지원 도 통합하여 Claude Code, Cursor, Codex 및 OpenCode와 같은 AI 에이전트가 AdsPower 브라우저 인스턴스를 직접 제어할 수 있도록 합니다.

설정이 완료되면 AI 어시스턴트는 AdsPower 컨텍스트를 자동으로 학습합니다. 자연어로 원하는 작업을 설명하면 AI가 해당 CLI 명령어를 생성해 줍니다. 명령줄 인터페이스에 익숙하지 않은 사용자에게 특히 유용합니다.

이것이 중요한 이유 : AI 에이전트가 워크플로에서 실행 역할을 더 많이 수행함에 따라 에이전트와 웹 상호 작용의 핵심 도구인 브라우저에도 이에 상응하는 통합 기능이 필요합니다. CLI, MCP 및 스킬은 모두 현재 사용 가능합니다.

원천:

1. GitHub 문서
2. AdsPower CLI를 여기에서 다운로드하고 설치하세요.