内容
# Owl 浏览器插件，用于 Claude 代码
适用于 Claude 代码的代理原生浏览器自动化。此插件包含：
- **Owl 浏览器 MCP 服务器** (`@olib-ai/owl-browser-mcp`)，它公开浏览器工具并默认为代理原生渲染。
- **一个 `owl-browser` 技能**，教 Claude 观察和行动循环：读取页面作为 **OwlMark**（一种紧凑的、可处理地址的文本渲染），并通过句柄对元素进行操作，而不是截图或像素坐标。
## 为什么
截图对视觉模型来说成本很高，并且仍然无法告诉它点击的位置，因此它会猜测坐标并失误。Owl 以结构化、可处理地址的文本返回页面。在 Hacker News 首页上，这大约是 753 个代币，涵盖 240 个交互元素，而截图则需要大约 1365 个代币。它是一个渲染器，而不是基于正常浏览器的 JavaScript 插件。
## 先决条件
运行中的 Owl 浏览器实例（Docker 或独立）和在启动 Claude 代码之前在 shell 中设置两个环境变量：
```bash
export OWL_API_ENDPOINT="http://localhost:8080" # 或您的 Docker/nginx URL，例如 http://localhost:80
export OWL_API_TOKEN="您的 owl-http-token" # 与服务器上的 OWL_HTTP_TOKEN 匹配
# 可选：要宣传的 MCP 工具集（agent | automation | webdev | full）；默认为 agent
export OWL_MCP_PROFILE="agent"
```
`npx`（Node.js）必须可在 PATH 上用于捆绑的 MCP 服务器。
## 安装
从已发布的市场存储库：
```
/plugin marketplace add Olib-AI/owl-browser-claude-plugin
/plugin install owl-browser@olib-ai
```
然后重启 Claude 代码（或重新加载插件）。`browser_*` 工具和 `owl-browser` 技能变得可用。
## 使用
要求 Claude 在网络上执行任何操作，它将遵循循环：
```
create_context(render_mode=agent) -> navigate(url) -> observe -> click/type(handle) -> observe -> ...
```
查看捆绑的技能 (`skills/owl-browser/SKILL.md`) 以获取完整的工具参考、参数、边缘情况处理和示例。
## 布局
```
.claude-plugin/
plugin.json 插件清单（通过 .mcp.json 捆绑 MCP 服务器）
marketplace.json 市场列表此插件（源 "."）
.mcp.json Owl 浏览器 MCP 服务器注册
skills/
owl-browser/
SKILL.md 代理使用技能
```
## 发布
此目录是一个自包含的市场存储库和插件。要发布到 Claude 插件目录，请将其推送为 git 存储库；用户然后运行 `/plugin marketplace add <owner>/<repo>` 和 `/plugin install owl-browser@olib-ai`。
由 Olib AI 提供。https://www.owlbrowser.net
