COMMAND STRUCTURE:

COMMAND_NAME(parameter1:value, parameter2:value)

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.

1. go to register
2. acept with a form the register
3. fill the register, Submit Registration, and wait for the email and activate account
4. login

1. REGISTER_STEP1 -> fill the register (here go verify submission and fill data?)
2. REGISTER_STEP2 -> acept with a form the register
3. [REGISTER_STEP3] -> Submit Registration
   
4. ....