Oxylabs MCP Server
Official Oxylabs MCP server: page scraping with JS rendering, Google and Amazon results, an AI crawler
Install
claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
--header "Authorization: Basic $(echo -n 'YOUR_USERNAME:YOUR_PASSWORD' | base64)" \
--header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"Hosted server; keep only the headers for credentials you have.
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent two tool sets. Web Scraper API fetches any page with JavaScript rendering and geotargeting and returns Markdown or HTML, and parses Google results plus Amazon search and product pages. AI Studio adds prompt-based extraction, site crawling, browser control, web search, site URL mapping and schema generation for extraction. Which tools work depends on the credentials you provide.
Who it is for. For analysts and developers who need the agent to fetch data from sites that block plain requests.
Good fit when
- You need the content of a JavaScript-rendered page
- You need Google results or Amazon product data in structured form
- You need to crawl several pages of a site and collect data by description
Not a fit when
- The agent's regular web search or fetch tool is enough
- The site's terms forbid automated data collection
Example request
Get the top ten Google results for "video editing laptop" in the US and put them in a tableLimitations
A paid service: requires a Web Scraper API account with username and password or an AI Studio key, with a trial and starter credits. Clients that support only OAuth for remote servers cannot pass headers to the hosted server and must run it locally. Availability from Russia is unverified.
How to disable. Remove the oxylabs server from the client config; in Claude Code use claude mcp remove oxylabs.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| OXYLABS_USERNAME | Web Scraper API username |
| OXYLABS_PASSWORD secret | Web Scraper API password |
| OXYLABS_AI_STUDIO_API_KEY secret | AI Studio API key |
| LOG_LEVEL | Log level, INFO by default |
Security check
- Uses a paid network service and spends credits
- Stores Oxylabs account credentials
README in short
The README lists ten tools in two groups and the credential requirements. It describes two paths: the hosted server with auth headers, including a Claude Code command, and local launch via uvx with environment variables. It also covers a streamable-http mode for self-hosting and the log format. MIT licensed.
FAQ
Do I need both accounts?
No. Username and password enable the Web Scraper API tools, an AI Studio key enables the AI tools, and both give you everything.
Can I use it without installing?
Yes, the hosted server at https://mcp.oxylabs.io/mcp takes credentials via headers.
Related
CLI, skill and Python library for browser control: the agent clicks, fills forms and reads pages over CDP
A skill that gathers the last 30 days of discussion on a topic from Reddit, X, YouTube, HN, Polymarket and GitHub into one brief
The Chrome DevTools team's official MCP server: the agent drives a live Chrome, reads network and console, and records performance traces
A fast Rust CLI for agent browser automation: accessibility snapshots with element refs, an MCP server and skills