BrowserKitten README

The project's README from github.com/Player-YN/BrowserKitten. As one markdown file: README.md.

爪爪 · PawWork

English · 中文

license last commit JavaScript Chrome MV3 unpacked

Treat the already-logged-in Chrome as a programmable computer. 爪爪 is the agent on that machine.

sidepanel → service worker → offscreen agent · tools: action · run+sys · sheet / doc / web

What you get · Run it · Limits · Use cases · Mechanism · Next

爪爪 · 完全解放版: the already-logged-in Chrome is a programmable computer. 爪爪 is the agent on that machine.

爪爪 · 完全解放版 (PawWork_ZhuaZhua) is a Chrome MV3 unpacked extension. Not a selection widget. Not a Chrome Web Store app.

What you get

An unpacked side-panel agent that can operate the current tab, run guest JS against the browser (sys inside run), and keep sheet / Univer doc / site HTML in the session.

Logged-in Chrome shop tab as the machine. The 爪爪 side panel docks onto it after you load this folder unpacked.

Anything a Tampermonkey userscript could do is in scope. There is no userscript store. One packaged playbook ships: page-restyle.

Run it

You should see a side-panel agent named 爪爪 · 完全解放版. There is no Chrome Web Store listing.

  1. Download the Release zip or clone this repo and use the extension/ folder
  2. Chrome → chrome://extensions → Developer mode → Load unpacked → select that folder (manifest.json is at its root)
  3. Open the side panel → paste a BYOK key (pagewand_providers) → send a task on a normal http(s) page

After you edit files in the load folder, click 重新加载 on the extension card. No daily npm.

Limits

These change whether you load it, and what the first task can touch.

Need Chrome 135+. Chrome 138+: extension details → Allow User Scripts if you need sys.eval / page fetch. Close F12 on the target tab before CDP (CDP_BUSY). Restricted pages (chrome://, Web Store) return NEED_PAGE.

If you wanted What exists
CWS install No. Unpacked only.
Hosted model No. BYOK.
A Tampermonkey catalog No. Skill: page-restyle.
chrome:// / Web Store pages NEED_PAGE.

Use cases

Tried and plausible — not a benchmark list, not a store.

Six jobs: restyle versus clutter, logged-in scrape into a grid, form fill with action refs, page-identity download, tab batch and SPA navigate, reading-aid overlay.

Mechanism

Live-page action snapshot with ref chips, run plus sys.fetch as page writing a CSV, and sheet, doc, and site canvases. Plan card is session-only.

Side panel → service worker → offscreen SessionWorkspaceService → AI SDK ToolLoopAgent.

You call It does
action Live tab. snapshot, then mutate with that generation’s ref + rev
run Sandbox JS. Guest sys: tabs, eval, fetch, cdp, download, screenshot
sheet / doc / web Univer table, Univer document, data-paw-kind=site
inspect / acquire / clarify Read the session, bring public web in, pause for a question or plan

sys is not a model tool. Login / cookies / captcha: sys.fetch({ as: "page" }) inside run.

Next

Architecture and tool contracts: AGENTS.md. 中文首页：README.zh-CN.md.

node --test tests/runtime-regression.test.mjs

License

MIT.

BrowserKitten (Player-YN/BrowserKitten)

Searching Database…

2.4K ·GitHub
BrowserKitten
Что это?BrowserKitten (爪爪 / PawWork) — Chrome-агент в боковой панели, обращающийся с вашим уже залогиненным браузером как с программируемым компьютером: вы выделяете что-то на живой странице, описываете желаемый результат, а он возвращает редактируемую таблицу, документ Univer или снимок страницы.
Это приложение из Chrome Web Store или что-то другое?Это распакованное расширение Chrome MV3, которое вы загружаете сами через режим разработчика, а не что-то установленное из Chrome Web Store.
Как это запустить?Скачайте Release zip или склонируйте репозиторий, укажите Chrome на папку extension/, затем загрузите её как распакованное расширение через chrome://extensions → Режим разработчика → Загрузить распакованное и откройте боковую панель.
Нужен ли API-ключ для работы?Да — это BYOK, так что вы вставляете свой API-ключ провайдера прямо в боковую панель; также нужен Chrome 135+ (138+ для включения «Allow User Scripts» ради sys.eval/получения страниц).
Что с этим работать не будет?Ограниченные страницы вроде chrome:// URL или Web Store возвращают ошибку NEEDPAGE и автоматизации не поддаются, а перед работой CDP-подключения агента нужно закрыть DevTools (F12) на целевой вкладке.
Что он реально умеет из коробки?В комплекте один упакованный playbook — page-restyle — плюс показанные сценарии: скрейпинг залогиненной страницы в таблицу, автозаполнение форм, скачивание файлов под вашей страничной аутентификацией, пакетная обработка вкладок и внедрение помощников для чтения.
Как агент устроен под капотом?Запросы идут из боковой панели в service worker, затем в offscreen SessionWorkspaceService на базе AI SDK ToolLoopAgent, который вызывает 'action' (снимок/мутация живой вкладки), 'run' (песочничный JS с sys-хелперами для tabs/eval/fetch/cdp/download/screenshot) и инструменты sheet/doc/web на базе Univer.
Почему этого нет в Chrome Web Store?Он сознательно сделан только как распаковываемый, без хостед-модели и каталога юзерскриптов — BYOK по замыслу: удобство магазина обменяно на полный контроль над тем, что агенту разрешено выполнять.
Какие файлы задача возвращает по итогу?В зависимости от задачи он возвращает редактируемую таблицу или документ Univer либо захваченный HTML-снимок сайта, так что задача браузера заканчивается тем, что можно продолжать редактировать.
What are similar projects?nanobrowser, stagehand, integrity_baozi-, automa, ai-newtab, bb-browser, jev-ultrafast, chatGPTBox
Which topics is it in?browser-agent, pptx, extension, byok, chrome-extension, browser-extension, web-scraping, sandbox, browser-automation, browser, ai-agent, productivity
Creator
Player-YN
Size
17.4 MB
Stars
2.4K
Updated
CommitSep 17Releasev1.1.0Sep 16
Age
1mo
Commits · 90 Days