periscope

periscope

面向 macOS 上 AI Agent 的命令行浏览器。它运行 Safari 的引擎（WebKit）， 因此网站看到的是普通的 Safari，并且会在命令之间保持会话开启。

periscope navigate https://books.toscrape.com/ --session demo
periscope text --session demo        # the page as markdown
periscope extract --session demo     # the page's records as JSON
periscope click "text:Next" --session demo

安装

brew install oskar-szulc/tap/periscope
periscope install-skill    # adds the agent skill to this project

不使用 Homebrew：curl -fsSL https://raw.githubusercontent.com/oskar-szulc/periscope/main/install.sh | sh

如需从源代码构建（Xcode 26）：运行 swift build -c release，然后将 .build/release/periscope 复制到 PATH 中的某个位置。

面向 Agent

• Claude Desktop： 从最新版本下载 periscope-<version>.mcpb 并打开
• Claude Code： 运行 /plugin marketplace add oskar-szulc/periscope，然后运行 /plugin install periscope@periscope
• Codex、Cursor 等： 运行 npx skills add oskar-szulc/periscope
• MCP 客户端： 在 MCP Registry 中列为 io.github.oskar-szulc/periscope；命令为 periscope mcp，例如 claude mcp add periscope -- periscope mcp，或者在 JSON 配置中写入：{"mcpServers": {"periscope": {"command": "periscope", "args": ["mcp"]}}}
• 任何可使用 shell 的 Agent： 运行 periscope docs 可查看完整参考文档

阅读网页

命令	返回内容	用途
text	网页的主要内容，以 Markdown 格式呈现，并包含链接	阅读文章或帖子
state	URL、标题、标题层级、内容开头，以及每个可点击元素及其选择器和编号（@3）	决定下一步点击或填写什么
extract	JSON：网页中的重复条目（卡片、结果、表格行）、结构化数据和下一页链接	抓取职位、商品或搜索结果列表
links	网页上的所有链接，均为绝对 URL（使用 --match 进行筛选）	收集要访问的 URL
screenshot	网页显示效果的 PNG 图像	查看布局或检查视觉内容

还能做什么

• 操作： 使用 click、fill、type、select、scroll、mouse，按 CSS 选择器或用户可见内容定位（text:Next、label:Email）
• 保持登录状态： 命名会话会持续保留；login 和 show 可让你接管窗口
• 识别拦截： 遇到 CAPTCHA 和机器人检测页面时，会以代码 5 退出

完整参考文档：PERISCOPE.md。了解构建原因和过程：构建 periscope。

要求

• macOS 26 或更新版本；需要处于已登录的桌面会话中，且显示屏处于开启状态
• 不可在 shell 沙箱中运行（如果处于沙箱中，periscope 会退出并显示提示信息）

许可证

MIT。贡献方式：参见 CONTRIBUTING.md。由 Oskar Szulc 制作。