Execution starts at the first unconnected block
UScraper finds a non-proxy block with no incoming connection and runs from there. Keep one obvious starting block per scraper.
Documentation
Learn UScraper from overview to every block
This documentation teaches the graph model first, then explains each block in its own reference page so users can build custom scrapers without starting from a template.
Overview
UScraper runs a visual browser graph
A scraper is a sequence of connected blocks. The browser performs each block in order, waits when instructed, branches on conditions, and writes data locally when an export block runs.
Normal blocks follow the next connection
Navigation, interaction, wait, extraction, setup, and export blocks continue through the first connected output path.
Condition blocks branch
Element Exists, Element Visible, and Text Contains expose true and false connectors so one graph can handle alternate page states.
Proxy configuration is special
Set Proxy configures browser startup and is excluded from normal graph execution. It does not need to sit in the main chain.
Multiple URLs create a loop
Navigate can hold a list of URLs. Reaching End advances the same downstream flow to the next URL until the list is complete.
Structured Export is row based
The row selector finds repeated items. Each column selector is evaluated inside each row, then written to CSV.
Workflow
A practical path for building a scraper
The safest way to build a custom scraper is to design against one page, verify selectors, and only then expand to URL lists or more complex branching.
Choose a target page
Open the page manually, confirm the data is visible, and inspect the DOM in Chrome DevTools.
Build the graph
Start with Navigate, connect interaction and wait blocks, then finish with extraction, export, and End.
Stabilize selectors
Use CSS selectors or XPath that survive refreshes. Prefer data attributes and repeated row containers over copied full paths.
Export and verify
Run one URL first, inspect rows, then use multiple URLs and append mode once the CSV shape is correct.
Recipes
Common graph patterns
Use these patterns as starting points. Swap selectors, waits, and export columns to match the site you are scraping.
Single page extraction
Navigate -> Wait for Element -> Extract Text -> EndBest for article fields, profile details, counters, or one-off values.
Listing to CSV
Navigate -> Wait for Element -> Structured Export -> EndBest for products, reviews, directories, tables, search results, and cards.
Search form
Navigate -> Type Text -> Click -> Wait for Element -> Structured Export -> EndBest when a user must enter a query before the result rows appear.
Lazy loaded page
Navigate -> Wait for Element -> Scroll -> Sleep -> Structured Export -> EndBest when results appear only after the viewport moves down the page.
Optional popup
Element Exists -> true: Click close -> Export, false: ExportBest for cookie banners, modals, and intermittent empty-state panels.
Block reference
Every supported block has its own page
Open a block page for its purpose, behavior, configuration fields, example flow, outputs, caveats, and practical usage notes.
Navigation
Navigation
Navigate
Opens one page or loops through a list of pages.
Read block docsNavigation
Go Back
Moves the browser back one step in its history.
Read block docsNavigation
Go Forward
Moves the browser forward one step in its history.
Read block docsNavigation
Refresh
Reloads the current page.
Read block docsInteraction
Interaction
Click
Clicks an element found by CSS selector or XPath.
Read block docsInteraction
Type Text
Clears and types text into an input field.
Read block docsInteraction
Select Option
Selects an option from a standard HTML dropdown.
Read block docsInteraction
Scroll
Scrolls the page or brings a target element into view.
Read block docsExtraction
Wait & Timing
Wait & Timing
Wait for Element
Waits until an element exists or is visible.
Read block docsWait & Timing
Wait for Text
Waits until specific text appears on the page or inside an element.
Read block docsWait & Timing
Wait for Page Load
Waits for the base page document to be available.
Read block docsWait & Timing
Sleep
Pauses execution for a fixed number of seconds.
Read block docsConditions
Conditions
Element Exists
Branches based on whether an element exists in the DOM.
Read block docsConditions
Element Visible
Branches based on whether an element is present and displayed.
Read block docsConditions
Text Contains
Branches based on whether text appears on the page or inside an element.
Read block docsSetup & Actions
Setup & Actions
Set Proxy
Configures browser proxy settings before execution starts.
Read block docsSetup & Actions
Set Window Size
Resizes the browser window.
Read block docsSetup & Actions
Take Screenshot
Captures the current browser page as an image.
Read block docsSetup & Actions
Inject JavaScript
Runs custom JavaScript in the page context.
Read block docsSetup & Actions
End
Marks the end of an execution branch.
Read block docsExport
Quality checklist
Before you trust a scraper
Run the same checks every time you build a new graph or update selectors for a changed website.
- Use one URL while designing and debugging the graph.
- Confirm selector match counts in DevTools before exporting.
- Use Wait for Element or Wait for Text instead of long fixed sleeps when possible.
- Use append mode only after confirming headers and columns are correct.
- Respect site terms, robots rules, rate limits, privacy, and data ownership requirements.