Skip to directory

About Oxylabs Web Scraping

Self-hostable MCP server for Oxylabs Web API, providing live web search, page scraping, queued scrape retrieval, large-result reading, and target-specific scraping.

What you can use it for

  • Search the live web and scrape pages, including JavaScript-heavy pages.
  • Retrieve queued or oversized scrape results and call target-specific parsers.
Connection and setup
Hosting
self-hosted
Transport
stdio
Endpoint
Local process; no hosted endpoint documented
Authentication
Oxylabs Web API key via OXYLABS_WEB_API_KEY or per-request Bearer authorization.

Requirements

  • Oxylabs Web API key via OXYLABS_WEB_API_KEY or per-request Bearer authorization.

Setup steps

  1. Use the official repository installation instructions: https://github.com/oxylabs/web-api-mcp.
  2. Oxylabs Web API key via OXYLABS_WEB_API_KEY or per-request Bearer authorization.
Tools 6

Oxylabs maintainer repository lists all six stored tools and annotates them read-only; API calls require an Oxylabs Web API key.

  • search

    Search the live web for ranked organic results.

    01
  • scrape

    Scrape a URL as Markdown or structured data.

    02
  • check_scrape

    Collect the result of a background scrape.

    03
  • read_scraped

    Read a large local scrape result in chunks.

    04
  • list_scrapers

    List available Oxylabs scrape endpoints and parameters.

    05
  • scrape_target

    Call an Oxylabs target-specific scrape endpoint.

    06
Limitations and notes
  • Requires an Oxylabs Web API key; scraping and structured data features may incur API usage.
  • Self-hosted HTTP mode has no built-in server authentication, so the publisher recommends network controls and host/origin allowlists.
Original sources
  • official tool reference

    Oxylabs official repository enumerates exactly six readOnlyHint tools matching stored rows. Server is self-hostable; an Oxylabs Web API key is required for API-backed calls.

  • official documentation or source

    Oxylabs official repository enumerates exactly six readOnlyHint tools matching stored rows. Server is self-hostable; an Oxylabs Web API key is required for API-backed calls.

Documentation checked 2026-10-28T13:00:03.000Z. Connection has not been runtime tested.