periscope

periscope

macOS 上で AI エージェントが使うコマンドラインブラウザーです。Safari のエンジン（WebKit）を実行するため、Web サイトには通常の 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 上にコピーしてください。

エージェント向け

• 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"]}}} を指定します
• シェルを使えるエージェント： periscope docs でリファレンス全体を表示できます

ページを読む

コマンド	戻り値	用途
text	リンクを含む、ページの主要コンテンツの Markdown	記事や投稿を読む
state	URL、タイトル、見出し、コンテンツの冒頭、セレクターと番号（@3）が付いたクリック可能な要素すべて	次にクリックまたは入力する場所を判断する
extract	JSON：ページ内で繰り返される項目（カード、結果、テーブル行）、構造化データ、次ページへのリンク	求人、商品、検索結果などの一覧をスクレイピングする
links	ページ上のリンクすべてを絶対 URL として取得（--match でフィルター）	次にアクセスする URL を収集する
screenshot	ページの表示状態を PNG で取得	レイアウトや視覚的な内容を確認する

その他にできること

• 操作する： CSS セレクター、または人が目にする要素（text:Next、label:Email）を指定して、click、fill、type、select、scroll、mouse を実行します
• ログイン状態を維持する： 名前付きセッションは保持されます。login と show を使うと、ウィンドウを引き継いで操作できます
• ブロックを検知する： CAPTCHA やボットチェックのページでは、終了コード 5 で終了します

リファレンス全体：PERISCOPE.md。開発の背景と方法：periscope の構築。

要件

• macOS 26 以降。ログイン済みのデスクトップセッションで、ディスプレイがオンになっていること
• シェルサンドボックス内では実行できません（その場合、periscope はメッセージを表示して終了します）

ライセンス

MIT。コントリビューションについては、CONTRIBUTING.md をご覧ください。Oskar Szulc 制作。