invisible-playwright

The browser

Your browser is invisible_playwright: a real Firefox that a site sees as a person at a computer. Everything you do in it goes through the real pointer and the real keyboard. Use it when a task needs a website; for a plain download or an API, exec with curl is simpler.

Identities

A browser identity is one person on the web: its own profile, cookies, logins and fingerprint, kept on disk between uses.

• browser_identity_list shows the identities, which are open, and how many may be open at once.
• browser_identity_create makes one, closed. Give it a name only: it then leaves through this computer's own network, which is right unless the person asked for this one identity to use a proxy of theirs.
• browser_identity_launch opens it on your desktop. The first launch of a new identity can take minutes.
• browser_identity_close closes it; its profile, cookies and logins stay.
• Reuse the identity that is already logged in to a site instead of making a new one, and keep one identity per person or account you act as: two accounts in one identity are one person to anyone looking.
• A second identity is for what must not touch the first. The usual case: signing up somewhere and needing a mailbox for the verification. Open a throwaway-mail site in another identity, take the address, type it into the form in the first one, and go back to the other for the link.

Each open identity drives one page. browser_navigate opens a url in it, and every other tool acts on that page. Going somewhere else and coming back is a navigation, not a second window.

Acting on a page: try things in this order

The order matters, because a page can tell the difference.

1. A named tool with a selector: browser_click, browser_type, browser_select_option, browser_press_key. browser_snapshot gives the selector of each visible element; pass it as it is, it is built to be unambiguous.
2. Coordinates. browser_snapshot reports at: [x, y] for every element it lists, in viewport pixels, and browser_click_at takes exactly those. This is for what a selector does not describe: a canvas, a slider, a map, a widget made of plain boxes.
3. Your eyes. browser_screenshot, find the thing in the picture, then browser_click_at where it is. For what the snapshot does not list at all. computer_screenshot shows your whole desktop, the browser window included.

Read with browser_snapshot (title, url and the interactive elements, with checked and value where they have one) and browser_read_text (the text of an element). browser_scroll, browser_back, browser_forward and browser_reload move around as a person would.

Never try to change a page except through the pointer and the keyboard: an event a script makes arrives marked as not coming from a person, which is the clearest sign that a bot is driving.

When it does not work

• If a tool says the browser is not open or is gone, launch the identity again and carry on.
• A date field that is a calendar wants its days clicked, not typed.
• A captcha, a block or a page that keeps refusing you: say so in your answer, with what you saw. A task reported as impossible is worth more than one done in a way that gets the identity blocked.
• Do not guess a number or a fact you could not read on the page.

Close an identity with browser_identity_close once the task no longer needs it, before you answer: an open browser holds memory on your computer.

Your own skills

When you work out how to do something on a site that you will do again (where its login is, which steps a form needs, what blocks you), write it down as a skill of your own: /home/dot/skills//SKILL.md, the same shape as this file.