> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Simplescraper MCP

> Simplescraper MCP lets agents create scraping recipes and extract structured live web data through an authenticated remote MCP server.

![Simplescraper MCP logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/simplescraper_mcp.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=55a5428cf313cece2c58d3a59e64edbc)

* **Category:** model context protocol
* **Auth:** DCR\_OAUTH
* **Composio-managed OAuth available?** No
* **Tools:** 13
* **Triggers:** 0
* **Slug:** `SIMPLESCRAPER_MCP`
* **Version:** 20261030\_00

## Tools

> [accordion] Create recipe
>
> **Slug:** `SIMPLESCRAPER_MCP_CREATE_RECIPE`
>
> Create a new scrape recipe with a name, URL, and selectors.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> URL of the page to be scraped
>
> **name** `string` *required*
>
> Name of the recipe to create
>
> **selectors** `array` *required*
>
> Array of selectors defining what data to extract (max 100)

> [accordion] Extract markdown
>
> **Slug:** `SIMPLESCRAPER_MCP_EXTRACT_MARKDOWN`
>
> Fetch one page and return its body as clean Markdown. Renders JavaScript before extraction. Returns markdown plus metadata (title, word count).
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Full URL of the page to extract, including protocol (e.g. '[https://example.com/blog/post](https://example.com/blog/post)')

> [accordion] Extract urls
>
> **Slug:** `SIMPLESCRAPER_MCP_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.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Full URL of the site including protocol, e.g. '[https://example.com](https://example.com)'
>
> **url\_limit** `number`
>
> Maximum number of URLs to return (default: no limit; sites can have tens of thousands of URLs)
>
> **sitemap\_limit** `number`
>
> For sites whose top-level sitemap is an INDEX of nested sitemaps, limits how many nested sitemaps to traverse. Useful for very large sites where you want a fast partial sample.

> [accordion] Get latest results
>
> **Slug:** `SIMPLESCRAPER_MCP_GET_LATEST_RESULTS`
>
> Get the most recent scraped results for a recipe. Returns the existing data from the last completed run without scraping again.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of results to return
>
> **offset** `number`
>
> Number of results to skip for pagination
>
> **orderBy** `string ("index" | "timestamp")`
>
> Field to order/sort results by ('index' is default. 'timestamp' orders by most recently SCRAPED results)
>
> **recipe\_id** `string` *required*
>
> ID of the recipe to get latest results for

> [accordion] Get recipe
>
> **Slug:** `SIMPLESCRAPER_MCP_GET_RECIPE`
>
> Retrieve full details of a specific scrape recipe: name, URL, creation date, last run time, and selectors.
>
> #### Input Parameters
>
> **recipe\_id** `string` *required*
>
> ID of the recipe to retrieve

> [accordion] Get results
>
> **Slug:** `SIMPLESCRAPER_MCP_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.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of scrape results to return
>
> **offset** `number`
>
> Number of results to skip for pagination
>
> **orderBy** `string ("index" | "timestamp")`
>
> Field to order/sort results by ('index' is default. 'timestamp' orders by most recently SCRAPED results)
>
> **results\_id** `string` *required*
>
> ID of the results to retrieve

> [accordion] Get results history
>
> **Slug:** `SIMPLESCRAPER_MCP_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.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of history items to return (default: 100)
>
> **offset** `number`
>
> Number of history items to skip for pagination (default: 0)
>
> **recipe\_id** `string` *required*
>
> ID of the recipe to get results history for

> [accordion] List recipes
>
> **Slug:** `SIMPLESCRAPER_MCP_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.
>
> #### Input Parameters
>
> **host** `string`
>
> Filter recipes by specific website or host (e.g., 'amazon.com') - use EXACT domain name only
>
> **limit** `number`
>
> Maximum number of recipes to return (default: 50)
>
> **order** `string ("asc" | "desc")`
>
> sort order (ascending or descending, default: desc)
>
> **query** `string`
>
> Query string to filter recipes by name (requires exact match, not fuzzy search)
>
> **offset** `number`
>
> Number of recipes to skip for pagination (default: 0)
>
> **has\_run** `boolean`
>
> If true, include only recipes that have been run before
>
> **orderBy** `string ("date_created" | "date_last_ran_timestamp" | "name")`
>
> Field to order/sort results by ('date\_last\_ran\_timestamp' for most recently run recipes)

> [accordion] Run recipe
>
> **Slug:** `SIMPLESCRAPER_MCP_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.
>
> #### Input Parameters
>
> **urls** `array`
>
> Optional array of URLs to scrape through this recipe in one run. Replaces the recipe's saved crawler list, forces crawler+async mode, and returns a results\_id immediately (use get\_results to fetch). Up to 5000 URLs; the number scraped is capped by your credits.
>
> **recipe\_id** `string` *required*
>
> ID of the recipe to run
>
> **run\_async** `boolean`
>
> If true, returns a result ID immediately and runs the scrape asynchronously (default: false)
>
> **source\_url** `string`
>
> Optional URL to run the recipe on (overrides the recipe's default URL - must be encoded)
>
> **use\_crawler** `boolean`
>
> If true, scrapes URLs added to the crawler instead of the source URL (default: false)
>
> **extract\_markdown** `boolean`
>
> If true, extracts a markdown version of the page in addition to structured data (default: false)

> [accordion] Screenshot
>
> **Slug:** `SIMPLESCRAPER_MCP_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 not suited to an MCP text response.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL of the page to capture, including protocol (e.g. '[https://example.com](https://example.com)')
>
> **delay** `number`
>
> Seconds to wait after page load before capturing, 0-15 (default: 0)
>
> **store** `boolean`
>
> If true, saves the screenshot to cloud storage (automatically true when output is 'url')
>
> **format** `string ("png" | "jpeg" | "webp")`
>
> Image format (default: 'png')
>
> **output** `string ("base64" | "url" | "binary")`
>
> How to return the image: 'url' (default here - a hosted screenshot URL with a 30-day TTL), 'base64' (image embedded in the JSON), or 'binary' (raw bytes; not recommended for MCP)
>
> **quality** `number`
>
> Compression quality 1-100 for JPEG/WebP (default: 80; ignored for PNG)
>
> **hide\_ads** `boolean`
>
> If true, suppresses ad network content (default: true)
>
> **full\_page** `boolean`
>
> If true, captures the full scrollable page rather than just the viewport (default: false)
>
> **wait\_until** `string ("load" | "domcontentloaded" | "networkidle0" | "networkidle2")`
>
> Navigation completion condition (default: 'load')
>
> **hide\_popups** `boolean`
>
> If true, suppresses cookie consent banners and popups (default: true)
>
> **viewport\_width** `number`
>
> Browser viewport width in pixels, 320-3840 (default: 1920)
>
> **hide\_background** `boolean`
>
> If true, captures a transparent background (PNG/WebP only, default: false)
>
> **viewport\_height** `number`
>
> Browser viewport height in pixels, 320-3840 (default: 1080)
>
> **wait\_for\_selector** `string`
>
> CSS selector to wait for before capturing
>
> **device\_scale\_factor** `string ("1" | "1.5" | "2" | "3")`
>
> Device pixel ratio for the capture: '1', '1.5', '2', or '3' (default: '1')

> [accordion] Smart extract
>
> **Slug:** `SIMPLESCRAPER_MCP_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.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL of the page to be scraped
>
> **schema** `string` *required*
>
> A comma-separated list of properties to extract (e.g., 'product name, price, description')
>
> **recipe\_id** `string`
>
> Optional ID of a recipe to use its cookies and settings

> [accordion] Update batch urls
>
> **Slug:** `SIMPLESCRAPER_MCP_UPDATE_BATCH_URLS`
>
> Add or replace the list of batch (crawler) URLs for a recipe. 'append' adds to the existing list, 'replace' overwrites it.
>
> #### Input Parameters
>
> **recipe\_id** `string` *required*
>
> ID of the recipe to update batch URLs for
>
> **batch\_mode** `string ("append" | "replace")`
>
> Operation mode: 'append' (default) adds to existing URLs, 'replace' overwrites them
>
> **batch\_urls** `array` *required*
>
> Array of URLs to process in the batch operation

> [accordion] Update recipe
>
> **Slug:** `SIMPLESCRAPER_MCP_UPDATE_RECIPE`
>
> Update an existing scrape recipe's name, URL, or selectors. Supports 'replace' (default) or 'merge' modes for selector updates.
>
> #### Input Parameters
>
> **url** `string`
>
> New URL for the recipe
>
> **name** `string`
>
> New name for the recipe
>
> **recipe\_id** `string` *required*
>
> ID of the recipe to update
>
> **selectors** `array`
>
> Array of selectors to update
>
> **update\_mode** `string ("replace" | "merge")`
>
> Mode for updating selectors: 'replace' (default) or 'merge'
