Skip to main content
MrScraper logo
  • Category: web scraping & browser
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: MRSCRAPER
  • Version: 20261026_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: MRSCRAPER_BULK_RERUN_AI_SCRAPERRun an existing General AI scraper configuration against multiple URLs in one request. Returns the accepted bulk result ID for Get Scrape Result.

Input Parameters

array
required
One or more HTTP or HTTPS URLs to process with the existing AI scraper.
string
required
UUID of an existing General AI scraper configuration to run against every URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_BULK_RERUN_MANUAL_SCRAPERRun an existing saved manual scraper workflow against multiple URLs in one request. Returns the accepted bulk result ID for Get Scrape Result.

Input Parameters

array
required
Non-empty list of HTTP or HTTPS URLs to process with the saved workflow.
string
required
UUID of the existing manual scraper workflow to rerun.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_CREATE_AI_SCRAPERCreate and run a general, listing, or map AI scraper against a website.Instant: Supported on the latest version.Instant pricing: $0.995 per 1,000 tokens usedDiscount: 5

Input Parameters

string
required
HTTP or HTTPS website URL to scrape.
string ("general" | "listing" | "map")
AI scraper mode: general extraction, repeated-item listing extraction, or site mapping.
integer
Map-only maximum extracted entries (1-100000); omit for the provider default of 1000.
string
Natural-language extraction instructions. Required for general and listing modes; omit for map mode.
integer
Map-only maximum link depth (0-5); omit to use the provider default of 2.
integer
Map-only maximum pages to crawl (1-1000); omit for the default of 50.
string
Two-letter country code for geo-localized scraping.
array
Map-only URL regex patterns to exclude.
array
Map-only URL regex patterns to include.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_GET_ACCOUNT_USAGEReturn the connected MrScraper account’s plan, token usage, concurrency allowance, and rate limits without exposing user identity or token details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_GET_ANALYTIC_STATUSESReturn aggregate scrape counts, success rate, request rate, latency, and status totals for a domain and action over a time range.

Input Parameters

string
Optional custom-scraper action filter, such as create, rerun, bulk, or fetch HTML; omit to aggregate all actions.
string
required
Domain to aggregate, without a URL path (for example example.com).
string
required
Range end in yyyy-MM-dd HH:mm:ss format.
string
required
Range start in yyyy-MM-dd HH:mm:ss format.
string
Optional non-secret dashboard token name used only to filter analytics; not the API token value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_GET_ANALYTIC_TIMELINEReturn time-series scrape activity and success metrics for a domain and action over a time range.

Input Parameters

string
Optional custom-scraper action filter, such as create, rerun, bulk, or fetch HTML; omit to aggregate all actions.
string
required
Domain to aggregate, without a URL path (for example example.com).
string
required
Range end in yyyy-MM-dd HH:mm:ss format.
string
required
Range start in yyyy-MM-dd HH:mm:ss format.
string
Optional non-secret dashboard token name used only to filter analytics; not the API token value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_GET_RESULTRetrieve the current status and output for one accessible scrape result by ID.Instant: Supported on the latest version.Instant pricing: $0 per result lookup

Input Parameters

string
required
Result UUID returned by a create or rerun operation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_HEAL_MANUAL_SCRAPERAsk MrScraper to repair an existing manual scraper workflow that no longer matches its target site.

Input Parameters

string
required
UUID of the manual scraper workflow to inspect and repair.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_LIST_RESULTSList scrape results for the connected account with filtering, sorting, and agent-controlled pagination.

Input Parameters

string
Inclusive end date/time for date_range_column.
Text to search across result columns.
string
Inclusive start date/time for date_range_column.
integer
Maximum results to return in this page (1-100).
string
Provider result field to sort by, such as createdAt.
string ("ASC" | "DESC")
Ascending or descending sort order.
string
Continuation cursor returned by a previous call; omit for the first page.
string
Result date field constrained by start_at and end_at.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_RERUN_AI_SCRAPERRun an existing AI scraper configuration against a new URL, with optional map crawl controls.Instant: Supported on the latest version.Instant pricing: $0.995 per 1,000 tokens usedDiscount: 5

Input Parameters

string
required
New HTTP or HTTPS URL to process with the existing scraper.
integer
Optional maximum extracted entries for a map scraper (1-100000); omit to use the provider default of 1000.
integer
Optional maximum link depth for a map scraper (0-5); omit to use the provider default of 2.
integer
Optional maximum pages for a map scraper (1-1000); omit to use the provider default of 50.
string
required
AI scraper UUID returned by a prior AI scrape.
array
URL regex patterns to exclude when rerunning a map scraper.
array
URL regex patterns to include when rerunning a map scraper.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MRSCRAPER_RERUN_MANUAL_SCRAPERRun an existing saved manual scraper workflow against a new URL.

Input Parameters

string
required
New HTTP or HTTPS URL to process with the saved workflow.
string
required
UUID of an existing manual scraper saved in MrScraper.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not