Simplescraper MCP integration

Create recipe

Create a new scrape recipe with a name, URL, and selectors.

Extract markdown

Fetch one page and return its body as clean Markdown. Renders JavaScript before extraction. Returns markdown plus metadata (title, word count).

Extract urls

Discover all page URLs on a website by parsing its sitemap (and the sitemap index if present). Returns a deduplicated list of page URLs.

Get latest results

Get the most recent scraped results for a recipe. Returns the existing data from the last completed run without scraping again.

Get recipe

Retrieve full details of a specific scrape recipe: name, URL, creation date, last run time, and selectors.

Get results

Fetch the scraped data from a specific run by results_id. Supports ordering (by index or timestamp) and pagination via limit and offset.

Get results history

List previous scrape runs for a recipe. Each entry has results_id, scrape timestamp, and page count. Returns run metadata only, not the scraped data itself.

List recipes

List the user's scrape recipes, with optional filters by domain, name keyword, or recent activity, and sorting by creation date, last-run, or name.

Run recipe

Run a scrape recipe to extract fresh data from its configured URL. Supports async mode, source URL override, markdown extraction, and batch (crawler) mode.

Screenshot

Capture a screenshot of a web page (1 credit per request). Returns JSON with a hosted screenshot URL by default. Supports full-page capture, custom viewport, format/quality, delays, and popup/ad hiding. Defaults output to 'url' so the response stays small; 'binary' returns raw image bytes and is no…

Smart extract

Extract specific named fields from one page using AI. Pass a comma-separated schema like 'product name, price, sku' and get those fields back as a structured object, plus the CSS selectors that matched them.

Update batch urls

Add or replace the list of batch (crawler) URLs for a recipe. 'append' adds to the existing list, 'replace' overwrites it.