AdsPower CLI: Tarayıcı Yönetimini Komut Satırından Otomatikleştirin

AdsPower, resmi olarak bağımsız bir CLI (Komut Satırı Arayüzü) aracını kullanıma sundu.

Daha önce AdsPower masaüstü arayüzünde tıklama gerektiren görevler artık tek bir komut satırı talimatıyla tamamlanabiliyor. Tarayıcı profili oluşturma ve yönetme, tarayıcının başlatılması ve kapatılması, proksi değiştirme, parmak izi yenileme, çerezlerin alınması, önbellek temizleme, grup yönetimi ve etiketleme işlemleri doğrudan terminalden desteklenmektedir.

CLI, AdsPower masaüstü istemcisinden bağımsız çalışır. Ana uygulama ile yerel önbelleği, tarayıcı çekirdeklerini veya çalışma zamanı ortamlarını paylaşmaz.

Nasıl Kurulur

Mevcut iki kurulum yöntemi vardır.

Yöntem 1: npm ile Kurulum (Node.js Kullanıcıları İçin Önerilir)

npm install -g adspower-browser

Kurulumdan sonra, aşağıdaki komutların tümü kullanılabilir ve aynı işlevi görür: adspower-browser , adspower , ads

Yöntem 2: Doğrudan Kurulum

Windows'ta:

Windows kullanıcıları CLI'ı doğrudan resmi AdsPower indirme sayfasından da kurabilirler.

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

macOS'ta:

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

Linux'ta:

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

Komut başarıyla yürütülmezse, yükleyiciyi yerel olarak indirebilir ve manuel olarak çalıştırabilirsiniz.

Nasıl Başlanır

CLI'ı Başlatın:

ads start -k <KEY>

Eğer ADS_API_KEY ortam değişkenini zaten yapılandırdıysanız, sadece şunu çalıştırabilirsiniz: ads start

Örnek: Bir tarayıcı profili açma:

ads open-browser <profile_id>

Örnek: Bir tarayıcı profilini kapatma:

ads close-browser <profile_id>

Sadece üç komutla, bir tarayıcı örneği tamamen başlatılabilir ve yönetilebilir.

Günlük İşlemler İçin Hızlı Başvuru

Tarayıcı Profili Yönetimi

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 '{}'

Proksi Yönetimi

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":["..."]}'

Parmak İzleri, Çerezler ve Önbellek

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>

Gruplar ve Etiketler

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

Tarayıcı Çekirdeği (Kernel) Yönetimi

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

Her komut için tam parametre listesini şunları kullanarak görüntüleyebilirsiniz: ads -h

Gerçek İş Operasyonlarına Nasıl Yardımcı Olur?

AdsPower CLI'ın iş akışı verimliliğini önemli ölçüde artırabileceği birkaç pratik kullanım örneği aşağıda verilmiştir.

Toplu Hesap Oluşturma

• Eskiden: GUI'de profilleri tek tek oluşturmak gerekiyordu.
• Şimdi: Otomatik proksi ataması ve grup etiketleme ile aynı anda 50 veya 100 profil oluşturmak için bir döngü komut dosyası (script) yazın.

Zamanlanmış Bakım

Parmak izi yenilemeleri, önbellek temizleme ve diğer bakım görevleri artık zamanlanmış işlere eklenebilir ve her gün otomatik olarak yürütülebilir.

Manuel izleme gerekmez. Her şey doğrudan bir sunucu ortamında çalışabilir.

Toplu İşlemler

Yüzlerce hesap için proksileri güncellemeniz mi gerekiyor? Birden fazla profili yeni bir gruba mı taşıyacaksınız? Parmak izlerini toplu olarak mı yenileyeceksiniz?

CLI, tekrarlayan manuel tıklamalar yerine tek bir komutla büyük ölçekli hesap yönetimi görevlerini tamamlamayı mümkün kılar.

Sunucu Dağıtımı ve Docker Desteği

AdsPower CLI, Docker dağıtımını da destekler.

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

Kapsayıcının (container) içine girdikten sonra, kullanıcılar ads komutunu kullanarak tarayıcı örneklerini doğrudan yönetebilirler.

Bu, AdsPower'ın grafik arayüzü olmayan sunucu ortamlarında tamamen "headless" (başsız) çalışmasını sağlar.

Yapay Zeka (AI) Entegrasyonu: MCP ve Beceriler

AI Kodlama Asistanları

CLI'ın GitHub deposu, AI kodlama asistanları için "Skill" (Beceri) desteği içerir. Tek bir komutla Cursor ve benzeri araçlara kurun:

npx skills add AdsPower/adspower-browser

MCP (Model Bağlam Protokolü) Desteği

Depo ayrıca, Claude Code, Cursor, Codex ve OpenCode gibi AI ajanlarının AdsPower tarayıcı örneklerini doğrudan kontrol etmesini sağlayan MCP desteğini de entegre eder.

Kurulumdan sonra, AI asistanları otomatik olarak AdsPower bağlamı kazanır. Ne yapmak istediğinizi doğal dille tarif edin ve AI karşılık gelen CLI komutlarını üretsin; komut satırı arayüzlerine aşina olmayan kullanıcılar için mükemmeldir.

Neden Önemli: AI ajanları iş akışlarında daha fazla uygulama rolü üstlendikçe; ajan ve web etkileşimi için temel araç olan tarayıcının, buna karşılık gelen entegrasyon yeteneklerine ihtiyacı vardır. CLI, MCP ve Beceriler (Skills) artık kullanılabilir durumda.

Kaynaklar:

1. GitHub Dokümantasyonu
2. AdsPower CLI'ı buradan indirin ve kurun