Skip to main content
Simplescraper MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 13
  • Triggers: 0
  • Slug: SIMPLESCRAPER_MCP
  • Version: 20261030_00

Tools

Slug: SIMPLESCRAPER_MCP_CREATE_RECIPECreate a new scrape recipe with a name, URL, and selectors.

Input Parameters

string
required
URL of the page to be scraped
string
required
Name of the recipe to create
array
required
Array of selectors defining what data to extract (max 100)
Slug: SIMPLESCRAPER_MCP_EXTRACT_MARKDOWNFetch one page and return its body as clean Markdown. Renders JavaScript before extraction. Returns markdown plus metadata (title, word count).

Input Parameters

string
required
Full URL of the page to extract, including protocol (e.g. ‘https://example.com/blog/post’)
Slug: SIMPLESCRAPER_MCP_EXTRACT_URLSDiscover 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

string
required
Full URL of the site including protocol, e.g. ‘https://example.com’
number
Maximum number of URLs to return (default: no limit; sites can have tens of thousands of URLs)
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.
Slug: SIMPLESCRAPER_MCP_GET_LATEST_RESULTSGet the most recent scraped results for a recipe. Returns the existing data from the last completed run without scraping again.

Input Parameters

number
Maximum number of results to return
number
Number of results to skip for pagination
string ("index" | "timestamp")
Field to order/sort results by (‘index’ is default. ‘timestamp’ orders by most recently SCRAPED results)
string
required
ID of the recipe to get latest results for
Slug: SIMPLESCRAPER_MCP_GET_RECIPERetrieve full details of a specific scrape recipe: name, URL, creation date, last run time, and selectors.

Input Parameters

string
required
ID of the recipe to retrieve
Slug: SIMPLESCRAPER_MCP_GET_RESULTSFetch the scraped data from a specific run by results_id. Supports ordering (by index or timestamp) and pagination via limit and offset.

Input Parameters

number
Maximum number of scrape results to return
number
Number of results to skip for pagination
string ("index" | "timestamp")
Field to order/sort results by (‘index’ is default. ‘timestamp’ orders by most recently SCRAPED results)
string
required
ID of the results to retrieve
Slug: SIMPLESCRAPER_MCP_GET_RESULTS_HISTORYList 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

number
Maximum number of history items to return (default: 100)
number
Number of history items to skip for pagination (default: 0)
string
required
ID of the recipe to get results history for
Slug: SIMPLESCRAPER_MCP_LIST_RECIPESList 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

string
Filter recipes by specific website or host (e.g., ‘amazon.com’) - use EXACT domain name only
number
Maximum number of recipes to return (default: 50)
string ("asc" | "desc")
sort order (ascending or descending, default: desc)
string
Query string to filter recipes by name (requires exact match, not fuzzy search)
number
Number of recipes to skip for pagination (default: 0)
boolean
If true, include only recipes that have been run before
string ("date_created" | "date_last_ran_timestamp" | "name")
Field to order/sort results by (‘date_last_ran_timestamp’ for most recently run recipes)
Slug: SIMPLESCRAPER_MCP_RUN_RECIPERun 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

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.
string
required
ID of the recipe to run
boolean
If true, returns a result ID immediately and runs the scrape asynchronously (default: false)
string
Optional URL to run the recipe on (overrides the recipe’s default URL - must be encoded)
boolean
If true, scrapes URLs added to the crawler instead of the source URL (default: false)
boolean
If true, extracts a markdown version of the page in addition to structured data (default: false)
Slug: SIMPLESCRAPER_MCP_SCREENSHOTCapture 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

string
required
The URL of the page to capture, including protocol (e.g. ‘https://example.com’)
number
Seconds to wait after page load before capturing, 0-15 (default: 0)
boolean
If true, saves the screenshot to cloud storage (automatically true when output is ‘url’)
string ("png" | "jpeg" | "webp")
Image format (default: ‘png’)
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)
number
Compression quality 1-100 for JPEG/WebP (default: 80; ignored for PNG)
boolean
If true, suppresses ad network content (default: true)
boolean
If true, captures the full scrollable page rather than just the viewport (default: false)
string ("load" | "domcontentloaded" | "networkidle0" | "networkidle2")
Navigation completion condition (default: ‘load’)
boolean
If true, suppresses cookie consent banners and popups (default: true)
number
Browser viewport width in pixels, 320-3840 (default: 1920)
boolean
If true, captures a transparent background (PNG/WebP only, default: false)
number
Browser viewport height in pixels, 320-3840 (default: 1080)
string
CSS selector to wait for before capturing
string ("1" | "1.5" | "2" | "3")
Device pixel ratio for the capture: ‘1’, ‘1.5’, ‘2’, or ‘3’ (default: ‘1’)
Slug: SIMPLESCRAPER_MCP_SMART_EXTRACTExtract 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

string
required
The URL of the page to be scraped
string
required
A comma-separated list of properties to extract (e.g., ‘product name, price, description’)
string
Optional ID of a recipe to use its cookies and settings
Slug: SIMPLESCRAPER_MCP_UPDATE_BATCH_URLSAdd or replace the list of batch (crawler) URLs for a recipe. ‘append’ adds to the existing list, ‘replace’ overwrites it.

Input Parameters

string
required
ID of the recipe to update batch URLs for
string ("append" | "replace")
Operation mode: ‘append’ (default) adds to existing URLs, ‘replace’ overwrites them
array
required
Array of URLs to process in the batch operation
Slug: SIMPLESCRAPER_MCP_UPDATE_RECIPEUpdate an existing scrape recipe’s name, URL, or selectors. Supports ‘replace’ (default) or ‘merge’ modes for selector updates.

Input Parameters

string
New URL for the recipe
string
New name for the recipe
string
required
ID of the recipe to update
array
Array of selectors to update
string ("replace" | "merge")
Mode for updating selectors: ‘replace’ (default) or ‘merge’