Practical overview
When it fits
Use Donsetch when an agent workflow needs web access through MCP, or when the same fetch, search and crawl tasks need to run from a CLI.
Who it is for
- Developers connecting web research tools to an MCP-compatible AI agent.
- People or scripts that need command-line web fetching, search, crawling or screenshots.
Documented uses
- Fetch a web page as clean Markdown and optionally focus the result on a topic.
- Search the web with query intent options.
- Map, crawl or collect content from a website.
- Capture a page as a PNG screenshot.
Requirements & limits
The README describes a keyless search option and says the tool needs no accounts; BYOK search providers are also supported. Donsetch is open source under AGPL-3.0.
- The project provides both MCP server and CLI interfaces over the same engine.
- MCP transport can use stdio or HTTP; HTTP mode documents token authentication and restrictions involving browser origins and loopback binding.
- Search supports keyless operation as well as optional provider keys.
- Configuration can be layered through defaults, legacy environment variables, a TOML file and newer environment-variable names.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Register Donsetch as an MCP server
Configure an MCP client to start Donsetch in supervised stdio mode.
Before you start
- Donsetch available as the
donsetchcommand, or use the documentednpxinvocation.
Steps
Add an MCP server entry named
donsetchto the client configuration.Set
commandtodonsetchandargsto["mcp", "--supervised"].If using the documented no-global-install option, set
commandtonpxandargsto["donsetch", "mcp"]instead.
Expected outcome
The client configuration specifies Donsetch as an MCP server using stdio.
Guide limitations
- The guide documents the client configuration, not a verified connection to a particular client.
Use Donsetch web tasks from the CLI
Run the documented fetch, search and crawl command forms from a shell.
Before you start
- Donsetch available as the
donsetchcommand.
Steps
Fetch a page with
donsetch fetch https://example.com --focus "pricing".Search with
donsetch search "rust async patterns" --intent code.Map a documentation site with
donsetch crawl https://docs.python.org --mode map --topic asyncio.
Expected outcome
The commands request focused page fetching, intent-based search and a topic-focused site map.
Guide limitations
- The examples document command forms; the repository describes crawl modes and options, but this recipe does not verify results for the example URLs.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 12 October 2026
- Original website title
- dondai44423/donsetch · Official homepage title · retained in its source language

