1. Başlangıç ve Kurulum
openclaw --version
Yüklü OpenClaw CLI sürümünü kontrol eder.
Sisteminizde OpenClaw'ın doğru şekilde kurulu olup olmadığını hızlıca doğrulayın.
openclaw init
Yeni bir OpenClaw projesi başlatır ve gerekli dosya yapısını oluşturur.
Yeni bir kazıma görevine başlamadan önce projenizi organize etmek için kullanışlıdır.
openclaw login
OpenClaw hesabınıza giriş yapar. Bu, bulut tabanlı özellikler için gereklidir.
API anahtarınızı veya kimlik bilgilerinizi güvenli bir şekilde yönetmek için kullanılır.
openclaw update
OpenClaw CLI aracını en son sürüme günceller.
En yeni özelliklere ve güvenlik yamalarına erişmek için düzenli olarak güncelleyin.
2. Temel Veri Çekme
openclaw scrape
Belirtilen URL'deki tüm görünür içeriği çeker ve varsayılan olarak JSON formatında çıktı verir.
Sayfanın genel yapısını ve içeriğini hızlıca anlamak için idealdir.
openclaw extract --selector "h1.title"
Belirtilen CSS seçiciye uyan öğeleri URL'den çeker.
Belirli başlıkları, paragrafları veya diğer HTML öğelerini hedeflemek için kullanılır.
openclaw get --xpath "//div[@id='content']/p[1]"
XPath ifadesi kullanarak URL'den veri çeker. XPath, daha karmaşık seçimler için güçlüdür.
CSS seçicilerin yetersiz kaldığı durumlarda, özellikle iç içe veya konumsal seçimler için tercih edilir.
openclaw list --selector "a" --attribute "href"
Belirli bir seçiciye uyan öğelerin belirli bir özniteliğini (örn. tüm bağlantıların 'href' değeri) listeler.
Bir sayfadaki tüm resim URL'lerini veya bağlantıları toplamak için çok etkilidir.
3. Gelişmiş Filtreleme ve Seçiciler
openclaw extract --selector "div.item" --filter "text().includes('indirim')"
Belirli bir seçiciye uyan ve metin içeriği belirli bir ifadeyi içeren öğeleri çeker.
Özel bir anahtar kelime içeren ürünleri veya haber başlıklarını filtrelemek için kullanışlıdır.
openclaw extract --selector "img" --attribute "src" --unique
Seçilen öğelerin belirtilen özniteliğinin tüm benzersiz değerlerini çeker.
Yinelenen verileri önlemek ve sadece farklı resim URL'lerini elde etmek için harika bir yoldur.
openclaw extract --selector "table tr" --nth-child 2
Belirli bir seçiciye uyan öğeler arasından N'inci alt öğeyi (örn. tablonun ikinci satırı) çeker.
Tablolardan veya listelerden belirli bir konuma sahip öğeleri hedeflemek için idealdir.
openclaw scrape --exclude-selector ".ad-banner"
Veri çekimi sırasında belirli bir seçiciye uyan öğeleri hariç tutar.
Reklamlar veya gereksiz sayfa bölümleri gibi istenmeyen içerikleri çekimden çıkarmak için kullanılır.
4. Etkileşim ve Otomasyon
openclaw browse --click "button.next-page"
Belirtilen URL'ye gider ve ardından belirli bir butona tıklar, sayfa etkileşimini simüle eder.
Sayfalar arasında gezinmek veya AJAX ile yüklenen içerikleri tetiklemek için kullanılır.
openclaw fill --form "#login-form" --data '{"username": "user", "password": "pass"}'
Belirtilen form seçicisini bulur ve JSON formatındaki verilerle doldurur.
Giriş yapma, arama formlarını doldurma veya diğer form tabanlı etkileşimler için idealdir.
openclaw scroll --to "bottom"
Belirtilen URL'ye gider ve sayfayı belirli bir konuma (örn. en alta) kaydırır.
Dinamik olarak yüklenen (sonsuz kaydırma) içerikleri çekmek için gereklidir.
openclaw wait --for-selector ".loaded-content"
Belirtilen URL'ye gider ve belirli bir CSS seçicisinin sayfada görünmesini bekler.
JavaScript ile yüklenen içeriklerin tamamen görünür olmasını sağlamak için senkronizasyon sağlar.
5. Veri Çıkışı ve Formatlama
openclaw scrape --output "data.json"
Çekilen veriyi belirtilen dosyaya JSON formatında kaydeder.
Yapılandırılmış verileri depolamanın ve diğer uygulamalarla entegre etmenin standart yoludur.
openclaw extract --selector "h2" --format "csv"
Çekilen veriyi CSV (Virgülle Ayrılmış Değerler) formatında konsola veya bir dosyaya çıktı verir.
Verileri elektronik tablolar veya basit veritabanları için uygun hale getirir.
openclaw scrape --output "data.xlsx"
Çekilen veriyi Microsoft Excel (XLSX) formatında bir dosyaya kaydeder.
Verileri doğrudan Excel'de analiz etmek veya paylaşmak için mükemmeldir.
openclaw scrape --pretty-print
Çekilen JSON çıktısını daha okunabilir, girintili bir formatta gösterir.
Konsolda büyük JSON çıktılarını incelerken anlaşılırlığı artırır.
6. Hata Ayıklama ve Optimizasyon
openclaw debug --selector "div.problem"
Belirli bir URL ve seçici için hata ayıklama bilgilerini sağlar, seçicinin neden çalışmadığını analiz eder.
Seçicilerinizin neden beklediğiniz öğeleri bulamadığını anlamak için çok değerlidir.
openclaw dry-run --scrape
Bir kazıma işlemini fiilen veri kaydetmeden veya kalıcı değişiklik yapmadan simüle eder.
Kazıma komutlarınızın beklenen şekilde çalışıp çalışmadığını test etmek için güvenli bir yoldur.
openclaw profile --extract "div.content"
Belirli bir URL ve çekme işlemi için performans metriklerini analiz eder.
Kazıma görevlerinizin hızını ve verimliliğini optimize etmek için darboğazları belirleyin.
openclaw config set --proxy "http://myproxy:8080"
OpenClaw CLI için global veya projeye özel yapılandırma ayarlarını yapar, örneğin proxy ayarları.
IP engellemelerinden kaçınmak ve coğrafi kısıtlamaları aşmak için proxy'leri yapılandırın.