| name | mrscraper |
| description | MrScraper unblocker and AI scraping tools for blocked pages and structured extraction. |
| metadata | {"openclaw":{"emoji":"🕸️","requires":{"config":["plugins.entries.mrscraper.enabled"]}}} |
MrScraper Tools
When to use which tool
| Need | Tool | When |
|---|
| Blocked or JS-heavy page fetch | web_fetch | MrScraper can power web_fetch when selected as the fetch provider |
| Rendered HTML plus extracted text | mrscraper_fetch_html | Need unblocker controls like geoCode or blockResources |
| AI-powered structured extraction | mrscraper_scrape | Need schema-free extraction from plain-language instructions |
| Reuse an AI scraper | mrscraper_rerun_ai_scraper | Apply an existing AI scraper to a new page or crawl target |
| Batch AI reruns | mrscraper_bulk_rerun_ai_scraper | Reuse one AI scraper across many URLs |
| Reuse a manual scraper | mrscraper_rerun_manual_scraper | Apply a dashboard manual scraper to a new URL |
| Batch manual reruns | mrscraper_bulk_rerun_manual_scraper | Reuse one manual scraper across many URLs |
| Browse prior runs | mrscraper_get_all_results | List stored results with sorting, paging, and filters |
| Inspect one prior run | mrscraper_get_result_by_id | Fetch one detailed result by result ID |
web_fetch
When mrscraper is the selected web_fetch provider, OpenClaw routes normal
web_fetch calls through MrScraper's unblocker.
| Parameter | Description |
|---|
url | HTTP or HTTPS URL to fetch |
extractMode | markdown or text |
maxChars | Maximum returned characters |
mrscraper_fetch_html
Use this when you need unblocker-specific controls or want both rendered HTML
and extracted text back in one tool result.
| Parameter | Description |
|---|
url | HTTP or HTTPS URL to fetch |
extractMode | markdown or text |
maxChars | Maximum returned characters |
timeoutSeconds | Request timeout |
geoCode | Optional country routing code like US or SG |
blockResources | Block images/fonts/resources for faster loads |
mrscraper_scrape
Use this when you want MrScraper to create an AI scraper run from natural-language
instructions.
| Parameter | Description |
| ----------------- | ---------------------------------------------- | --- | --- |
| url | Target page or site |
| message | What to extract |
| agent | general, listing, or map |
| proxyCountry | Optional ISO country code |
| maxDepth | map agent only |
| maxPages | map agent only |
| limit | map agent only |
| includePatterns | map agent only; regex patterns joined with | | |
| excludePatterns | map agent only; regex patterns joined with | | |
mrscraper_rerun_ai_scraper
Reuse an existing AI scraper on a new URL.
| Parameter | Description |
| ----------------- | ---------------------------------------------- | --- | --- |
| scraperId | Existing AI scraper ID |
| url | Target page or site |
| maxDepth | map agent only |
| maxPages | map agent only |
| limit | map agent only |
| includePatterns | map agent only; regex patterns joined with | | |
| excludePatterns | map agent only; regex patterns joined with | | |
mrscraper_bulk_rerun_ai_scraper
Reuse an existing AI scraper across multiple URLs.
| Parameter | Description |
|---|
scraperId | Existing AI scraper ID |
urls | One or more target URLs |
mrscraper_rerun_manual_scraper
Reuse an existing manual scraper on a new URL.
| Parameter | Description |
|---|
scraperId | Existing manual scraper ID |
url | Target page or site |
mrscraper_bulk_rerun_manual_scraper
Reuse an existing manual scraper across multiple URLs.
| Parameter | Description |
|---|
scraperId | Existing manual scraper ID |
urls | One or more target URLs |
mrscraper_get_all_results
Browse previous MrScraper runs with optional paging and filtering.
| Parameter | Description |
|---|
sortField | Sort column such as updatedAt |
sortOrder | ASC or DESC |
pageSize | Number of results per page |
page | Page number starting at 1 |
search | Optional text search |
dateRangeColumn | Optional date field to filter by |
startAt | Optional ISO start timestamp |
endAt | Optional ISO end timestamp |
mrscraper_get_result_by_id
Fetch one detailed result object by result ID.
| Parameter | Description |
|---|
resultId | Result ID to fetch |
Tips
- Start with
web_fetch or mrscraper_fetch_html when you mainly need page contents.
- Use
mrscraper_scrape when you need structured extracted data instead of raw page text.
- Use the rerun tools once you already have a saved scraper ID and want to reuse it.
- Use the result tools when you need to inspect prior jobs rather than launch a new scrape.
- Prefer the
map agent only when the task really needs multi-page crawling.