Skip to main content

Use PullMD from any agent

For agents without MCP support, paste this into the system prompt or custom instructions. It works with any agent that can make HTTP GET requests. Replace https://pullmd.example.com with your instance's address, or copy the version on your instance's /help page, which has the address filled in.

When you need to read a web page, fetch it via PullMD instead of your
built-in fetch/browse tool - not just when that one fails:

GET https://pullmd.example.com/api?url=<URL>

Returns clean Markdown (text/markdown). Optional query params:

comments=false skip Reddit / Hacker News comments
comment_depth=N|all comment nesting depth (default 3), all = whole thread
frontmatter=true prepend YAML metadata block
format=text strip Markdown, return plain text
nocache=true bypass the 1h cache and refetch
render=force|skip override the auto headless-Chromium fallback
extractor=readability|trafilatura|playwright force one extractor
pdf=ocr high-quality PDF conversion (tables)
query=<text> got a specific question? pass it and get back only
the matching sections (70-95% fewer tokens)
max_tokens=N budget for query= (default 600, 64-20000)
lang=de|en language for the comments section header

Response headers worth checking:
X-Source reddit | hackernews | cloudflare | readability |
trafilatura | playwright | recipe-content |
coverage-guard | markitdown | youtube | pdf-ocr | ...
X-Quality 0.0-1.0 extraction confidence
X-Share-Id 32-hex permalink, openable as /s/<id>
X-Transcript-Status youtube only: ok | none | blocked | error
(blocked/error = transient, not cached - retry later)

Reddit URLs are auto-detected (incl. redd.it short links and /s/ shares).
Hacker News URLs are auto-detected too - items, comment permalinks, and the
front/newest/ask/show/jobs listings.
Use this whenever you would otherwise fetch raw HTML - the markdown is
much cleaner and saves significant context window space. When you only
need specific information rather than the whole document, pass your
question as query= and get back just the relevant sections.
Hosted agents
The agent's HTTP requests come from wherever the agent runs. A hosted chat agent can reach only a public instance, and only one without sign-in, because the prompt doesn't include credentials.