scrapewise_run_scraper
Triggers a manual run of the scraper identified by `id`. The run is queued
on the scheduler and starts asynchronously — this call returns immediately
once the run is accepted, NOT when scraping completes. Long scrapes can take
minutes to hours; poll `scrapewise_get_scraper_load_history` to check status,
or read `scrapewise_get_scraper.lastRunState` for the most-recent state of
this specific scraper.
Args:
- id (string, path param, required): the scraper's MongoDB ObjectId. Get
from `scrapewise_get_scraper_list` or `scrapewise_get_scraper_group_list`.
- customerUniqueRef (string, query param, optional): admin-only escape hatch
to run another customer's scraper from a customer-switch session. Leave
unset for normal runs as the authenticated customer.
- continueFromJobId (string, query param, optional, website email lists only):
Continue. The id of the job that stopped at a limit (stoppedReason TIME_LIMIT
or DAILY_LIMIT, continuable true in scrapewise_get_scraper_load_history). Only
the websites not read yet are read and charged. Refused with 409
NOT_CONTINUABLE (nothing started) when that job is not the list's latest job or
nothing is left to read. Omit it for a plain run.
Returns:
200 OK with `{"firstJob": boolean}` — true only when a signed-in user starts their very
first run by hand; always false for API keys. The run is queued asynchronously — poll
`scrapewise_get_scraper_load_history` for the new run's state, or read
`scrapewise_get_scraper.lastRunState` for the most-recent state of this scraper.
The run will be PENDING immediately after this returns, then transitions to
RUNNING and COMPLETED / FAILED / STOPPED.
Examples:
- Use when: "start the mototas scraper" → list to find id, then run with that id
- Use when: "re-run scraper {id} now" → run with id
- Don't use when: the scraper is already RUNNING → call scrapewise_stop_scraper
first to cancel the in-flight run, then re-run
- Don't use when: you want to run all scrapers in a group → use
scrapewise_run_scraper_group with the group id (more efficient)
- Don't use when you are looping this call over a list of scrapers you just
created, one per URL. Do NOT create one scraper per URL: give ONE scraper
the whole list — `scrapewise_run_scraper_url_list` creates it, stores the
list and runs it in one call.
Website email lists (endpoint websitecontacts): with continueFromJobId this call is
Continue. A list whose job stopped at the job-time limit (stoppedReason TIME_LIMIT,
23 hours by default) or at the daily limit (DAILY_LIMIT, after 00:00 UTC) reads ONLY
the websites not read yet, in the same run chain; nothing already read is fetched or
charged again. Nothing is ever continued by itself.
Error Handling:
- 402 if customer plan lacks MANUAL_RUN feature.
- 400 (CustomerError envelope) if no scraper with the given id exists for this
customer, OR if the scraper is currently RUNNING / PENDING (code
ALREADY_RUNNING), OR if it is disabled (code SCRAPER_DISABLED).
- 409 NOT_CONTINUABLE if continueFromJobId names a job that has nothing left to
continue (not the list's latest job, the list is read, or not this account's).
Nothing was started or charged.
- 409 LIST_RESUME_OFF if a website email list cannot be continued right now
(nothing was started).
- 401 Unauthorized if no valid Authorization header.
- 500 INTERNAL on unexpected server error.[runtime hint] This tool returns JSON-as-text — its response shape is dynamic (per-scraper itemsConfig, file binary, etc.) so the MCP outputSchema is omitted. Do not rely on the presence of any specific field in the response; treat the result as a string-or-object blob and parse defensively.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "scrapewise_run_scraper"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the scraper's MongoDB ObjectId. Get from `scrapewise_get_scraper_list` or `scrapewise_get_scraper_group_list`. | |
| continueFromJobId | No | Continue. The id of the job that stopped at a limit (stoppedReason TIME_LIMIT or DAILY_LIMIT, continuable true in scrapewise_get_scraper_load_history). Only the websites not read yet are read and charged. Refused with 409 NOT_CONTINUABLE (nothing started) when that job is not the list's latest job or nothing is left to read. Omit it for a plain run. | |
| customerUniqueRef | No | admin-only escape hatch to run another customer's scraper from a customer-switch session. Leave unset for normal runs as the authenticated customer. |