web-access  by eze-is

AI agent web access and browser automation

Created 1 week ago

New!

1,419 stars

Top 28.2% on SourcePulse

GitHubView on GitHub
Project Summary

This skill enhances Claude Code agents with comprehensive web access and browser automation capabilities, addressing limitations in its native web search and fetch tools. It provides a sophisticated networking strategy, direct browser interaction via Chrome DevTools Protocol (CDP), and accumulates site-specific operational experience. This empowers agents to navigate dynamic web content, perform complex interactions, and execute tasks more effectively, benefiting users who require advanced web data gathering and manipulation.

How It Works

The project integrates a "Web Access Skill" that augments Claude Code's functionality. It employs a multi-tool selection strategy, automatically choosing between WebSearch, WebFetch, curl, Jina, or CDP based on the task context. A key component is the CDP Proxy, which connects directly to a user's Chrome instance, leveraging existing login states and enabling interaction with dynamic web pages, including video frame capture. For multi-target tasks, it utilizes a parallel-by-divide approach, distributing work to sub-agents that share a single proxy with tab-level isolation. Furthermore, it implements site experience accumulation, storing domain-specific operational knowledge (like URL patterns and platform quirks) to improve performance across sessions.

Quick Start & Requirements

Installation can be automated by asking Claude to install the skill from https://github.com/eze-is/web-access. Alternatively, manual installation involves cloning the repository: git clone https://github.com/eze-is/web-access ~/.claude/skills/web-access. For CDP mode, prerequisites include Node.js 22+ and Chrome with remote debugging enabled (accessible via chrome://inspect/#remote-debugging). An environment check script (bash ~/.claude/skills/web-access/scripts/check-deps.sh) is provided. The CDP Proxy API is started using node ~/.claude/skills/web-access/scripts/cdp-proxy.mjs &.

Highlighted Details

  • Automatic, context-aware selection and combination of networking tools (WebSearch, WebFetch, curl, Jina, CDP).
  • CDP Proxy enables direct Chrome interaction, preserving login states and supporting dynamic pages and video frame capture.
  • Supports three click methods: JS click (/click), real mouse event (/clickAt), and file uploads (/setFiles).
  • Parallel execution for multi-target tasks via sub-agents sharing a proxy.
  • Site-specific experience accumulation (URL patterns, known issues) for cross-session reuse.
  • Media extraction (images, videos) and video frame capture capabilities.
  • Recent updates (v2.4) enhance URL reliability, improve interpretation of platform error messages, and add specific site experience for platforms like Xiaohongshu.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or roadmap are present in the provided README.

Licensing & Compatibility

The project is licensed under the MIT license. This license is permissive and generally allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The CDP mode requires specific Node.js and Chrome configurations. The project notes that site-generated links contain full context, while manually constructed URLs may lack necessary parameters, and platform error messages can be misleading regarding content availability. These points highlight potential areas requiring careful handling during agent execution.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
13
Issues (30d)
10
Star History
1,464 stars in the last 9 days

Explore Similar Projects

Feedback? Help us improve.