Як використовувати AdsCrawl з browse.sh: робочі процеси AI-браузера
Швидкий огляд
Дізнайтеся, як поєднати API автоматизації браузера AdsCrawl із навичками browse.sh, щоб надати AI-агентам надійні, повторно використовувані веб-процеси в масштабі.
Як використовувати AdsCrawl з browse.sh: робочі процеси AI-браузера
AI-агенти добре міркують, але ненадійно клікають. AdsCrawl надає їм справжній хмарний браузер із проксі та сесіями; browse.sh надає їм каталог готових рецептів для конкретних сайтів. Використані разом, вони дають повторювану автоматизацію, яка витримує сторінки з великою кількістю JavaScript, географічні обмеження та дрейф селекторів. Ця стаття пояснює робочий процес, налаштування та де комбінація дає переваги.
Що робить кожен інструмент

Скріншот першого екрана сайту browse.sh.
AdsCrawl — це API автоматизації браузера та платформа хмарного браузера. Він надає синхронні кінцеві точки для відрендереного HTML, Markdown, скріншотів і вилучення SPA, а також віддалені сесії Chromium із збереженням стану, які підключаються до Playwright, Puppeteer або клієнтів raw CDP. Він керує ідентичністю браузера, випадковими User-Agent, довіреними та резидентними проксі, а також динамічною маршрутизацією за регіонами. Ви можете зберігати профілі хмарного браузера з управлінням життєвим циклом і спостерігати за сесіями в інтерактивному переглядачі.
browse.sh — це відкритий каталог навичок автоматизації браузера для веб-сайтів, що поєднується з CLI браузера, створеним для AI-агентів. Кожна навичка — це рецепт SKILL.md, який навчає агента, як виконати завдання на домені — наприклад, порівняти плани ACA або знайти маршрути потягів. Навички кодують запропоновані DOM-селектори та XHR-запити, що, за словами каталогу, скорочує витрати токенів у 50 разів. Ви встановлюєте їх за допомогою CLI browse:
npm i -g browse
browse skills add alltrails.com
browse skills add healthcare.gov/compare-plans-ruai96
CLI об'єднує навички, примітиви браузера, налагодження та хмарні сесії в одному інструменті.
Чому їх варто поєднувати

Скріншот першого екрана сайту browse.sh.
browse.sh каже агенту, що робити на сайті; AdsCrawl визначає де і як працює браузер. Цей поділ вирішує три поширені проблеми:
- Опір антибот-захисту. Резидентні проксі та регіональна маршрутизація AdsCrawl дозволяють навичці працювати з географії, яку очікує цільовий сайт.
- Безперервність сесії. Навички, які потребують автентифікованого стану, можуть повторно використовувати профіль хмарного браузера AdsCrawl із збереженими cookie замість повторної автентифікації під час кожного запуску.
- Дрейф селекторів. Коли запропоновані селектори навички ламаються, ви можете повернутися до вилучення SPA або відрендереного HTML AdsCrawl, щоб відновити дані без переписування всього рецепта.
Попередні вимоги
Перш ніж почати, вам потрібно:
- Обліковий запис AdsCrawl із ключем API з панелі керування.
- Встановлений Node.js, щоб запускати CLI browse.
- AI-агент або асистент із програмуванням, який може виконувати команди оболонки та викликати HTTP-кінцеві точки.
AdsCrawl пропонує 500 безкоштовних кредитів під час реєстрації, чого достатньо, щоб перевірити робочий процес перед переходом на платний план.
Покрокове налаштування

browse.sh — open catalog of browser automation skills.
1. Встановіть CLI browse та навичку
npm i -g browse
browse skills add alltrails.com
Перегляньте каталог за доменом, навичкою, методом або регіоном, щоб знайти рецепт, що відповідає вашому завданню. Багато навичок є лише для читання та аналізують публічні API або серверний HTML, що робить їх початковими точками з низьким ризиком.
2. Перевірте свої облікові дані AdsCrawl
Надішліть мінімальний запит, щоб підтвердити, що ключ працює:
curl --fail-with-body -sS \
-X POST "https://api.adscrawl.net/html" \
-H "x-api-key: $ADSCRAWL_API_KEY" \
-H "content-type: application/json" \
-d '{
"url": "https://www.adscrawl.net",
"contentMode": "html",
"waitUntil": "domcontentloaded"
}' \
--output page.html
Якщо ви віддаєте перевагу виводу Markdown, встановіть contentMode на markdown.
3. Спрямуйте навичку на сесію AdsCrawl
Для навичок, які потребують взаємодії, створіть сесію CDP і підключіть свій клієнт автоматизації до повернутого webSocketDebuggerUrl. Для навичок, яким потрібен лише вміст сторінки, спрямуйте їх через кінцеві точки /html або /spa-extract. Огляд API використання браузера пояснює, як рендеринг, вилучення та управління сесіями поєднуються.
4. Додайте проксі та регіональну маршрутизацію
Якщо цільовий сайт блокує ваш регіон за замовчуванням, налаштуйте проксі в запиті AdsCrawl. Кожен запуск Cloud Browser вимагає дійсного проксі, і облікові дані належать до визначених полів, а не до URL-адреси проксі-сервера. Для детальнішого посібника див. як використовувати AdsCrawl з Proxidize.
5. Запускайте, перевіряйте та повторюйте
Виконайте навичку через свого агента, потім перевірте вивід. Сторінки навичок browse.sh містять записи відтворення та повний SKILL.md, тож ви можете порівняти очікувану поведінку з тим, що сталося насправді. Якщо селектор не працює, перевірте missingFields у відповіді AdsCrawl, щоб побачити, які поля не знайдено.
Практичні приклади

Скріншот першого екрана сайту browse.sh.
Приклад 1: Порівняння планів здоров'я ACA
Навичка, як-от healthcare.gov/compare-plans-ruai96, кодує кроки навігації та вилучення для порівняння планів. Запустіть її через сесію AdsCrawl у правильному регіоні США, щоб сайт надавав правильний вміст. Агент дотримується селекторів навички, а AdsCrawl керує рендерингом та ідентичністю проксі.
Приклад 2: Відстеження цін на авіаквитки в різних регіонах
Навичка відстеження рейсів може запитувати сайт авіакомпанії, але ціни часто відрізняються залежно від точки продажу. Запускайте сесії AdsCrawl у різних регіонах і виконуйте ту саму навичку для кожного. Збирайте результати в один набір даних для порівняння.
Приклад 3: Читання маршрутів громадського транспорту та потягів
Багато навичок транзиту є лише для читання та аналізують серверний HTML. Вони ідеально підходять для кінцевої точки /html AdsCrawl: інтерактивна сесія не потрібна, і ви можете пакетно обробляти запити в масштабі.
Приклад 4: Автентифіковані робочі процеси
Для завдань, які потребують автентифікованого облікового запису, збережіть профіль хмарного браузера AdsCrawl після ручного входу, а потім повторно використовуйте його. Використовуйте cookie лише для облікових записів, до яких ви маєте право доступу, і перевіряйте домен, шлях і термін дії перед кожним запуском.
Рекомендації щодо вибору: коли використовувати який рівень
| Потреба | Використовуйте навичку browse.sh | Використовуйте AdsCrawl безпосередньо |
|---|---|---|
| Відомий сайт із опублікованим рецептом | Так | Як рівень виконання |
| Новий або невказаний сайт | Ні | Так, з /spa-extract або CDP |
| Вміст із географічними обмеженнями | Так, з регіональною маршрутизацією | Так |
| Високооб'ємне вилучення лише для читання | Так | Так, через /html або /spa-extract |
| Багатокроковий автентифікований процес | Так, зі збереженим профілем | Так, через сесію CDP |
Якщо ви ще оцінюєте сам браузерний рівень, порівняння AdsCrawl vs Playwright vs Stagehand охоплює контроль, керовану інфраструктуру та відповідність AI-агенту.
Поширені помилки та виправлення
- Тайм-аути. Сторінка може бути повільною, проксі недоступним, або очікуваний селектор ніколи не з'являється. Перевірте відповідь із помилкою, переконайтеся в правильності URL-адреси та проксі, потім скоригуйте умову очікування.
- HTTP 402. У вас закінчилися кредити. Перевірте баланс і план у панелі керування.
- HTTP 429. Ви досягли обмеження швидкості. Знизьте паралелізм і повторіть спробу з затримкою.
- Переглядач залишено відкритим. Закриття інтерактивного переглядача не зупиняє Cloud Browser. Викличте кінцеву точку зупинки та переконайтеся, що
runtime.statusмає значенняstopped.
Пов'язане читання
- AdsCrawl vs Parse: автоматизація браузера проти API веб-сайтів - Порівняйте AdsCrawl і Parse: API автоматизації браузера проти готових API веб-сайтів. Дізнайтеся, який підходить для динамічного скрейпінгу, автентифікованих сесій і масштабування.
- Огляд Octoparse: тестування та пояснення скрейпінгу без коду - Огляд Octoparse на основі доказів, що охоплює ідеальних користувачів, варіанти використання, переваги, обмеження, ціноутворення, налаштування та критерії вибору для веб-скрейпінгу без коду.
Джерела та додаткове читання
- AdsCrawl MCP Server | Awesome MCP Servers - Хостинговий хмарний браузер, автоматизація браузера та вилучення веб-даних для розробників і AI-агентів. Перегляньте AdsCrawl MCP Server для Claude, Cursor, VS Code та...
- Browser Use MCP Server | Awesome MCP Servers - MCP-сервер, який дозволяє AI-агентам керувати веб-браузером за допомогою бібліотеки browser-use. Перегляньте Browser Use MCP Server для Claude, Cursor, VS Code та...
- Chrome MCP Server | Awesome MCP Servers - Керуйте браузером Chrome через Chrome DevTools Protocol (CDP) з клієнтів MCP для перегляду, інспекції та робочих процесів автоматизації.
Часті запитання
Чи потрібен мені browse.sh, якщо AdsCrawl уже рендерить сторінки?
Ні. AdsCrawl сам може рендерити, вилучати та автоматизувати. browse.sh додає повторно використовувані рецепти для конкретних сайтів, які зменшують обсяг інженерії підказок і роботи з селекторами, потрібних вашому агенту.
Чи можу я використовувати навички browse.sh без AdsCrawl?
Так. CLI browse включає примітиви браузера та хмарні сесії. AdsCrawl стає корисним, коли вам потрібні керовані проксі, регіональна маршрутизація, збережені профілі або високооб'ємне вилучення.
Чи безпечно запускати навички browse.sh?
Багато з них лише для читання та аналізують публічні API або серверний HTML. Перегляньте SKILL.md перед запуском будь-якої навички, яка виконує записи, бронювання або подання.
Як налагодити навичку, що не працює?
Порівняйте запис відтворення навички з вашим запуском, перевірте missingFields у відповіді AdsCrawl і огляньте відрендерений HTML, щоб побачити, чи змінився DOM.
Чи може мій агент із програмуванням налаштувати AdsCrawl за мене?
Так. AdsCrawl публікує підказку для налаштування агентом, яка проводить через реєстрацію, авторизацію ключа API та інтеграцію. Ви схвалюєте доступ у своєму браузері.
Висновок
AdsCrawl і browse.sh вирішують різні половини однієї проблеми. browse.sh надає знання про конкретний сайт; AdsCrawl надає браузер, ідентичність і масштаб. Почніть з однієї навички лише для читання, перевірте її через кінцеву точку /html, потім додайте проксі та збережені профілі в міру зростання ваших робочих процесів. Для ширшого огляду ландшафту інструментів див. провідні платформи AI для веб-скрейпінгу та моніторингу.
