Floppydata Floppydata

Сесії безкоштовні — платіть лише за трафік

Хмарний браузер для ШІ-агентів

Дайте агентові справжній браузер, і він перестане гадати, що, імовірно, містить сторінка: він бачить відрендерений макет, обходить DOM і може клікати, прокручувати чи вводити текст так, як це робить людина.

  • MCP-сервер із невеликим набором інструментів, зосереджених на конкретних завданнях, за одним API-ключем
  • Сторінки повертаються у форматі markdown або JSON замість необробленого HTML, який швидко вичерпує контекстне вікно
  • Сесії, що працюють годинами та перепідключаються до того самого браузера, замість того щоб починати спочатку

Готово для ШІ

Пропустіть налаштування.
Ваш агент усе зробить сам.

Скопіюйте один промпт і вставте його у свого ШІ-агента. Він відкриє сесію хмарного браузера, керуватиме сторінкою та повідомить, що саме побачив, — без жодного рядка коду.

Ідеально для
cloud-browser.prompt.md ~870 токенів

                            1
                            # Floppydata Cloud Browser — reference and operating rules
                        
                            2
                             
                        
                            3
                            You are working with the Floppydata Cloud Browser API. Use only the facts
                        
                            4
                            below: never guess endpoints or fields, and never invent page content —
                        
                            5
                            report only what the browser actually returned.
                        
                            6
                             
                        
                            7
                            ## Step 0 — is there an API key?
                        
                            8
                            Read the key from FLOPPY_API_KEY in the environment. If it is missing, do
                        
                            9
                            not attempt a session and do not ask for the key in chat. Walk the user
                        
                            10
                            through this instead:
                        
                            11
                             
                        
                            12
                              1. Create an account, or sign in to an existing one:
                        
                            13
                                 https://app.floppydata.com/account/signup
                        
                            14
                              2. Open API keys, copy the key that is already there or generate a new
                        
                            15
                                 one: https://app.floppydata.com/api-keys
                        
                            16
                              3. Buy traffic: https://app.floppydata.com/proxies/buy?type=rotating
                        
                            17
                                 Sessions themselves are free, but every page a session loads goes
                        
                            18
                                 out through Floppydata proxies, and proxy traffic is billed per GB.
                        
                            19
                                 With no traffic on the account a session has no network to run on.
                        
                            20
                              4. Put the key in the environment as FLOPPY_API_KEY — not in code, not
                        
                            21
                                 in a chat message — then run the task again.
                        
                            22
                             
                        
                            23
                            ## Step 1 — with a key, start the session straight away
                        
                            24
                            Do not interview the user about settings. Start on these defaults and
                        
                            25
                            change them only when the task actually calls for it.
                        
                            26
                             
                        
                            27
                            POST https://api.floppydata.net/v2/browser/sessions
                        
                            28
                            X-Api-Key: $FLOPPY_API_KEY
                        
                            29
                            {
                        
                            30
                              "proxy": {
                        
                            31
                                "type": "residential",            // residential | mobile | datacenter
                        
                            32
                                "location": { "countryCode": "DE" },
                        
                            33
                                "rotation": { "mode": "sticky" }  // one IP for the whole session
                        
                            34
                              },
                        
                            35
                              "browser": { "fingerprint": { "strategy": "auto", "os": "windows" } },
                        
                            36
                              "runtime": { "timeoutSeconds": 1800, "keepAlive": true }
                        
                            37
                            }
                        
                            38
                             
                        
                            39
                            Every field is optional: {} also works — residential proxy, sticky
                        
                            40
                            rotation, 600 second timeout.
                        
                            41
                             
                        
                            42
                            201 Created returns:
                        
                            43
                              id           session id
                        
                            44
                              status       running | stopped | timedOut | failed
                        
                            45
                              connectUrl   signed wss:// CDP endpoint — treat it like a password
                        
                            46
                              settings.id  reuse it to restore this identity and cookie jar
                        
                            47
                              expiresAt    when the session ends on its own
                        
                            48
                             
                        
                            49
                            A 401 means the key is wrong or revoked: back to Step 0. If the call is
                        
                            50
                            refused because the account has no traffic left, send the user to the buy
                        
                            51
                            page above rather than retrying.
                        
                            52
                             
                        
                            53
                            ## Step 2 — drive the page
                        
                            54
                            Connect over CDP and work in the tab that is already open:
                        
                            55
                             
                        
                            56
                              const browser = await chromium.connectOverCDP(connectUrl);
                        
                            57
                              const page = browser.contexts()[0].pages()[0];
                        
                            58
                              await page.goto(url, { waitUntil: "domcontentloaded" });
                        
                            59
                             
                        
                            60
                            One session keeps cookies and page state between steps, so navigate,
                        
                            61
                            fill, click and read inside it instead of starting a session per action.
                        
                            62
                             
                        
                            63
                            ## Step 3 — hand a step to a human
                        
                            64
                            Some checks only a person can clear. Request a live view for the session,
                        
                            65
                            let someone finish that step, then reconnect and carry on:
                        
                            66
                             
                        
                            67
                              POST /v2/browser/sessions/{id}/live-view  -> { liveViewUrl }
                        
                            68
                              GET  /v2/browser/sessions/{id}            -> fresh connectUrl
                        
                            69
                             
                        
                            70
                            ## Step 4 — reuse the identity on the next run
                        
                            71
                            Send back the settings id you were given:
                        
                            72
                             
                        
                            73
                              { "settings": { "id": "<settings-id>" } }
                        
                            74
                             
                        
                            75
                            ## Step 5 — stop when the task is done
                        
                            76
                            POST https://api.floppydata.net/v2/browser/sessions/{id}/stop
                        
                            77
                             
                        
                            78
                            ## Rules
                        
                            79
                            - Report values you actually read; if a selector is missing, say so.
                        
                            80
                            - Never print the API key, connectUrl or liveViewUrl in your output.
                        
                            81
                            - Keep one session per task; do not open a new one for every step.
                        
                            82
                            - Ask before spending traffic on pages the task does not need.
                        

Повний промпт · рядків: 82 · без коду

Навіщо ШІ-агентам повноцінний хмарний браузер

Агент, який бачить лише сирі HTTP-відповіді, працює наполовину наосліп. Більша частина корисного вебу сьогодні — дашборди, результати пошуку, усе, що закрите логіном, — рендериться через JavaScript, а звичайний HTTP-запит цієї частини ніколи не бачить.

Натомість дайте тому самому агентові справжній браузер, і він перестане гадати, що, імовірно, містить сторінка. Він бачить реальний відрендерений макет, проходить DOM так, як рухався б курсор людини, і може клікати, прокручувати чи вводити текст так само, як тестувальник під час ручної перевірки.

Саме ця відмінність відокремлює кращі хмарні браузери для ШІ від простої обгортки для скрапінгу: обгортка передає моделі сиру розмітку й сподівається на краще, а браузер дає їй щось ближче до очей і рук безпосередньо на сторінці.

Сесія агента
  1. Агент / LLM Інструменти MCP
  2. Хмарний браузер
  3. Цільовий сайт клік · введення · читання
  4. Дані / дія markdown

Можливості для агентних робочих процесів

Хмарний браузер для агентів має виконувати одразу три різні завдання: взаємодіяти з рівнем інструментів моделі, повертати дані, які модель справді може використати, і виконувати кроки, які вирішив зробити агент.

Нативна інтеграція з MCP і фреймворками LLM

Floppydata надає MCP-сервер, який дає агентові невеликий набір інструментів під конкретні завдання — отримання веб-даних, створення проксі-підключень, перевірка балансу акаунта — за одним API-ключем, тож моделі не потрібно запам’ятовувати ендпоінти чи заголовки.

Для самого перегляду — кліків, заповнення полів, виконання багатокрокового сценарію — агент підключається до сесії хмарного браузера так само, як будь-який скрипт Playwright чи Puppeteer, через підписаний WebSocket URL. Будь-який фреймворк, що вже вміє керувати локальним браузером Playwright, зазвичай може спрямувати ту саму логіку на віддалений браузер без значних переробок.

Вилучення чистих даних (Markdown / JSON для промптів)

Сирий HTML швидко з’їдає контекстне вікно: теги скриптів, вбудовані стилі, навігаційні меню — ніщо з цього не відповідає на питання, яке розв’язує агент. Спрощення сторінки до markdown або структурованого блоку JSON зберігає придатність даних і не витрачає токени на оздоблення, якого ніхто не просив.

Які саме формати виводу доступні, залежить від ендпоінта, що виконує запит, тож перш ніж будувати конвеєр навколо одного формату, варто звіритися з актуальною документацією API щодо наявних варіантів markdown або JSON.

Виконання багатокрокових сценаріїв (кліки, форми, пошук)

Після підключення агент не обмежений читанням однієї сторінки. Він може переходити між сторінками, заповнювати форму, надсилати пошуковий запит, чекати на результати й читати наступну сторінку — усе в межах однієї безперервної сесії, де cookie та стан сторінки автоматично переносяться між кроками.

Стійкість: тривалі сесії та збереження контексту

Завдання агентів рідко завершуються одним запитом. Дослідницьке завдання може послідовно відкрити десяток вкладок зі сторінками; оформлення замовлення може вимагати кількох хвилин очікування між кроками. Сесії можуть тривати годинами, а не секундами, а перепідключення після обриву повертає до того самого браузера, а не до порожньої вкладки.

Крім того, збережені налаштування браузера дають агентові змогу повторно використовувати ту саму ідентичність і стан cookie між окремими запусками. Це важливо для всього, що залежить від збереження входу в акаунт або стабільного фінгерпринта між одним завданням і наступним.

Швидка інтеграція з LangChain, LlamaIndex, Claude

Для цього не потрібен окремий плагін для кожного фреймворку. Оскільки точка підключення — стандартний CDP WebSocket (той самий протокол, який уже використовують Playwright і Puppeteer), будь-який браузерний інструмент LangChain, веб-рідер LlamaIndex чи конфігурацію на кшталт Claude computer use, що вже вміє керувати однією з цих бібліотек, зазвичай можна спрямувати на сесію Floppydata замість локальної, найчастіше замінивши лише один URL підключення.

Для команд, які порівнюють найкращі хмарні браузерні рішення для ШІ-агентів, така сумісність зазвичай важливіша за довгий список функцій: стек агента, який доводиться перебудовувати щоразу, коли змінюється браузерний рівень під ним, гірший за той, що стабільно працює з меншою кількістю рухомих частин.

  • LangChain
  • Claude
  • Playwright
  • Puppeteer
  • MCP
agent.js
import { chromium } from 'playwright';const browser = await chromium.connectOverCDP(connectUrl);const page = browser.contexts()[0].pages()[0];await page.goto('https://example.com');

Що варто перевірити, перш ніж обирати провайдера для таких навантажень

Серед найкращих хмарних браузерів для навантажень ШІ ці три відповіді на практиці зазвичай важать більше за будь-який окремий показник бенчмарка.

Дізнайтеся про інші рішення хмарного браузера