browser-automation
Interact with a website in the browser - log in, fill forms, page through results, stop before a purchase
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 12
- Forks
- 2
01 前言 Front Matter
- name
- browser-automation
- license
- MIT
- metadata
- { "polyrob-when": "Driving a website: log in, click, fill forms", "polyrob-version": "3", "polyrob-priority": "2", "polyrob-triggers": "{\"tool_ids\":[\"browser\"]}" }
- description
- Interact with a website in the browser - log in, fill forms, page through results, stop before a purchase
03 SKILL.md 正文
Browser Automation Workflows
This skill is about INTERACTION. To read a page you already have the URL of, use
web_fetch_fetch_url first (fast, no browser); to extract structured data, see
web-research or the web-scraping skill of the discovery pack.
Tool availability
Read the browser line of your <tool-catalog>. [loadable] → load_tool("browser").
[gated:…] → follow the remedy it names (see harness-manual); do not claim a page
you could not open.
How the verbs work
browser_go_to_url(URL=…)opens a page; the next observation lists the page's interactive elements with an index.browser_click_element(elementIndex=N)andbrowser_input_text(elementIndex=N, inputText=…)act on that index. Indices change after every navigation: read the new observation before the next click.browser_send_keys(keys="Enter"),browser_scroll_down/browser_scroll_up,browser_scroll_to_text(text=…).- Dropdowns:
browser_get_dropdown_options(elementIndex=N), thenbrowser_select_dropdown_option(elementIndex=N, inputText="<option text>"). - Tabs:
browser_open_tab(url=…),browser_switch_tab(pageId=N). - Read the page:
browser_extract_page_content(). browser_screenshot(name=…)saves a PNG into the workspace (screenshots/) and returns its path. To show it, put that ABSOLUTE path in yoursend_messagetext (the framework attaches it or links it). Usemessage(media_paths=[…])only to send it to another chat.
Login Flow
- Navigate to the login page.
- Handle popups first — cookie consent ("Accept", "Allow", "Agree", "OK").
- Credentials: there is no site-password store. Use a login only when the owner
gives it for this task, and only on that site's own login page. Type it into the
field, never into a message, a file or memory. If the owner pasted it in chat, say
once that it now sits in the chat history (
secret-handling). - Click the submit button.
- Verify the login: check that a dashboard or profile element appears.
- A CAPTCHA or any "prove you are human" check: stop. Never solve it, never send it to a solver service, never try to bypass it. Hand it to the owner: say which site and which step, and wait. This applies on every site.
- A login lasts for this session only: the next session starts logged out. Do the task in this session, and say so when the owner expects the login to last.
Pagination & Data Collection
- Extract data from the current page → save to a workspace file immediately.
- Check for "next" or pagination controls.
- If next exists and is enabled → click and repeat.
- If not → pagination is complete; report the total collected.
Form Submission
- Scroll the form into view if needed.
- Fill fields top to bottom in natural order.
- Verify field values before you submit.
- Click submit and wait for the response.
- Check for a success message or an error state.
- A file-upload field: there is no file-upload verb. Hand that step to the owner.
Multi-Step Checkout/Wizard
⚠️ A purchase is an owner money action. A checkout, a payment, a
subscription, a donation or a "place order" button spends the owner's money.
Stop BEFORE the step that commits it: report the site, the items, the total
and the payment method the page shows, and let the owner complete it. Never
type card or bank details, never tick "save payment method", and never click
the final Pay / Place order / Subscribe button yourself. (A wallet dapp is a
different rail — dapp_browser, see token-launch.)
- Complete each step fully before you proceed.
- Look for "Continue", "Next", "Proceed" buttons.
- Wait for the step transition (URL change or content update).
- Verify you are on the expected step before you fill it.
Results and files
- Save extracted data to a workspace file (JSON/CSV) with its source URL and time.
- A download started by a click is not saved to the workspace here. If you need the file, ask the owner for it or for a direct link.
- Deliver a result file or a screenshot: put its ABSOLUTE workspace path in your
send_messagetext. Usemessage(media_paths=[…])only to send it to another chat.
04 同仓库更多 Skills
echo-basics
How to use the echo tool from the echo fixture pack.
x-engagement
Operate X account communication on the API rail (the captured-browser rail only where the owner chose it)—read inboxes, post/reply, send DMs, set up the account, with the real write gates and completion evidence
social-discovery
Discover public X/social accounts and conversations with AnySite first (anysite_describe, then anysite_api), using native X account reads where they are authoritative and preserving write gates
polymarket-trading
GATED: place/cancel Polymarket orders. Owner-only, read-first, >$500 confirmation gate; references crypto-trading-safety
polymarket-portfolio-review
Read the configured Polymarket account's positions and trade history from the public Data API (no address parameter); summarize exposure and P&L
polymarket-market-research
Read Polymarket markets (discover, details, price as implied probability, orderbook, spread, volume) with no wallet