browser_navigate
Open a URL
Open an http(s) URL in the current tab. Returns evidence and a snapshot of the visible screen (elements carry refs like e12), with counts of what is above and below. Words like cheapest, latest, highest-rated or most mean the site's own sort or tab for that order (a list's default order is usually something else, e.g. 'Best' or 'Featured'): apply it, then read the top.
輸入參數url必填snapshot
browser_snapshot
Read the page
The current page as a compact tree of headings, text and elements with refs (e12) to act on: three screens around the viewport, or everything with whole_page. Refs stay valid while their element is on the page.
輸入參數whole_page
Click an element by ref. Refuses with a reason (obscured, stale, not visible) instead of clicking the wrong thing. Returns evidence of what changed.
輸入參數ref必填
Type into an input, textarea or editable element by ref, replacing its text. Returns evidence.
輸入參數ref必填text必填submit
browser_select
Select options
Choose option(s) of a <select> by label or value. Returns evidence.
輸入參數ref必填values必填
Press a key or shortcut on the focused element. Returns evidence.
輸入參數key必填
Scroll about one screen. Returns evidence and the newly visible elements.
輸入參數direction必填
browser_screenshot
Screenshot
JPEG of the current viewport. Prefer browser_snapshot (cheaper, has refs); use this when layout or images matter.
無需輸入參數。
browser_get_text
Page text
Readable text of the page (PDFs too), secrets masked, without refs. To read a few values or a list, browser_query is far smaller.
輸入參數selectormax_chars
browser_query
Read values with JavaScript
Read just the values you need (prices, counts, titles, a results list) with a read-only JavaScript expression returning JSON (at most 4000 characters): the cheapest way to read, far smaller than browser_get_text or a snapshot. It runs in a world of its own where clicks, typing, submits and network writes are refused.
輸入參數expression必填
browser_find
Find elements
Refs of elements anywhere on the page, outside the visible screen too, by the words they show or are labelled with, best match first. Separate several targets by commas.
輸入參數query必填
browser_actions
Several actions in one call
Several steps in order in one call, e.g. fill a form's fields and submit it; each gets the same checks as its own tool. Stops at the first that fails, or after one that moves the page to another address (later refs would belong to the old page). Returns a line per step and the evidence and visible screen after the last one run.
輸入參數actions必填
browser_resume
Continue after the person
When a result says NEEDS A PERSON (a sign-in, a one-time code or 2FA, a device approval, a CAPTCHA), tell the user in your reply what the page needs and that the pilotfish browser window is open on it; when they have done it there (or right after asking), call this and carry on: it waits until the page has moved on, then returns it. BLOCKED and STOP mean the site cannot be continued that way.
輸入參數timeout_s
Wait 0.5-10 seconds, then return what changed. Only for a page that is visibly still loading: every action already waits for the requests it started.
輸入參數seconds必填
List the open tabs (the current one is marked). switch_to makes another tab current and returns its snapshot.
輸入參數switch_to
browser_close
Close the browser
Only to start over: closes the browser, and the next call starts a fresh one (cookies and logins are gone). It closes by itself when the client disconnects.
無需輸入參數。