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 应用商店里的应用，还是别的东西？它是一个未打包的 Chrome MV3 扩展，需要你自己通过开发者模式加载，不是从 Chrome 应用商店安装的东西。
怎么让它跑起来？下载 Release 压缩包或克隆仓库，在 Chrome 中指向 extension/ 文件夹，通过 chrome://extensions → 开发者模式 → 加载已解压的扩展程序 加载它，然后打开侧边栏。
使用它需要 API 密钥吗？需要——它采用 BYOK（自带密钥）模式，你直接把自己的服务商 API 密钥粘贴进侧边栏即可；此外还需要 Chrome 135 及以上版本（要启用「允许用户脚本」以支持 sys.eval/页面抓取则需 138+）。
有哪些东西它处理不了？chrome:// URL、应用商店等受限页面会返回 NEEDPAGE 错误，无法自动化；而且在智能体的 CDP 连接生效之前，你必须先关闭目标标签页上的 DevTools（F12）。
它开箱即用能做什么？它自带一个打包的 playbook（page-restyle），并演示了若干用例：把已登录页面抓取成表格、自动填写表单、以你的页面身份下载文件、批量处理标签页，以及注入阅读辅助。
智能体底层是怎么工作的？请求从侧边栏流向 service worker，再流向基于 AI SDK ToolLoopAgent 构建的离屏 SessionWorkspaceService，后者调用 'action'（对实时标签页做快照/修改）、'run'（带 sys 辅助函数的沙箱 JS，支持 tabs/eval/fetch/cdp/download/screenshot）以及由 Univer 支撑的 sheet/doc/web 工具。
它为什么不上架 Chrome 应用商店？它刻意做成仅以未打包方式分发，没有托管模型，也没有用户脚本目录——设计上就是 BYOK，用放弃商店的便利来换取对智能体可运行内容的完全控制。
任务最后交回什么类型的文件？视任务而定，它会返回可编辑的 Univer 表格或文档，或捕获的站点 HTML 快照，这样浏览类任务的结果就是你能继续编辑的东西。
What are similar projects?nanobrowser, stagehand, integrity_baozi-, automa, ai-newtab, penguin-harness, jev-ultrafast, bb-browser
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