dsh-plugin-browser
Native Headless & Visible Web Browser Automation Agent Plugin for DeepSeek Harness (dsh)
dsh-plugin-browser empowers DeepSeek Harness agents with native web browsing, live page content extraction, DOM parsing, form interaction, and visual screenshot verification.
Features
- 🌐 Web Navigation & Exploration: Navigate to any public or internal website URL.
- 📄 Semantic Markdown & Link Extraction: Convert complex HTML pages into clean, token-efficient Markdown.
- 📸 Visual Screenshots: Capture high-resolution visual snapshots for multi-modal verification.
- 💻 CLI Utility (
dsh-browser): Direct terminal commands (open, extract, screenshot).
- 🧩 Cordis Native: Automatically exposes
browser_navigate, browser_extract, and browser_screenshot tools.
Installation
# Add from GitHub
dsh plugin --profile web add "github:menotbobbybrown/dsh-plugin-browser"
CLI Usage
# Navigate to a URL and inspect HTTP status
npx dsh-browser open https://news.ycombinator.com
# Extract clean Markdown and hyperlinks
npx dsh-browser extract https://github.com/deepseek-ai/deepseek-harness
# Capture a screenshot
npx dsh-browser screenshot https://github.com my_screenshot.png
Programmatic Usage (Cordis API)
import { Context } from 'cordis';
import * as BrowserPlugin from 'dsh-plugin-browser';
const ctx = new Context();
ctx.plugin(BrowserPlugin);
// Navigate to a URL
await ctx.browser.navigate('https://deepseek.com');
// Extract clean markdown
const { markdown, links } = await ctx.browser.extract();
// Capture screenshot
const screenshot = await ctx.browser.screenshot();
License
MIT © DeepSeek Harness Community
🤝 Contributing
Contributions are warmly welcome! Whether you are reporting an issue, proposing an adapter, optimizing performance, or fixing a bug, please check out our Contributing Guide.
- Fork the Project
- Create your Feature Branch (
git checkout -b feat/AmazingFeature)
- Commit your Changes (
git commit -m 'feat: add some AmazingFeature')
- Push to the Branch (
git push origin feat/AmazingFeature)
- Open a Pull Request
📄 License & Community
Distributed under the MIT License. See LICENSE for more information.
Built with 💙 for the DeepSeek Harness community.
