use-native-edge-browser-harness

Control native Microsoft Edge browsing with an existing login profile via CDP.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/Pans0020/opencode-skills --skill use-native-edge-browser-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-native-edge-browser-harness
Source: https://github.com/Pans0020/opencode-skills/tree/main/use-native-edge-browser-harness
Command: npx skills add https://github.com/Pans0020/opencode-skills --skill use-native-edge-browser-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a reliable way to control a browser session using native Microsoft Edge login state on the Windows machine, especially when Browser Harness reconnects fail or it falls back to an unintended local Chrome mode.

Core Features & Use Cases

  • Native Edge login state by default: Reuse the real Edge profile so pages requiring login, especially Xiaohongshu/小红书, work without re-authentication.
  • CDP/Browser Harness recovery: Detect stale or unreachable 9222 and restart Edge, clean stale daemon files, and reconnect Browser Harness using the correct WebSocket endpoint.
  • Operational guardrails: Avoid opening an isolated profile unless explicitly requested; verify connectivity using /json/version and confirm final navigation state via MCP page info.
  • Login/QR handoff with evidence: When QR login is required, capture a screenshot of the QR state and return it to the user so login can be completed from chat.
  • When MCP tools are unavailable: Offer a direct run.py fallback workflow for browsing via CDP without relying on preloaded MCP browser tools.

Quick Start

Tell the AI: “Use the native Edge browser harness (keep my login state) to open https://www.xiaohongshu.com/ and verify the page.”

Frequently Asked Questions about use-native-edge-browser-harness

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

FAQPage Schema
How do I use my existing Microsoft Edge login profile with browser harness?

To use your native Edge login profile with browser harness, connect to Edge CDP on port 9222 and extract the WebSocket endpoint from http://127.0.0.1:9222/json/version. This reuses your authenticated session for tasks like opening Xiaohongshu.

Why does browser harness fall back to local Chrome instead of using Edge?

Browser harness falls back to local Chrome when the Edge CDP connection on port 9222 is stale or unreachable. You must restart Edge and clear bu-default.* daemon files to force browser harness to reconnect to the native Edge profile.

How do I handle QR login when controlling Edge via CDP?

To handle QR login via CDP, the browser harness detects the QR login state on the page, captures a screenshot of the QR code, and returns it to you in chat. This allows you to complete the scan without leaving the automation workflow.

Can I browse authenticated websites like Xiaohongshu without MCP tools?

Yes, you can browse authenticated websites like Xiaohongshu without MCP tools by using a direct run.py fallback workflow. This script controls web browsing via the CDP WebSocket endpoint without relying on preloaded MCP browser tools.

What to do when Edge CDP on port 9222 is stale and browser harness reconnect fails?

When Edge CDP on port 9222 is stale and browser harness reconnect fails, restart the native Edge browser and clear the bu-default.* files. This removes stale daemon states and allows a fresh CDP connection for page inspection.