---
title: "MrScraper integration for LuumenAI"
url: "https://www.luumen.ai/integrations/mrscraper/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# MrScraper integration for LuumenAI

Check scraper health, then rerun or repair extraction jobs with approval

## What LuumenAI can do with MrScraper

LuumenAI connects to MrScraper with an API token and exposes 11 tools (5 read-only · 6 write). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 11 tools (5 read-only · 6 write)
- Plan: available on all plans
- Category: Databases & data platforms

## About MrScraper with LuumenAI

Connect MrScraper and Luumen can see how your scrapes are actually doing: success rates by domain and action, latency, recent results, and where your plan sits on tokens and concurrency. When a saved workflow stops matching its target site, the agent can heal it or rerun it against new URLs as an approved step. Authentication is by API key.

## Example tools

Read-only (5 in total):

- `MRSCRAPER_GET_ACCOUNT_USAGE` — Return the connected MrScraper account's plan, token usage, concurrency allowance, and rate limits without exposing user identity or token details.
- `MRSCRAPER_GET_ANALYTIC_STATUSES` — Return aggregate scrape counts, success rate, request rate, latency, and status totals for a domain and action over a time range.
- `MRSCRAPER_GET_ANALYTIC_TIMELINE` — Return time-series scrape activity and success metrics for a domain and action over a time range.
- `MRSCRAPER_GET_RESULT` — Retrieve the current status and output for one accessible scrape result by ID.
- `MRSCRAPER_LIST_RESULTS` — List scrape results for the connected account with filtering, sorting, and agent-controlled pagination.

Write and destructive (6 in total, approval required by default):

- `MRSCRAPER_BULK_RERUN_AI_SCRAPER` — Run an existing General AI scraper configuration against multiple URLs in one request.
- `MRSCRAPER_BULK_RERUN_MANUAL_SCRAPER` — Run an existing saved manual scraper workflow against multiple URLs in one request.
- `MRSCRAPER_CREATE_AI_SCRAPER` — Create and run a general, listing, or map AI scraper against a website.
- `MRSCRAPER_HEAL_MANUAL_SCRAPER` — Ask MrScraper to repair an existing manual scraper workflow that no longer matches its target site.
- `MRSCRAPER_RERUN_AI_SCRAPER` — Run an existing AI scraper configuration against a new URL, with optional map crawl controls.
- `MRSCRAPER_RERUN_MANUAL_SCRAPER` — Run an existing saved manual scraper workflow against a new URL.

## Frequently asked questions

### How does LuumenAI connect to MrScraper?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in MrScraper on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

Every call to MrScraper — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/mrscraper/