read_form
List a form's fields with names, types, labels, and options to address them before filling. Check usability and include hidden controls outside the form.
Instructions
List a form's fields with their names, types, labels and options.
read_page returns rendered text, which loses everything needed to
address a field: a large form arrives as labels with no name, and a
<select>'s options vanish. Use this before filling a form you have
not seen. root is a CSS selector for the form (default: the first
form on the page). Hidden inputs are counted, not listed.
Set whole_page=true for controls a page attached outside the form —
a picker or editor dialog is often appended to the body, and a field
found there is still one the form will post.
Each field carries usable: false means it is in the DOM but hidden or
disabled right now, so choosing it will fail. A form hides sections it has
not revealed yet — measured on KVR, a news form keeps event_country
hidden until the Deal/Offer type is chosen. Check usable before
addressing a field rather than discovering it through a timeout.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root | No | form | |
| max_fields | No | ||
| whole_page | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||