fetch_url
Fetch a URL and extract clean, readable content with an excerpt and link list. Ideal for reading articles or gathering outbound links from known pages.
Instructions
Fetch one URL, extract readable content (Readability-style), and return a compact excerpt plus link list. The full extracted text is preserved in hidden _meta.full_text.
Best for: reading a known page after search/search_many, extracting clean prose from an article, getting an outbound-link list from a hub page.
Returns: {title, url, excerpt, citations, links, content_type, render_mode} plus domain and word/char counts.
Rendered fetch is automatic for JS-heavy pages; pass rendered=true to force browser mode when a previous fetch came back nearly empty.
Use fetch_many for multiple URLs in one call; search_and_fetch if you do not yet have URLs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Absolute http:// or https:// URL to fetch. Bare domains like 'example.com' are auto-prefixed with https://. Other schemes are rejected. | |
| max_excerpt_chars | No | Excerpt character cap for the visible output (200–50000). Default comes from server settings. The full extracted text is always returned in hidden `_meta.full_text`. | |
| max_links | No | Maximum outbound links to surface in the visible output (0–64, default 8). The complete link list is always included in hidden `_meta`. | |
| rendered | No | Force browser-based rendering for fetches. Default false: the server auto-renders only when a page is JS-heavy or returns near-empty text. Set true when a previous fetch came back nearly empty or to read a known SPA. Forced rendering is several times slower than HTTP fetch. | |
| render_wait_ms | No | Extra milliseconds to wait after DOM content load before extracting (0–15000). Use a higher value (e.g. 1500–4000) for SPAs that hydrate slowly. | |
| ttl | No | Cache TTL override in seconds (0–86400). 0 disables caching for this call. Omit to use the server's default TTL. |