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.12.tar.gz (124.1 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.12-py3-none-any.whl (159.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for intuned_browser-0.1.12.tar.gz
Algorithm Hash digest
SHA256 18b5aa4738a6138ac49f21e63e08cc1b0760780ccb9bd8187d6a49212915fd2d
MD5 b87f60e9b79f8cae97c7e9e8c309e5c9
BLAKE2b-256 c3ec60f5da830c806df317a9f76602ad162161a40725936cb2e72e273b96bbfa

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for intuned_browser-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 ac65284dffe9019bd7519b15bb60c9a16c4f2dc826bf0ec08e85af04c255cfb0
MD5 9c538fa4f6195369d58203723c76749c
BLAKE2b-256 f17e80c472f28e7be0560873b1c7738fd4ea5ba7daa98c24f7668b72041d237e

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