BotreamDokümanlar Web sitesi English v0.1.1

Web komutları

browser · capture

browser Browser

Tarayıcı oturumlarını yönetir.

İşlemler (--action)

--action:open
ParametreDeğerVarsayılanAçıklama
--urlmetin
--browserşunlardan biri: default, chrome, edge, firefoxdefaultAçılacak tarayıcı; 'default' ajan makinesinin varsayılan tarayıcısını kullanır
--headlesstrue / falsefalse
--outputdeğişken adıBu tarayıcı için değişken; diğer web komutları onu --browser:$name$ ile hedefler
--action:navigate
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--url zorunlumetin
--action:scroll

Fare tekerleğini kullanıcının yapacağı gibi sayfanın ortasında çevirir (kaydırıldıkça daha fazla içerik yükleyen sayfalar da tepki verir).

ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--amount zorunlusayıTekerlek adımları: pozitif yukarı, negatif aşağı kaydırır (bir adım yaklaşık 100 piksel)
--action:close
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--action:refresh
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--action:back
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--action:forward
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--action:screenshot
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--screenshot zorunlumetinEkran görüntüsü dosya yolu Ajan makinesindeki bir dosya.
--action:getcurrenturl
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--output zorunludeğişken adıSonucu alan değişken
--action:gettitle
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--output zorunludeğişken adıSonucu alan değişken
--action:executejs
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--script zorunlumetin
--outputdeğişken adıSonucu alan değişken
--action:newtab

Tarayıcıda yeni bir sekme açar; sonraki komutlar bu sekmede çalışır.

ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--urlmetin
--action:switchtab

Komutların çalışacağı sekme olarak tarayıcının başka bir sekmesini (veya açılır penceresini) seçer; bundan sonra --browser:$variable$ o sekme anlamına gelir.

ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--titlemetinSekmenin başlığı (joker karakterler: *Invoice*)
--urlmetinSekmenin adresi (joker karakterler: *orders/new*); başlıkla birlikte veya başlık yerine kullanılır
--timeoutsayı30Saniye cinsinden zaman aşımı
--action:closetab

Geçerli sekmeyi kapatır; önceki sekme geçerli olur.

ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--action:gettabs

Tarayıcının sekmeleri, kayıt olarak (Title, Url, IsCurrent).

ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--output zorunludeğişken adıSonucu alan değişken
--action:ondialog

Sayfaların alert, confirm ve prompt iletişim kutularının bundan sonra nasıl yanıtlanacağı. Bu komut olmadan kapatılırlar (Cancel).

ParametreDeğerVarsayılanAçıklama
--accepttrue / falsetruetrue OK, false Cancel yanıtı verir
--textmetinprompt iletişim kutularına yazılan metin
--action:getlastdialog

Bir sayfanın gösterdiği son iletişim kutusunun mesajı.

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:getcookies

Tarayıcının çerezleri, kayıt olarak (Name, Value, Domain, Path, Expires).

ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--output zorunludeğişken adıSonucu alan değişken
--action:setcookie
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--name zorunlumetin
--value zorunlumetin
--domainmetinÇerezin ait olduğu site; boşsa geçerli sayfanın sitesi
--pathmetin/
--action:clearcookies
ParametreDeğerVarsayılanAçıklama
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)

Örnekler

browser --action:open --url:"https://example.com" --output:session
browser --action:navigate --url:"https://other.com"
browser --action:close
browser --action:open --url:"https://shop.example.com" --output:shop
browser --action:open --url:"https://erp.local" --output:erp
capture --browser:$shop$ --action:gettext --dompath:"#price" --output:price
capture --browser:$erp$ --action:settext --dompath:"#amount" --value:$price$
browser --browser:$shop$ --action:close
browser --action:newtab --url:"https://example.com/orders"
browser --browser:$shop$ --action:switchtab --title:"*Invoice*" --timeout:10
browser --action:switchtab --url:"*orders/new*"
browser --action:closetab
browser --action:gettabs --output:tabs
browser --action:ondialog --accept:true --text:"duplicate order"
browser --action:getlastdialog --output:message
browser --action:setcookie --name:session --value:$token$ --domain:"example.com"
browser --action:getcookies --output:cookies
browser --action:clearcookies

capture Capture

Bir web sayfası elementiyle etkileşim kurar.

Tüm türlerde geçerli parametreler

ParametreDeğerVarsayılanAçıklama
--window$değişken$Başlığa göre tarayıcı penceresi (bir set --type:window değişkeni); --browser verilmediğinde kullanılır
--browser$değişken$browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa)
--dompath zorunlumetinXPath veya CSS seçici
--framemetinElementin bulunduğu iframe'in seçicisi, ör. #payment; iç içe çerçeveler outer >> inner şeklinde. Boşsa sayfanın kendisi
--propertiesmetinYakalanan elementin nesne özellikleri. İşaretli her özellik eşleşmelidir; seçici bunlardan oluşturulur
--anchormetinYakında bulunan ve değişmeyen bir elementin (etiket, başlık) seçicisi; --dompath için birden çok eşleşme varsa ona en yakın olan kullanılır
--anchorpositionşunlardan biri: near, right, left, below, abovenearElementin çapaya göre konumu: o taraftaki en yakın eşleşme kullanılır
--fallbackmetinİlki hiçbir şey bulamadığında denenecek diğer seçiciler, " || " ile ayrılır. Özellikler tablosundaki alternatifler bunlardan sonra otomatik olarak denenir
--timeoutsayı30Saniye cinsinden zaman aşımı
--retrysayıYeniden deneme sayısı. Belirtilmezse ekran ve dosya komutları geçici bir sorundan (hâlâ yüklenen bir sayfa, örtülü bir öğe, kilitli bir dosya) sonra bir kez daha dener; 0 bunu kapatır
--retryintervalsayı1Yeniden denemeler arasındaki saniye

İşlemler (--action)

--action:click

Başka parametre yok.

--action:doubleclick

Başka parametre yok.

--action:rightclick

Başka parametre yok.

--action:clear

Başka parametre yok.

--action:check

Başka parametre yok.

--action:uncheck

Başka parametre yok.

--action:hover

Başka parametre yok.

--action:focus

Başka parametre yok.

--action:submit

Başka parametre yok.

--action:scrollto

Başka parametre yok.

--action:waitfor

Başka parametre yok.

--action:settext

Bir alanın metnini değiştirir (eski adı: type).

ParametreDeğerVarsayılanAçıklama
--value zorunlumetin
--action:appendtext

Bir alanda zaten bulunan metnin sonuna metin ekler.

ParametreDeğerVarsayılanAçıklama
--value zorunlumetin
--action:scroll

Fare tekerleğini element üzerinde çevirir: sayfa içinde kayan listeler, paneller ve tablolar için.

ParametreDeğerVarsayılanAçıklama
--amount zorunlusayıTekerlek adımları: pozitif yukarı, negatif aşağı kaydırır (bir adım yaklaşık 100 piksel)
--action:sendkeys

Elemente odaklanır ve klavyenin yapacağı gibi orada tuşlara basar: metin, özel tuşlar ve kısayollar.

ParametreDeğerVarsayılanAçıklama
--keys zorunlutuşlarMetin ve köşeli parantez içinde özel tuşlar, ör. [TAB], [ESC], [CTRL+A], [DOWN][ENTER]. Düz bir [ için [[ kullanın
--action:select

Açılır listedeki bir seçeneği değerine veya metnine göre seçer.

ParametreDeğerVarsayılanAçıklama
--value zorunlumetin
--action:selectindex

Açılır listede belirli bir sıradaki seçeneği seçer.

ParametreDeğerVarsayılanAçıklama
--index zorunlusayıSeçeneğin sırası: 1 = ilk
--action:getproperty

Elementin bir özelliğini, bir durumunu (visible, enabled, checked), seçili seçeneğini veya konumunu okur.

ParametreDeğerVarsayılanAçıklama
--property zorunlumetinvalue, text, visible, checked, selectedtext, x, … veya herhangi bir öznitelik
--output zorunludeğişken adıSonucu alan değişken
--action:setproperty
ParametreDeğerVarsayılanAçıklama
--property zorunlumetinvalue, text, innerhtml veya herhangi bir öznitelik
--value zorunlumetin
--action:getattribute
ParametreDeğerVarsayılanAçıklama
--property zorunlumetinÖznitelik adı
--output zorunludeğişken adıSonucu alan değişken
--action:gettext
ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:exists
ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:gettable

Bir HTML tablosunu veri tablosu değişkenine okur: tabloyu, hücrelerinden birini veya onu içeren bir elementi yakalayın. Satırlar üzerinde loop --type:datatable ile döngü kurun.

ParametreDeğerVarsayılanAçıklama
--headertrue / falsetrueBaşlık satırı (thead, yoksa ilk satır) sütunları adlandırır; false: Column1, Column2… ve her satır veridir
--output zorunludeğişken adıSonucu alan değişken
--action:extract

Tekrarlayan öğeleri (ürün kartları, arama sonuçları, liste satırları) bir veri tablosuna okur: --dompath her öğeyle eşleşir, her sütun bir öğenin içindeki bir değeri okur ve --next sayfaları çevirir. Extract data sihirbazıyla oluşturulur.

ParametreDeğerVarsayılanAçıklama
--columns zorunlumetinJSON olarak sütunlar: [{"name":"Title","path":".//h3","read":"text"}]. path öğeye görelidir (. öğenin kendisidir); read değeri text, value, href, src, html veya herhangi bir öznitelik adıdır
--nextmetinSonraki sayfa düğmesinin veya bağlantısının seçicisi: her sayfa okunduktan sonra, bulunamayana veya devre dışı kalana kadar tıklanır. Boşsa tek sayfa okunur
--maxpagessayı10Okunacak en fazla sayfa sayısı (--next ile)
--maxrowssayı0Okunacak en fazla satır sayısı; 0 hepsini okur
--output zorunludeğişken adıSonucu alan değişken
--action:screenshot
ParametreDeğerVarsayılanAçıklama
--path zorunlumetinEkran görüntüsü dosya yolu Ajan makinesindeki bir dosya.
--action:upload

Yükleme için dosya seçer: bir dosya girişinde veya dosya iletişim kutusunu açan düğmede.

ParametreDeğerVarsayılanAçıklama
--file zorunlumetinYüklenecek dosya; birden fazlası virgülle ayrılır Ajan makinesindeki bir dosya.
--action:download

Elemente tıklar ve sitenin ardından indirdiği dosyayı kaydeder; --output kaydedilen dosyayı alır.

ParametreDeğerVarsayılanAçıklama
--path zorunlumetinKaydedilecek dosya veya bir klasör (sitenin dosya adı kullanılır) Ajan makinesindeki bir dosya.
--outputdeğişken adıSonucu alan değişken

Örnekler

capture --action:click --dompath:"//button[@id='login']"
capture --action:settext --dompath:"//input[@name='email']" --value:"user@test.com"
capture --action:getproperty --dompath:"//h1" --property:text --output:pageTitle
capture --action:select --dompath:"//select[@id='country']" --value:"Turkey"
capture --action:selectindex --dompath:"//select[@id='country']" --index:2
capture --action:appendtext --dompath:"#note" --value:" (urgent)"
capture --action:getproperty --dompath:"#agree" --property:checked --output:agreed
capture --action:exists --dompath:"//div[@class='error']" --output:hasError
capture --action:click --frame:"#payment" --dompath:"#pay"
capture --action:upload --dompath:"input[type=file]" --file:"C:\a.pdf, C:\b.pdf"
capture --action:download --dompath:"#export" --path:"C:\Downloads" --output:file
capture --action:gettable --dompath:"#orders" --output:orders
capture --action:extract --dompath:"//div[@id='results']/ul/li/div" --columns:[{"name":"Title","path":".//h3","read":"text"},{"name":"Price","path":".//span[@class='price']","read":"text"},{"name":"Link","path":".//a","read":"href"}] --next:"//a[normalize-space()='Next']" --maxpages:10 --output:products
Botream 0.1.1 · Oluşturulma 2026-10-14