surfer

Execute JavaScript in the active Chrome tab via macOS AppleScript.

2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/samdengler/guppi-skills --skill surfer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surfer
Source: https://github.com/samdengler/guppi-skills/tree/main/surfer
Command: npx skills add https://github.com/samdengler/guppi-skills --skill surfer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to automate interactions with web pages directly within your active Chrome browser tab using JavaScript, without complex setups like Chrome DevTools Protocol.

Core Features & Use Cases

  • Execute JavaScript: Run any JavaScript code in the context of the currently active Chrome tab.
  • Extract Data: Easily pull specific information (like titles or element content) from a webpage.
  • Automate Simple Actions: Perform basic browser interactions like clicking or filling forms (future capability).
  • Use Case: You need to quickly grab the title of the current webpage or extract the text from a specific heading.

Quick Start

Use the surfer skill to run the JavaScript command document.title in the active Chrome tab.

Frequently Asked Questions about surfer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute JavaScript in an active Chrome tab for web scraping on macOS?

You can execute JavaScript in an active Chrome tab on macOS by using AppleScript to run web scraping commands within the current browser window without needing a headless setup. This allows you to extract titles or element content from authenticated pages.

Can I automate web scraping without a headless browser using my existing Chrome session?

Yes, you can automate web scraping without a headless browser by executing JavaScript directly in your active Chrome tab. This approach bypasses complex setups like Chrome DevTools Protocol to interact with authenticated web pages.

Do I need to enable specific Chrome settings to allow JavaScript automation via AppleScript?

Yes, to allow JavaScript automation via AppleScript, you must enable the 'Allow JavaScript from Apple Events' setting in Chrome. This macOS-specific configuration is required for the browser to accept and execute the injected scripts.

What kind of browser automation tasks can I perform using JavaScript in Chrome?

You can perform browser automation tasks like web scraping, simple form automation, and data extraction using JavaScript in Chrome. It enables you to pull specific information such as webpage titles or heading text from the active tab.

Does this approach work on operating systems other than macOS?

No, this approach is scoped exclusively to macOS environments because it relies on AppleScript to bridge the communication and execute JavaScript within the active Chrome browser tab.