Core

<p align="center"> <img src="https://tidesurf.org/logo.svg" width="80" height="80" alt="TideSurf"> </p> <h2 align="center"> TideSurf </h2> <p align="center"> <strong>English</strong> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> </p> <p align="center"> <strong><a href="https://tidesurf.org">About</a></strong> | <strong><a href="https://tidesurf.org/docs">Documentation</a></strong> | <strong><a href="https://tidesurf.org/llms.txt">llms.txt</a></strong> | <strong><a href="https://github.com/sponsors/MercuriusDream">Sponsor</a></strong> </p> <p align="center"> <a href="https://www.producthunt.com/products/tidesurf?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-tidesurf" target="_blank" rel="noopener noreferrer"><img alt="TideSurf - Ultra-token-efficient CDP library for AI agents | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1101853&theme=neutral&t=1773855834160" /></a> </p> <p align="center"><strong> Web browsing should not require omnimodal vision models.<br> TideSurf converts the live DOM into a compressed structured representation optimized for LLMs. </strong><br><br> TideSurf is a TypeScript library that connects Chromium to LLM agents via the <a href="https://chromedevtools.github.io/devtools-protocol">Chrome DevTools Protocol</a>. It walks the live DOM, compresses it into a token-efficient structured representation (50-200 tokens per page), and exposes 18 tool definitions for LLM function calling. In short, <strong>a DOM compression that keeps token costs 10-100x lower than screenshot-based approaches.</strong> </p> <p align="center"> <a href="https://tidesurf.org/docs#getting-started">Getting started</a> <a href="https://tidesurf.org/docs#page-format">Page format</a> <a href="https://tidesurf.org/docs#token-budget">Token budget</a> <a href="https://tidesurf.org/docs#agent-patterns">Agent patterns</a> <a href="https://tidesurf.org/docs#security">Security</a> <a href="https://tidesurf.org/docs#api-reference">API reference</a> </p> <p align="center"> <img src="https://tidesurf.org/og.png" alt="TideSurf Social Preview"> </p> <p align="center"> <a href="https://github.com/TideSurf/core/actions/workflows/ci.yml"><img src="https://github.com/TideSurf/core/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://www.npmjs.com/package/@tidesurf/core"><img src="https://img.shields.io/npm/v/@tidesurf/core" alt="npm"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License"></a> </p>