SEREngines Command List
COMMAND STRUCTURE:
COMMAND_NAME(parameter1:value, parameter2:value)A command will have a list of parameters which can be in any order and will be in between the brackets.
EXAMPLES
FILLING A FORM
<div>GOTO(url:https://www.google.com) </div><div>TYPE(selector: input[title=”Search”], text:SEREngines) </div><div>CLICK(selector: [value=”Google Search”]) </div><div>WAIT(text:SEREngines)</div>
SOLVING AN IMAGE CAPTCHA
<div>GOTO(url:https://captcha.com/captcha-examples.html) </div><div>CAPTCHA_IMAGE(selector: img.captcha_sample) </div><div>TYPE(selector:input#query, text:%captcha%)</div>
SOLVING RECAPTCHA
<div>GOTO(url:https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php) </div><div>RECAPTCHA()</div>
BASIC COMMANDS
NAVIGATING TO A URL
<p>GOTO(url:http://www.google.com)</p><p></p>
This command will navigate to the URL specified in the url parameter.
KEYBOARD TYPING
TYPE(selector:<CSS Selector>, text:<string>, clear:<bool>, optional:<bool>)
This command will type into the input at the CSS selector.
Optional Parameters:
clear: true/false will clear the input before typing into it. Default: false
optional: true/false and if true it will always return success. Default: false
MOUSE CLICK
CLICK(selector:<CSS Selector>, random:<bool>, optional:<bool>)
This command will click on the CSS selector.
Optional Parameters:
random: true/false and if true it will check for all selectors on the page and randomly click one of them. Default: false
optional: true/false and if true it will always return success. Default: false
SELECT VALUE IN A DROPDOWN
SELECT(selector:<CSS Selector>, value:option1, optional:<bool>)
This command will select option1 from the HTML SELECT (dropdown) at CSS selector.
Optional Parameters:
optional: true/false and if true it will always return success. Default: false
FILE INPUT
FILE(selector:<CSS Selector>, files: ["/path/to/file.jpg", "/path/to/file2"])
This command will set the files for a form. First, it will click the button at the CSS selector and then intercept the file chooser dialogue and add the file paths.
KEYBOARD PRESS
KEYBOARD(action: press, key: Backspace)
Press key on the keyboard.
action: press (will perform down + up of key), down and up.
MOUSE ACTIONS
MOUSE(action: press, button: right)
Mouse action at the current mouse position.
buttons: left, right, middle
action: press, down, up
MOUSE(action: move, selector:<CSS Selector>)
Moves the mouse to the visible CSS selector position.
DRAG ELEMENT
DRAG(from:<CSS Selector>, to:<CSS Selector>)
Drags element "from" the CSS selector position to the "to" CSS selector position.
WAITING BEFORE NEXT COMMAND
WAIT(selector:<CSS Selector>, text: <string>, timeout: 10)
This command will wait for 10 seconds before going to the next command for either the text or selector to be found. Each of the parameters is optional but must contain at least one.
If only the timeout parameter is present, then it will just wait 10 seconds and then resume.
Optional Parameters:
timeout: timeout in seconds. Default: 10
PROCESS CAPTCHA IMAGE
CAPTCHA_IMAGE(selector: <CSS Selector>)
Solve an image captcha. The CSS selector will need to be an image (<img>). Once GSA Search Engine Ranker has solved the image captcha, it will continue to the next command and be available in the %captcha% variable.
SOLVE RECAPTCHA
RECAPTCHA()
Solves Recaptcha v2 and v3.
EXECUTE JAVASCRIPT
JAVASCRIPT(code:<javascript>)
This command will execute javascript code.