SocialGO

Được xây dựng cho máy

Chạy panel từ một script.

CLI biến mọi hành động SocialGO thành một lệnh mà bạn có thể pipe, lên lịch và giao cho một agent. Tìm trong danh mục, đặt đơn hàng, theo dõi chúng và kiểm tra số dư, từ terminal, một pipeline CI hay một bot.

Bạn xây gì trên nó

Một giao diện lệnh. Script, pipeline và agent.

Cùng những lệnh mà bảng điều khiển chạy trên đó. Được phơi bày cho code. Ghép chúng vào một script shell, một bước CI hay một agent tự chủ. Mọi lệnh trả về một mã thoát sạch và JSON máy đọc được.

Script

Nối chuỗi các lệnh trong một script shell: tìm một dịch vụ, đặt đơn hàng, kiểm tra trạng thái. Truyền --json và phân tích đầu ra bằng jq.

Pipeline

Đưa CLI vào một bước CI hoặc một cron job. Nó thoát 0 khi thành công và khác-0 khi thất bại, nên pipeline của bạn dừng khi một đơn hàng dừng.

Agent

Giao các lệnh cho một agent AI. Nó đọc danh mục, xác nhận đơn giá và số lượng, rồi đặt đơn hàng, chính là những lệnh gọi bạn sẽ tự gõ.

Việc chi tiền là tường minh. Tìm và liệt kê chỉ đọc; một đơn hàng chỉ xảy ra khi bạn chạy order create với một dịch vụ, liên kết và số lượng, trong một script hay bằng tay. CLI không bao giờ tự chi tiền.

Cài đặt

Cài đặt CLI toàn cục bằng npm, hoặc chạy nó khi cần với npx và bỏ qua bước cài:

# install globally
npm i -g @socialgo/cli

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

Sau khi cài, lệnh socialgo nằm trên PATH của bạn. Chạy socialgo --help để liệt kê mọi lệnh và cờ.

Đọc mã nguồn trên GitHub

Xác thực

CLI đọc một API key từ biến môi trường SOCIALGO_API_KEY. Tạo một key trong bảng điều khiển của bạn, rồi export nó trong shell hoặc secrets CI của bạn:

# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"

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

Hãy coi key như một mật khẩu. Giữ nó ngoài kiểm soát phiên bản. Dùng secrets theo từng môi trường hoặc một file .env mà bạn không bao giờ commit.

Lệnh

Tìm trong danh mục

Tìm dịch vụ theo từ khóa. Dùng nó để lấy mã id dịch vụ trước khi đặt đơn hàng. Chỉ đọc, không bao giờ chi tiền:

socialgo services search "instagram followers"

Liệt kê dịch vụ

In toàn bộ danh mục các dịch vụ có sẵn:

socialgo services list

Đặt một đơn hàng

Đặt theo mã id dịch vụ, liên kết đích và số lượng. Đây là lệnh duy nhất chi tiền. Nó chỉ chạy khi bạn gọi:

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

Theo dõi một đơn hàng

Tra cứu trạng thái hiện tại của một đơn hàng theo mã của nó:

socialgo order status <id>

Kiểm tra số dư

Hiển thị số dư khả dụng trên tài khoản của bạn:

socialgo balance

Xem chi tiết ví và các giao dịch gần đây:

socialgo wallet

Quản trị: đồng bộ danh mục

Dành cho người vận hành panel: kéo các dịch vụ và giá mới nhất từ nhà cung cấp đã kết nối vào danh mục cục bộ. Yêu cầu một key quản trị:

socialgo admin sync-catalog

Vòng lặp ba lệnh

Tìm một dịch vụ, đặt đơn hàng, theo dõi nó. Vòng lặp mà mọi script và agent chạy:

# 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

Viết script từ đầu đến cuối

Truyền --json cho bất kỳ lệnh nào và pipe nó vào jq. Ở đây script chọn dịch vụ phù hợp rẻ nhất, rồi đặt nó, không cần nhấp chuột:

# 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

Mã thoát & JSON

Mọi lệnh trả về 0 khi thành công và một mã khác-0 khi thất bại, nên bạn có thể nối chuỗi các lệnh gọi trong pipeline CI và script shell. Truyền --json cho bất kỳ lệnh nào để có đầu ra máy đọc được, pipe vào các công cụ như jq, hoặc đưa thẳng trở lại cho một agent.