什么是 OmniScout?
OmniScout — 面向 AI agent 的本地优先浏览器控制、语义搜索与研究工具。
OmniScout 是一个自包含的终端原生网页接口:AI agent 的本地浏览器大脑。它搜索网页、提取结构化数据、控制真实浏览器、自动化桌面应用并记住一切 — 全程不离开你的笔记本。
各部分如何协同
- CLI — 你(或你的 agent)键入的
omniscout命令。每个命令都会说 JSON。 - Daemon —
127.0.0.1:7720上的常驻后台进程,让浏览器保持热启动,操作亚秒级完成。 - 后端 — Patchright(默认,隔离 Chromium)或驱动已有浏览器的扩展(使用真实登录态)。
完整图景见工作原理:@eN ref、会话、profile、操作历史与事件流。
安装
pip install omniscout
omniscout install --skill完整配置 — 浏览器、daemon、模型 — 见安装。5 分钟 tour 见快速上手。
能做什么
| 领域 | 命令 | 指南 |
|---|---|---|
| 带引用的问答 | answer | 搜索与问答 |
| 排序后的网页结果 | search、map | 搜索与问答 |
| 页面 → Markdown/JSON | extract | 提取 |
| 多源研究 | research、graph | 研究与图谱 |
| 浏览器控制 | browser、open、snapshot | 浏览器自动化 |
| 桌面自动化(macOS) | computer | Computer |
| 后台服务 | daemon、session、profile | Daemon 与会话 |
| 个人网页记忆 | remember、memory、index | 记忆 |
| 可复用流程 | record、macro、replay、workflow、monitor | 工作流 |
| 配置与调优 | install、setup、settings、warmup、benchmark | 配置 |
设计原则
- 本地优先 — 无云端账号、API key 与托管服务。状态、embedding 与记忆都留在本机;唯一的出站流量是你运行的搜索与抓取的 URL。
- Agent 就绪 — 处处
--json、稳定的@eN元素 ref、可记录的操作历史(含 trace/replay),以及 Claude Code、Cursor、Codex 与 Gemini CLI 的技能文件。 - 真实浏览器 — 你的 Chromium、你的 cookie、你的扩展。用 profile 登录一次,永久复用。
使用
# Start the daemon (once)
omniscout daemon start
# Search the web
omniscout answer "what is the capital of france"
# Extract content from a URL
omniscout extract https://example.com
# Control a browser
omniscout browser navigate https://example.com
omniscout browser snapshot --refs-only
omniscout browser click '@e3'
omniscout browser screenshot --out /tmp/page.png
# Research a topic
omniscout research "AI agents in 2026"
# Build a knowledge graph
omniscout graph "Cursor"下一步
- 安装 — 依赖、浏览器、daemon、模型
- 快速上手 — 五分钟首次运行
- 与 AI agent 配合使用 — Claude Code、Cursor、Codex 的即用提示词
- 命令参考 — 每个动词、每个 flag
- 示例与配方 — 常见工作流