grab_site
Download a page's assets (images, CSS, fonts, SVG) into a local folder and return a JSON manifest of file paths, palette, and fonts—use when the files themselves are the deliverable.
Instructions
Save the files a read already named. Fetches the page through the same unlock ladder as read_url, downloads its assets (images/icons/css/fonts/svg/inline_svg), and returns a manifest (local paths, plus the palette and fonts those files use) as JSON. Use this when the files are the deliverable. For one URL the read listed, use fetch_asset. Saves into out_dir (a relative folder inside the working directory, or SEARCHTS_MCP_OUT_DIR if the user set it) when given, otherwise a 'searchts-grab-' folder there. A folder that already has files is never written into; the grab goes to '-2', '-3' and so on, and the folder used is returned as out_dir. Set read=true to also save the page text as page.md. max_assets caps how many files are saved (default 120); when it or the byte cap stops early, the manifest's 'omitted' list names every URL left out and why, so never report a grab as complete without reading it. max_tokens is how many radius, shadow, and spacing values to keep (default 24, ceiling 200). When that cap hides real values, tokens_more says how many more and that a higher max_tokens returns them. 'page_rungs' names the fetch tiers tried and what each found. Returns an 'Error: ...' string on failure. Update check: when a newer release exists, a successful result also carries 'update_available' plus, at most once per 24 hours, one line telling the agent. The check is one GET to the GitHub latest release of capad-xyz/searchts, at most once per 24 hours, cached in ~/.searchts/update-check.json, with a searchts User-Agent and nothing about the user. Nothing is installed or changed. SEARCHTS_NO_UPDATE_CHECK=1 turns the check and the note off.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "grab_site"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| read | No | ||
| out_dir | No | ||
| max_assets | No | ||
| max_tokens | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |