All servers · Scraping & browsing

io.github.ZenRows/zenrows-mcp

io.github.ZenRows/zenrows-mcp · v2.16.0

Measured by MCP Station

Description written by the publisher, not verified

Zenrows MCP server: Fetch, Extract, Batch, and Browser Sessions for AI agents

Connect

claude mcp add --transport http zenrows-mcp https://mcp.zenrows.com/mcp

{
  "mcpServers": {
    "zenrows-mcp": {
      "url": "https://mcp.zenrows.com/mcp"
    }
  }
}

Tools as reported by the server

• scrape
  Scrape any webpage and return its content using Zenrows (Fetch). Returns full-page content (markdown/HTML/PDF/screenshot). For structured JSON fields (products, articles, listings), the extract tool returns parsed fields instead of a full page body. By default the request uses automatic mode (mode=a
• extract
  Extract structured data from a webpage via Zenrows. Returns JSON fields (products, articles, listings) in "data" rather than a full page body. Set include_html to also get the page HTML. Modes: - auto (default): extract=auto, site-tailored Extract (currently free, billing may apply later). Works on
• prepare_domain
  Prepare a domain so extract (mode=auto) works on it. Use this when extract returns error REQS007 with reason domain_not_prepared. Send the domain (the host, e.g. shop.example.com; a leading www. is dropped, and each host is prepared separately) and 1 to 5 example URLs: real pages you want extracted,
• prepared_domain_status
  Check a domain submitted with prepare_domain, and the account's monthly allowance. Returns status (preparing, ready or failed), state (the current step), roles (one per page kind), a failure code and detail when it failed, the allowance (used, limit, remaining) and "next": what to do now. Poll about
• batch_create
  Submit a Batch job: many URLs scraped asynchronously in the cloud (Zenrows Batch API). Suited to large URL lists; scrape and extract handle single pages. Not the same as browser_batch. Tasks use automatic mode (mode=auto) by default: Zenrows enables JS rendering and premium proxies only on the pages
• batch_status
  Get a Batch job's latest run: job_id, run_id, status (pending, running, completed, stopped, failed), stats (total, completed, successful, failed) and the job. A failed run answers ok:false with error.code BATCH_INSUFFICIENT_CREDITS, BATCH_KEY_CAP_REACHED, AUTH_INVALID (subscription_inactive) or BATC
• batch_wait
  Poll a Batch job until its run ends (completed, stopped or failed) or pauses, and return its status and stats like batch_status. If the wait runs out first, it returns the current state with ok:true, timed_out:true and a note: call batch_wait again. A paused run returns at once with paused:true (it
• batch_results
  List a Batch run's result rows, a page at a time: up to limit rows (default 100, max 1000) and next_cursor. Pass next_cursor back as cursor to continue; it is null once every row was read. Each row has task_id, external_id, url, metadata, status (successful, failed, pending, processing, expired), ty
• batch_content
  Read one Batch task's stored result, by job_id and task_id (from batch_results). A text result (HTML, Markdown, plain text, JSON) comes back inline, cut to max_chars (default 20000); a final note says when it was cut. A binary result (a PDF) is not inlined: the reply gives its result_url, presigned
• batch_list
  List this account's Batch jobs, newest first, each with its latest run's status and stats. Filter by status (open or closed) and type (regular or scheduled). Pass next_cursor as cursor for the next page; a page can hold fewer than limit jobs while next_cursor is still set, so keep paging until it is
• batch_cancel write/delete
  Stop a Batch job's current run for good. No task still waiting is started or billed; tasks already in flight finish (and bill). Results so far stay readable with batch_results. Tasks that never started stay pending: batch_rerun (default failed and pending) runs them later. Idempotent: a run that alr
• batch_pause
  Pause a Batch job's current run: it picks up no new tasks until batch_resume. Tasks already in flight still finish and bill; for a hard cost stop use batch_cancel. A paused run still counts as an active job. Idempotent; a run that already ended answers with its final status and already_ended:true.
• batch_resume
  Resume a paused Batch run: it picks up its remaining tasks again, billed as they finish. Idempotent on a run that is not paused; a run that already ended answers with its final status and already_ended:true. Needs credits: BATCH_INSUFFICIENT_CREDITS or BATCH_KEY_CAP_REACHED otherwise.
• batch_rerun
  Start a new run of a Batch job whose latest run ended (completed, stopped or failed). By default it reruns only the tasks that failed or never started (status ["failed", "pending"]), and carries the others' results over: the recovery after a run that failed on credits or was cancelled. Pass status t
• batch_delete write/delete
  Delete a Batch job with all its runs and results, for good. A run in flight stops picking up tasks at once, and the job frees its active-job slot. The job reads as not found right away; storage is cleaned up in the background. Idempotent. To keep the results, use batch_cancel instead.
• crawl_create
  Start a crawl from one URL (Zenrows Crawl API). Crawl follows the links in each page's HTML up to depth hops (no depth limit when depth is omitted), keeps the URLs that match include_patterns / exclude_patterns, and stays on the start URL's registrable domain (subdomains count). Use crawl when you h
• crawl_get
  Get a crawl and one page of the URLs it kept: crawl_id, status (running, completed, stopped, failed), the crawl (with coverage: pages_fetched, pages_failed, items_found), results and next_cursor. completed with stop_reason max_items / max_pages means a limit ended it; stopped with stop_reason user m
• crawl_results
  List the URLs a crawl kept, in the order it kept them, following the API's pages up to limit. Each result has url and, when the crawl has output_format, content_status (pending, fetched, failed) and, once fetched, content_url: pass it to crawl_content as content. While the crawl runs the list is par
• crawl_content
  Read the stored page of one URL a crawl kept, in the crawl's output_format. Works only for crawls created with an output_format, and only for results whose content_status is fetched. Pass crawl_id and content_id: a content id, or content_url from a crawl_results row. Returns the page as stored — raw
• crawl_list
  List this account's crawls, newest first, with status and coverage (no results). Pass next_cursor as cursor for the next page; next_cursor is absent on the last page.
• crawl_stop write/delete
  Stop a running crawl. No page still waiting is fetched or billed; pages already in flight finish. The URLs kept so far stay readable with crawl_results. A stopped crawl cannot resume. Idempotent: a crawl that already ended answers with its final status. A 429, 502, 503 or 504 is retried up to 3 time
• crawl_wait
  Poll a crawl until it ends (completed, stopped, or failed) and return its status, its counts and the first 20 URLs (first_urls). For every result, call crawl_download (one file) or crawl_results (pages). A crawl that ends completed with no results and no error finished; it is not a failure (see craw
• crawl_download
  Save every result of a crawl to one local file, as JSON lines: url, content_status and, once fetched, content (the page). Returns the file's path and line count, not the results, so a crawl of any size costs one small reply. Read the file with your own tools. The file goes to path when given (a rela
• account_usage
  Read the current plan's credit allowance and how much of it is spent. Useful before a large batch, or after a 402 / AUTH004, to see whether the account has credits left and when the allowance renews. The call is free and does not use a concurrency slot. Credit costs per request: 1 basic, 5 js_render
• browser_navigate
  Open a Zenrows Browser Sessions session and navigate to a URL. This is the entry point for all browser automation. It creates a new session backed by Zenrows' hosted browser infrastructure and navigates to the given URL in one step. Returns a session_id that every other browser_* tool takes. The ses
• browser_close
  Close a browser session and free all associated resources, including the concurrency slot it holds.
• browser_go_back
  Navigate back to the previous page in the browser history.
• browser_go_forward
  Navigate forward to the next page in the browser history.
• browser_reload
  Reload the current page of a browser session.
• browser_click
  Click an element on the page using a CSS selector.
• browser_hover
  Move the mouse cursor over an element to trigger hover effects.
• browser_type
  Type text into an input element. Appends to existing content unless clear_first is set.
• browser_fill
  Clear an input field and set its value, replacing what was there (browser_type appends instead).
• browser_select_option
  Select an option from a <select> dropdown element.
• browser_check
  Check a checkbox or radio button.
• browser_uncheck
  Uncheck a checkbox, found by CSS selector, in a browser session.
• browser_focus
  Move focus to an element, triggering focus-dependent UI changes.
• browser_press_key
  Press a keyboard key. Examples: "Enter", "Tab", "Escape", "ArrowDown", "Control+a".
• browser_scroll
  Scroll the page in a given direction.
• browser_drag
  Drag an element from its current position to a target element.
• browser_get_accessibility_tree
  Get the ARIA accessibility tree of the current page as readable text. Shows the page structure and the selectors needed to interact with elements, in fewer tokens than a screenshot. The tree shows all interactive elements (buttons, inputs, links) with their roles, labels, and states — everything nee
• browser_get_url
  Get the current URL of the browser session.
• browser_get_title
  Get the title of the current page.
• browser_get_text
  Get the visible text content of an element or the entire page body.
• browser_get_attribute
  Get the value of a specific attribute on an element.
• browser_get_html
  Get the HTML source of an element or the full page.
• browser_query_selector_all
  Find all elements matching a CSS selector and return their text, HTML, and attributes.
• browser_screenshot
  Take a screenshot of the current page or a specific element. Use for visual verification or when the accessibility tree is not sufficient.
• browser_generate_pdf
  Render the current page as a PDF document.
• browser_wait_for_selector
  Wait until an element matching the CSS selector is stable in the DOM. Set visible=true to also require the element to be visible (not hidden).
• browser_wait_for_navigation
  Wait for the page to navigate to a new URL. It waits for the next navigation event, so a navigation that already finished is not seen and the call waits until timeout_ms. Pages that update without changing URL (AJAX/SPA) fire no navigation event. Optional timeout_ms (default 30000ms).
• browser_wait
  Wait for a fixed duration. browser_wait_for_selector waits only until an element appears.
• browser_evaluate write/delete
  Execute JavaScript in the browser context and return the result. The script can change or delete the session's page state, such as cookies, storage and form data.
• browser_get_cookies
  Get all cookies for the current page.
• browser_set_cookies write/delete
  Set one or more cookies in the browser session. A cookie with the same name, domain and path replaces the existing one.
• browser_clear_cookies write/delete
  Clear all cookies for the current browser session.
• browser_get_local_storage
  Read one localStorage value in the current page context.
• browser_set_local_storage write/delete
  Write one localStorage value in the current page context. An existing value under the same key is replaced.
• browser_clear_local_storage write/delete
  Delete every localStorage entry in the current page context.
• browser_new_tab
  Open a new browser tab. Returns a tab_id to use with browser_switch_tab.
• browser_switch_tab
  Switch focus to a different browser tab.
• browser_batch write/delete
  Execute a sequence of browser actions in a single call against an existing session. Use this when you already know the full sequence of steps — it reduces round trips and is faster than calling each tool individually. Actions run sequentially and stop at the first failure unless stop_on_error is fal

Tool changes

• 2026-10-22: scrape, extract, prepare_domain, prepared_domain_status, batch_create, batch_status, batch_wait, batch_results, batch_content, batch_list, batch_cancel, batch_pause
• 2026-10-21: scrape, extract, prepare_domain, prepared_domain_status, batch_create, batch_status, batch_wait, batch_results, batch_content, batch_list, batch_cancel, batch_pause
• 2026-10-17: scrape, extract, batch_create, batch_status, batch_results, batch_cancel, batch_wait, crawl_create, crawl_get, crawl_results, crawl_content, crawl_list
• 2026-10-16: scrape, extract, batch_create, batch_status, batch_results, batch_cancel, batch_wait, crawl_create, crawl_get, crawl_results, crawl_content, crawl_list

Repository · JSON · Text for agents · Registry updated 2026-10-23