bits_skill

Overview

This skill controls browser automation agents via the Bits MCP server to run web scraping, form filling, and other browser-based automation tasks. It lets an assistant instruct Bits agents to navigate sites, interact with elements, handle auth flows, and return structured data. Use it to offload browser work and receive JSON, text, or screenshots as results.

How this skill works

The skill connects to a Bits MCP server configured with your BITS_API_KEY and runs TypeScript SDK code in a sandboxed Code Mode. The agent searches the SDK docs if needed, generates TypeScript to drive a headless or visible browser, executes actions (navigate, click, type, screenshot), and returns the extracted or computed output. Workflows created in the Bits web app can also be triggered via the MCP for repeated tasks.

When to use it

• Web scraping of lists, tables, or structured pages where DOM interaction is required.
• Automating form fills, multi-step sign-ups, and complex navigation flows.
• Handling OAuth, logins, and multi-window flows that require browser context.
• Extracting screenshots, page layouts, or other visual artifacts.
• Running repeatable browser jobs as defined workflows from the Bits web app.

Best practices

• Store the API key securely; configure the MCP server env BITS_API_KEY and restart your gateway.
• Start with small scripts that locate elements by stable selectors (IDs, data-attributes).
• Add timeouts, checks, and retries to handle slow loads, modals, or CAPTCHAs.
• Use output schemas or JSON formatting for predictable downstream parsing.
• Test workflows interactively in the Bits web app before running at scale.

Example use cases

• Scrape the top 10 headlines from a news site and return title, URL, and score as JSON.
• Visit a contact page, fill name/email/message fields, submit the form, and capture the confirmation text.
• Log into a dashboard via OAuth popup, navigate to the reports page, and download or extract structured metrics.
• Run a nightly workflow that navigates an e-commerce category and returns product name, price, and availability.
• Take screenshots of rendered pages for visual QA across multiple URLs.