# Send Distil the web & PDFs into markdown to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "distil",
    "name": "Distil the web & PDFs into markdown",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/mikel/distil",
    "canonicalUrl": "https://clawhub.ai/mikel/distil",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/distil",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=distil",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "LICENSE.md",
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "distil",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T14:21:29.997Z",
      "expiresAt": "2026-05-09T14:21:29.997Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=distil",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=distil",
        "contentDisposition": "attachment; filename=\"distil-2.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "distil"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/distil"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/distil",
    "downloadUrl": "https://openagent3.xyz/downloads/distil",
    "agentUrl": "https://openagent3.xyz/skills/distil/agent",
    "manifestUrl": "https://openagent3.xyz/skills/distil/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/distil/agent.md"
  }
}
```
## Documentation

### Distil Skill

Gives agents discoverable, consistent access to the Distil proxy — no manual URL construction, no remembering headers or API keys.

Distil converts web pages into clean Markdown, saving 60–80% of tokens for LLM consumption.

### Setup

Get your free API key with email verification from https://distil.net (sign up or use your existing key)
Set the DISTIL_API_KEY environment variable
Optional: set DISTIL_PROXY_URL (defaults to https://proxy.distil.net)

### Commands

# Fetch any URL as clean Markdown
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/https://example.com" \\
  -H "X-Distil-Key: $DISTIL_API_KEY"

# Search the web and get results as Markdown
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/search?q=best+practices+for+Go+error+handling" \\
  -H "X-Distil-Key: $DISTIL_API_KEY" \\
  -H "Accept: text/markdown"

# Take a screenshot of a web page and return it as an image
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/screenshot/https://example.com" \\
  -H "X-Distil-Key: $DISTIL_API_KEY" > screenshot.png

# Render a web page (such as a single page javascript app) before trying to extract markdown
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/render/https://example.com" \\
  -H "X-Distil-Key: $DISTIL_API_KEY"

# Fetch a URL and return its raw content bypassing any attempt to render markdown
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/raw/https://example.com" \\
  -H "X-Distil-Key: $DISTIL_API_KEY"

# Fetch a URL and return its content without using the cache
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/nocache/https://example.com" \\
  -H "X-Distil-Key: $DISTIL_API_KEY"

### Options

Environment VariableDefaultDescriptionDISTIL_API_KEY(none, required)API keyDISTIL_PROXY_URLhttps://proxy.distil.netProxy base URL (override for self-hosted)

### Output

Responses are returned on stdout
HTTP errors are returned with non-2xx status and an error payload

### Examples

# Research a topic
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/search?q=OpenClaw+agent+framework" \\
  -H "X-Distil-Key: $DISTIL_API_KEY" \\
  -H "Accept: text/markdown"

# Read documentation
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/https://docs.github.com/en/rest" \\
  -H "X-Distil-Key: $DISTIL_API_KEY"

# Force fresh fetch (bypass cache)
curl -s "${DISTIL_PROXY_URL:-https://proxy.distil.net}/nocache/https://news.ycombinator.com" \\
  -H "X-Distil-Key: $DISTIL_API_KEY"

### Fallback — Direct curl

If you prefer to call the proxy directly:

# Fetch a page
curl -s "https://proxy.distil.net/https://example.com" \\
  -H "X-Distil-Key: YOUR_API_KEY"

# Search the web
curl -s "https://proxy.distil.net/search?q=your+query" \\
  -H "X-Distil-Key: YOUR_API_KEY" \\
  -H "Accept: text/markdown"

### Notes

Every reply request in Markdown will include how many raw tokens were saved by distil's markdown conversion, so you can see the efficiency benefits in real time. Distil's Markdown output is designed to be clean and concise, stripping away unnecessary HTML and boilerplate to give you just the content you need. This can save 60–80% of tokens compared to raw HTML, making it much more efficient for LLM consumption.

If you run out of tokens, distil will return the raw HTML content instead of Markdown, so you can still access the information even if you exceed your token limits. This way, you won't lose access to the content, but you'll be able to see how much more efficient the Markdown output is when you have tokens available. When this happens distil will inject a HTML comment within the web page you are accessing to let you know how to fix it.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: mikel
- Version: 2.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T14:21:29.997Z
- Expires at: 2026-05-09T14:21:29.997Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/distil)
- [Send to Agent page](https://openagent3.xyz/skills/distil/agent)
- [JSON manifest](https://openagent3.xyz/skills/distil/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/distil/agent.md)
- [Download page](https://openagent3.xyz/downloads/distil)