browser-automation

name browser-automation version 1.0.0 description Playwright-based browser automation patterns for autonomous web interaction author OpenFang tags ["browser","automation","playwright","web","scraping"] tools ["browser_navigate","browser_click","browser_type","browser_screenshot","browser_read_page","browser_close"] runtime prompt_only Browser Automation Skill Playwright CSS Selector Reference Basic Selectors Selector Description Example #id By ID #checkout-btn .class By class .add-to-cart tag By element button , input [attr=val] By attribute [data-testid="submit"] tag.class Combined button.primary Form Selectors Selector Use Case input[type="email"] Email fields input[type="password"] Password fields input[type="search"] Search boxes input[name="q"] Google/search query textarea Multi-line text areas select[name="country"] Dropdown menus input[type="checkbox"] Checkboxes input[type="radio"] Radio buttons button[type="submit"] Submit buttons Navigation Selectors Selector Use Case a[href*="cart"] Cart links a[href*="checkout"] Checkout links a[href*="login"] Login links nav a Navigation menu links .breadcrumb a Breadcrumb links [role="navigation"] a ARIA nav links E-commerce Selectors Selector Use Case .product-price , [data-price] Product prices .add-to-cart , #add-to-cart Add to cart buttons .cart-total , .order-total Cart total .quantity , input[name="quantity"] Quantity selectors .checkout-btn , #checkout Checkout buttons Common Workflows Product Search & Purchase 1. browser_navigate → store homepage 2. browser_type → search box with product name 3. browser_click → search button or press Enter 4. browser_read_page → scan results 5. browser_click → desired product 6. browser_read_page → verify product details & price 7. browser_click → "Add to Cart" 8. browser_navigate → cart page 9. browser_read_page → verify cart contents & total 10. STOP → Report to user, wait for approval 11. browser_click → "Proceed to Checkout" (only after approval) Account Login 1. browser_navigate → login page 2. browser_type → email/username field 3. browser_type → password field 4. browser_click → login/submit button 5. browser_read_page → verify successful login Form Submission 1. browser_navigate → form page 2. browser_read_page → understand form structure 3. browser_type → fill each field sequentially 4. browser_click → checkboxes/radio buttons as needed 5. browser_screenshot → visual verification before submit 6. browser_click → submit button 7. browser_read_page → verify confirmation Price Comparison 1. For each store: a. browser_navigate → store URL b. browser_type → search query c. browser_read_page → extract prices d. memory_store → save price data 2. memory_recall → compare all prices 3. Report findings to user Error Recovery Strategies Error Recovery Element not found Try alternative selector, use visible text, scroll page Page timeout Retry navigation, check URL Login required Inform user, ask for credentials CAPTCHA Cannot solve — inform user Pop-up/modal Click dismiss/close button first Cookie consent Click "Accept" or dismiss banner Rate limited Wait 30s, retry Wrong page Use browser_read_page to verify, navigate back Security Checklist Verify domain before entering credentials Never store passwords in memory_store Check for HTTPS before submitting sensitive data Report suspicious redirects to user Never auto-approve financial transactions Warn about phishing indicators (misspelled domains, unusual URLs)