What it adds

Tools 15

mrscraper_get_account_infomrscraper_crawl_website_urlsmrscraper_search_google_serpmrscraper_extract_page_by_promptmrscraper_extract_listingsmrscraper_extract_structured_datamrscraper_get_resultsmrscraper_get_latest_resultsmrscraper_get_result_detailmrscraper_create_prompt_scrapermrscraper_create_listing_scrapermrscraper_create_website_crawl_scrapermrscraper_run_existing_scrapermrscraper_run_existing_scraper_batchmrscraper_fetch_rendered_html

Environment variables it needs 1

MRSCRAPER_API_TOKEN

MrScraper for Hermes

This standalone plugin adds MrScraper as a web_search and web_extract provider and registers 15 mrscraper_* tools for SERP search, page rendering, crawling, extraction, scraper runs, and result retrieval.

Install

hermes plugins install ai-mrscraper/hermes-mrscraper-plugin

Configure MRSCRAPER_API_TOKEN when prompted, or store it in the active Hermes profile's .env file. Then select MrScraper under Web Search in hermes tools, or set:

web:
  search_backend: mrscraper
  extract_backend: mrscraper

The rendered-page tool performs independent requests; MrScraper does not expose a persistent CDP session for interactive browser_* actions.

The Playground API documents a required token query parameter, so rendered requests include it and the x-api-token header. The client redacts raw and URL-encoded token values from transport and API errors. The rendered tool defaults to a 120-second page timeout and permits an additional 30 seconds for the HTTP response.

Development

Use hermes plugins validate . to check the manifest, registered capabilities, and security scan. Tests use controlled HTTP responses and do not require an API token or billable requests.