DeepSeek Harness plugin

dsh-cloudflare-browser-run

DeepSeek Harness plugin: web browsing tools (markdown / screenshot / pdf) powered by Cloudflare Browser Run — real headless Chrome with JS rendering, login sessions and WebMCP support.

Jump to install

Source facts

Repository
RealAlexandreAI/dsh-cloudflare-browser-run
Latest update
Aug 19, 2026
Category
Tools & Capabilities
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/RealAlexandreAI/dsh-cloudflare-browser-run
Plugin: dsh-cloudflare-browser-run
Author: RealAlexandreAI

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

<p align="center"> <img src="assets/readme/hero.svg" alt="dsh-cloudflare-browser-run — real browser access for DeepSeek Harness" width="100%"> </p>

dsh-cloudflare-browser-run

A DeepSeek Harness plugin that gives the agent real browser access: headless Chrome on Cloudflare's network, so JS-rendered pages, screenshots, and PDFs all just work.

> Port of pi-cloudflare-browser-run, built to the dsh (Cordis) plugin spec.

English · 中文

Why

The built-in web_fetch is a plain HTTP fetch — JS pages come back empty and SSRF protection is deferred upstream. This plugin adds a real browser:

  • clean markdown from any public page (SPA/JS included)
  • screenshots (PNG) and PDFs
  • login-capable sessions and WebMCP sites

Quick start

dsh plugin --profile web add dsh-cloudflare-browser-run

Configure credentials in your profile/settings layer:

- id: cloudflare-browser-run
  name: dsh-cloudflare-browser-run
  config:
    cf_api_token: <your token>
    cf_account_id: <your account id>

Token: Cloudflare dashboard → API Tokens → Browser Rendering: Edit template. Account id: dash.cloudflare.com/<ACCOUNT_ID>/....

Tools

| tool | what it does | |---|---| | browse | fetch a public URL → clean markdown (default); action = screenshot \| pdf | | screenshot | save the page as PNG locally, returns the file path | | pdf | save the page as PDF locally, returns the file path |

Config

keyrequiredmeaning
cf_api_tokenyour API token (Browser Rendering:Edit)
cf_account_idyour Cloudflare account id
cf_api_baseAPI base override
output_dirwhere screenshots/PDFs land (default OS temp)

Privacy

  • Public web only: every URL passes an SSRF guard (localhost / private IPs / IPv6 literals / userinfo rejected) before the API is called.
  • The token lives only in your config file — never logged, never stored by the plugin.
  • Browser Run identifies itself as a well-behaved bot, the compliant way to fetch.

Development

npm install
npm run typecheck
npm test          # SSRF guard / config / API shape
npm run build

Live API test (not part of npm test):

DSH_TEST_CF_TOKEN=<token> DSH_TEST_CF_ACCOUNT=<account> node --import tsx tests/real/real-cf.mjs

License

MIT