clip_url
Fetch an external URL, extract the main article, convert to markdown, and save it as a new knowledge base clipping. Use headers to clip pages behind login walls.
Instructions
SIDE-EFFECTFUL — fetches an EXTERNAL URL and writes a NEW KB file. Downloads the page, extracts the main article via Readability, converts to markdown, and saves it as a new clipping. NOT idempotent / no de-dup — re-clipping the same URL creates a second file. AUTH: anonymous by default; pass headers (e.g. {Cookie: 'session=...'} or {Authorization: 'Bearer ...'}) to clip behind logins. Kontexta does not rate-limit but the upstream may throttle. On auth-required pages returns isError with code: AUTH_REQUIRED, optional login_url, and a hint to retry with headers. Returns {file_id, path, title, source}. Use to ingest external docs into the KB.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The URL to clip | |
| title | No | Optional title override (defaults to the page's <title>) | |
| headers | No | Optional HTTP headers to forward with the fetch (e.g. {"Cookie": "session=..."} or {"Authorization": "Bearer ..."}). Use to clip pages behind auth walls after AUTH_REQUIRED. |