Skip to main content

Intuned Browser SDK

Project description


title: "Python SDK" sidebarTitle: "intuned_browser" icon: cube

Browser automation helpers for Python, built on Playwright. This package provides utilities for common automation tasks—AI-powered data extraction, navigation with retries, pagination handling, and more.

Installation

pip install intuned-browser
When using [Intuned](https://intunedhq.com), this package is pre-installed in every Python project.

Quick example

from typing import TypedDict

from playwright.async_api import Page
from intuned_browser.ai import extract_structured_data, is_page_loaded
from intuned_browser.helpers import go_to_url

class Params(TypedDict):
    pass

async def automation(page: Page, params:Params, **kwargs):
    await go_to_url(page, "https://books.toscrape.com")
    loaded = await is_page_loaded(page)
    if not loaded:
      raise ValueError("Page is not loaded, can not extract data")

    # Extract all book listings from the page
    books = await extract_structured_data(
        source=page,
        data_schema={
            "type": "object",
            "properties": {
                "products": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "title": {"type": "string"},
                            "price": {"type": "string"}
                        }
                    }
                }
            }
        },
        prompt="Extract all book listings with their titles and prices",
        strategy="HTML",
        model="claude-haiku-4-5-20251001"
    )

    return books

AI module

AI-powered utilities for data extraction and page analysis. These functions use AI and incur costs.

Function Description
extract_structured_data Extract structured data from pages using AI with schema validation
is_page_loaded Detect when a page has finished loading

AI functions support caching and matching to reduce costs.

Helpers module

Function Description
go_to_url Navigate with automatic retries and error handling
wait_for_network_settled Wait for network requests to complete
wait_for_dom_settled Wait for DOM mutations to finish
scroll_to_load_content Load infinite-scroll content
click_until_exhausted Click "Load More" buttons until all content loads
extract_markdown Convert pages to markdown
download_file Download files with different triggers
save_file_to_s3 Download and upload files to S3
upload_file_to_s3 Upload files with custom S3 configurations
filter_empty_values Remove empty values from data
validate_data_using_schema Validate data against schemas
process_date Parse and normalize dates
sanitize_html Clean and sanitize HTML
resolve_url Resolve relative URLs to absolute paths

Requirements

  • Python 3.8+
  • Playwright (pip install playwright && playwright install)
  • For AI functions: API key for your AI provider (set via environment variable or function parameter)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

intuned_browser-0.1.15.tar.gz (145.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

intuned_browser-0.1.15-py3-none-any.whl (185.9 kB view details)

Uploaded Python 3

File details

Details for the file intuned_browser-0.1.15.tar.gz.

File metadata

  • Download URL: intuned_browser-0.1.15.tar.gz
  • Upload date:
  • Size: 145.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for intuned_browser-0.1.15.tar.gz
Algorithm Hash digest
SHA256 4c57b995b8001e4997259fe93b22844a5c505d2955551af6f7cc52ce1e418660
MD5 965305906a14a9a2415285fdd4845b9d
BLAKE2b-256 8526ac13ddd6c4d1cc5d19e09ca2a03a63bcad9391e6e543243391de74aecfb3

See more details on using hashes here.

File details

Details for the file intuned_browser-0.1.15-py3-none-any.whl.

File metadata

File hashes

Hashes for intuned_browser-0.1.15-py3-none-any.whl
Algorithm Hash digest
SHA256 b529fdfd73da9faca8504d9e7d01c9787f45b38902e9e80ddac8d3fe9307f12d
MD5 b236661b9fe2eb060e1b05bd5b3bf4c0
BLAKE2b-256 ff6c8eb5c6c5f9248897175f1422cb0a0efdfca3a7167e5d79aaf993b78f9432

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page