스크립트에서 패널을 실행하세요.

설치

npm으로 CLI를 전역 설치하거나, npx로 필요할 때 실행해 설치를 건너뛰세요:

# install globally
npm i -g @socialgo/cli

# or run without installing
npx @socialgo/cli --help

설치하면 socialgo 명령이 여러분의 PATH에 자리합니다. socialgo --help를 실행하면 모든 명령과 플래그가 나열됩니다.

GitHub에서 소스 읽기

인증

CLI는 SOCIALGO_API_KEY 환경 변수에서 API 키를 읽습니다. 대시보드에서 키를 생성한 뒤, 셸이나 CI 시크릿에서 내보내세요:

# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"

# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"

키는 비밀번호처럼 다루세요. 버전 관리에서 제외하세요. 환경별 시크릿이나 절대 커밋하지 않는 .env 파일을 사용하세요.

명령

카탈로그 검색

키워드로 서비스를 찾으세요. 주문을 넣기 전에 서비스 id를 얻는 데 사용하세요. 읽기 전용이며 절대 지출하지 않습니다:

socialgo services search "instagram followers"

서비스 목록

사용 가능한 서비스의 전체 카탈로그를 출력하세요:

socialgo services list

주문 넣기

서비스 id, 대상 링크, 수량으로 주문하세요. 지출하는 유일한 명령입니다. 여러분이 호출할 때만 실행됩니다:

socialgo order create \
  --service <id> \
  --link <url> \
  --quantity 1000

주문 추적

id로 주문의 현재 상태를 조회하세요:

socialgo order status <id>

잔액 확인

계정에서 사용 가능한 잔액을 표시하세요:

socialgo balance

지갑

지갑 상세 정보와 최근 거래를 확인하세요:

socialgo wallet

관리자: 카탈로그 동기화

패널 운영자용: 연결된 공급업체에서 최신 서비스와 가격을 로컬 카탈로그로 가져옵니다. 관리자 키가 필요합니다:

socialgo admin sync-catalog

세 명령 루프

서비스를 찾고, 주문을 넣고, 추적하세요. 모든 스크립트와 에이전트가 실행하는 루프입니다:

# 1. find the service id
socialgo services search "instagram followers"

# 2. place the order
socialgo order create --service 1423 --link https://instagram.com/yourhandle --quantity 1000

# 3. track it
socialgo order status 90871

처음부터 끝까지 스크립트로

어떤 명령에든 --json을 전달해 jq로 파이프하세요. 여기서는 스크립트가 가장 저렴한 일치 서비스를 고른 뒤 주문합니다. 클릭 없이:

# pick the cheapest matching service, then order — with jq
id=$(socialgo services search "instagram followers" --json \
  | jq -r 'sort_by(.rate) | .[0].id')

socialgo order create --service "$id" \
  --link https://instagram.com/yourhandle --quantity 1000 --json

종료 코드 & JSON

모든 명령은 성공 시 0, 실패 시 비0 코드를 반환하므로, CI 파이프라인과 셸 스크립트에서 호출을 연결할 수 있습니다. 어떤 명령에든 --json을 전달하면 jq 같은 도구로 파이프하거나 에이전트에 바로 되먹일 수 있는 기계 판독 출력을 얻습니다.