English Français العربية

periscope

السجل الرسمي البحث والويب

A real Safari-engine (WebKit) browser for agents on macOS: sessions, extraction, bot checks.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

MCPB package https://github.com/oskar-szulc/periscope/releases/download/v0.2.5/periscope-0.2.5.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. periscope
  2. Install
  3. Reading a page
  4. What else you can do
  5. Requirements
  6. License

periscope

A command-line browser for AI agents on macOS. It runs Safari's engine (WebKit), so websites see a normal Safari, and it keeps sessions open between commands.

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

Install

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

Without Homebrew: curl -fsSL https://raw.githubusercontent.com/oskar-szulc/periscope/main/install.sh | sh

To build from source instead (Xcode 26): swift build -c release, then copy .build/release/periscope onto your PATH.

For agents
  • Claude Desktop: download periscope-<version>.mcpb from the latest release and open it
  • Claude Code: /plugin marketplace add oskar-szulc/periscope, then /plugin install periscope@periscope
  • Codex, Cursor and others: npx skills add oskar-szulc/periscope
  • MCP clients: listed in the MCP Registry as io.github.oskar-szulc/periscope; the command is periscope mcp, e.g. claude mcp add periscope -- periscope mcp, or in a JSON config: {"mcpServers": {"periscope": {"command": "periscope", "args": ["mcp"]}}}
  • Any agent with a shell: periscope docs prints the full reference

Reading a page

CommandReturnsUse it to
textThe page's main content as markdown, links includedRead an article or a post
stateURL, title, headings, the start of the content, and every clickable element with a selector and a number (@3)Decide what to click or fill next
extractJSON: the page's repeated items (cards, results, table rows), its structured data, and the next-page linkScrape a list of jobs, products or results
linksEvery link on the page as an absolute URL (--match to filter)Collect URLs to visit next
screenshotA PNG of the page as displayedSee the layout, or check visual content

What else you can do

  • Act: click, fill, type, select, scroll, mouse, targeting CSS or what a person sees (text:Next, label:Email)
  • Stay logged in: named sessions persist; login and show let you take over the window
  • Know when you're blocked: CAPTCHA and bot-check pages exit with code 5

Full reference: PERISCOPE.md. Why and how it was built: Building periscope.

Requirements

  • macOS 26 or newer, in a logged-in desktop session with the display on
  • Not inside a shell sandbox (periscope exits with a message if it is)

License

MIT. Contributions: see CONTRIBUTING.md. Made by Oskar Szulc.

الأسئلة الشائعة

ما هو periscope؟

A real Safari-engine (WebKit) browser for agents on macOS: sessions, extraction, bot checks.

كيف أثبّت periscope؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل يحتاج periscope إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل periscope مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون periscope؟

ينشره oskar-szulc. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.