Skip to content
YosoiDocs

Concepts

This series follows the Arc desk lamp through QScrape’s eShop. We start with a few HTML bytes, then introduce each capability when the task needs it.

The examples use Rust and Python with the same inputs and intended results wherever both interfaces support the task. Each language’s explanation stays with its code. We assume Yosoi is already installed; Install covers that first step.

Lesson What changes in the task
Making sense of HTML Read product text and links from local bytes.
Fetching our first page Obtain those bytes through HTTP.
Using a browser Capture rendered evidence and choose headless or headful execution.
Choosing a browser Select Chrome, Firefox or Moli with explicit capability limits.
Network routing Choose an IP family, source address or proxy for a Request or owned Session.
Waiting for the page Wait for the product before reading it.
Building a product record Validate typed records and inspect rejected candidates.
Adding a product to the cart Read controls, take an action, and check the resulting cart.
Following the data Work with JSON, XML, and plain text.
Building reusable browser recipes Compose nested Flows, scripts, modules, and screenshots.
Keeping the browser open Share state across separate recipes.
Accessing a protected page Follow the site’s verification workflow and retain unresolved outcomes.
Finding more pages Discover URLs with Map and Search.
Bounding the work Handle limits, failed prerequisites, cancellation, and uncertain effects.
Sharing browser capacity Separate tab authority from controller execution capacity.
Yielding while waiting Let another tab use execution capacity while a wait retains control.
Keeping browser windows in Docker Give a headful browser its own display and optional viewer.
Keeping the evidence Restore saved input and inspect retained automation records.
Surfaces Read documents and video, then drive an agent task through the CLI.
Archiving a surface Save a portable policy outcome and reload it in a later process.

Begin with Making sense of HTML.