| name | deshell |
| description | Fetch web pages as clean Markdown and search the web via the DeShell proxy |
| version | 1.5.0 |
| metadata | {"openclaw":{"emoji":"๐","requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"DESHELL_API_KEY","install":["[Truncated]"]}} |
DeShell Skill
Gives agents discoverable, consistent access to the DeShell proxy โ no manual URL construction, no remembering headers or API keys.
DeShell converts web pages into clean Markdown, saving 60โ80% of tokens for LLM consumption.
Setup
-
Get your API key from https://deshell.ai (sign up or use your existing key)
-
Install the deshell CLI manually (one-time):
npm install @deshell/mcp
-
Set the DESHELL_API_KEY environment variable
Commands
deshell fetch https://example.com
deshell search "best practices for Go error handling"
deshell search top 10 AI companies 2025
deshell screenshot https://example.com
deshell render https://example.com
deshell raw https://example.com
deshell nocache https://example.com
Options
| Environment Variable | Default | Description |
|---|
DESHELL_API_KEY | (none) | API key |
DESHELL_PROXY_URL | https://proxy.deshell.ai/ | Proxy base URL |
DESHELL_EXTRA_HEADERS | (none) | Comma-separated extra headers in Header-Name:value format |
Output
deshell fetch โ returns page content as Markdown on stdout
deshell search โ returns search results with titles, URLs, descriptions, and page content as Markdown on stdout
- Errors are written to stderr; non-zero exit code on failure
Extra Headers
To pass additional DeShell headers, use comma-separated Header-Name:value pairs:
DESHELL_EXTRA_HEADERS="X-DeShell-No-Cache:true" deshell fetch https://example.com
DESHELL_EXTRA_HEADERS="X-DeShell-No-Cache:true,X-DeShell-Max-Tokens:2000" deshell fetch https://example.com
Examples
deshell search "OpenClaw agent framework"
deshell fetch https://docs.github.com/en/rest
DESHELL_EXTRA_HEADERS="X-DeShell-No-Cache:true" deshell fetch https://news.ycombinator.com
Fallback โ Direct curl
If you prefer not to install npm packages, you can call the proxy directly with curl:
curl -s "https://proxy.deshell.ai/https://example.com" \
-H "X-DeShell-Key: YOUR_API_KEY"
curl -s "https://proxy.deshell.ai/search?q=your+query" \
-H "X-DeShell-Key: YOUR_API_KEY" \
-H "Accept: text/markdown"