spidra_batch_scrape
Scrape 2 to 50 URLs in one batch with a shared prompt or schema, returning separate results per URL for product pages, listings, or article comparisons.
Instructions
Read 2 to 50 known URLs, each on its own with its own result, using the same prompt or schema for all.
Use it for anything with more than one URL: product pages, listings, articles, or just two pages to compare. Waiting: with "wait": true and 10 URLs or fewer, it waits (up to a few minutes) and returns the finished batch. Otherwise it returns a "batchId" straight away; check it with spidra_get_job (type "batch") every 10 to 15 seconds until "status" is completed or cancelled. Don't start the batch again while it runs.
"output" is "markdown" (default) or "json"; a schema sets "json". Popular-site pages also get "structuredData".
A completed batch can still have failed items: check "failedCount" and each item's "error". spidra_retry_batch re-runs only the failed ones.
Browser actions aren't supported in a batch; use spidra_scrape for pages that need them.
Cost: per URL, the same as spidra_scrape. Failed URLs cost nothing.
Example: {"urls": ["https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html", "https://books.toscrape.com/catalogue/tipping-the-velvet_999/index.html"], "prompt": "Title and price", "output": "json", "wait": true}
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": {
"urls": "<urls>"
},
"name": "spidra_batch_scrape"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | Yes | 2 to 50 URLs | |
| wait | No | With 10 URLs or fewer, wait and return the finished batch instead of a batchId | |
| output | No | "markdown" (default) or "json" | |
| prompt | No | What to extract from each page. Leave out for Markdown. | |
| schema | No | A JSON Schema for the answer. You get exactly these fields and types, with null for anything the page doesn't show. Define every field you want: an object with no properties comes back empty. The root must be an object. | |
| cookies | No | Cookies from the user's own signed-in browser session, for pages behind a login, e.g. "session=abc; token=xyz". Never stored. | |
| useProxy | No | Stealth Mode: browse through residential proxies, for sites that block or vary by country. Billed by bandwidth, not credits. | |
| scrapeMode | No | "default" always uses a browser; "fast" fetches pages and opens a browser only when needed | |
| proxyCountry | No | With useProxy, the country to browse from: a two-letter code such as "us", "gb" or "de", or "global", "eu" or "asia" | |
| extractContentOnly | No | Leave out menus, headers, footers and ads |