[{"_1":2,"_340":-5,"_341":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_24":25,"_276":277},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","gJaS3Mm3Jr","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":-5,"_27":28,"_29":30,"_196":197},"githubUser","maintainer",false,"mcpServer",{"_31":32,"_33":34,"_13":49,"_58":59,"_60":59,"_61":62,"_67":68,"_91":-5,"_92":93,"_94":95,"_96":97,"_77":115,"_116":82,"_117":-5,"_118":-5,"_119":120,"_121":122,"_129":-5,"_130":131,"_136":-5,"_104":78,"_137":138,"_142":143,"_17":193,"_194":195},"addedAt",["D",1742574426082],"argumentsJsonSchema",{"_35":36,"_46":47,"_41":48},"properties",{"_37":38,"_43":44},"OXYLABS_PASSWORD",{"_39":40,"_41":42},"description","Your Oxylabs account password","type","string","OXYLABS_USERNAME",{"_39":45,"_41":42},"Your Oxylabs account username","required",[43,37],"object",[50,51,52,53,54,55,56,57],"author:official","category:browser-automation","category:search","hosting:remote-capable","language:python","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","A scraper tool that leverages the Oxylabs Web Scraper API to fetch and process web content with flexible options for parsing and rendering pages, enabling efficient content extraction from complex websites.","descriptionPlainText","githubProject",{"_63":64,"_65":66},"readme","# MCP Server for Oxylabs Scraper\n[![smithery badge](https://smithery.ai/badge/@oxylabs/oxylabs-mcp)](https://smithery.ai/server/@oxylabs/oxylabs-mcp)\n\nA Model Context Protocol (MCP) server that enables AI assistants like Claude to seamlessly access web data through Oxylabs' powerful web scraping technology.\n\n## 📖 Overview\n\nThe Oxylabs MCP server provides a bridge between AI models and the web. It enables them to scrape any URL, render JavaScript-heavy pages, extract and format content for AI use, bypass anti-scraping measures, and access geo-restricted web data from 195+ countries.\n\nThis implementation leverages the Model Context Protocol (MCP) to create a secure, standardized way for AI assistants to interact with web content.\n\n## ✨ Key Features\n\n

Scrape content from any site

\n
\n\n- Extract data from any URL, including complex single-page applications\n- Fully render dynamic websites using headless browser support\n- Choose full JavaScript rendering, HTML-only, or none\n- Emulate Mobile and Desktop viewports for realistic rendering\n\n

\n\n

Automatically get AI-ready data

\n
\n\n- Automatically clean and convert HTML to Markdown for improved readability\n- Use automated parsers for popular targets like Google, Amazon, and etc.\n\n

\n\n

Bypass blocks & geo-restrictions

\n
\n\n- Bypass sophisticated bot protection systems with high success rate\n- Reliably scrape even the most complex websites\n- Get automatically rotating IPs from a proxy pool covering 195+ countries\n\n

\n\n

Flexible setup & cross-platform support

\n
\n\n- Set rendering and parsing options if needed\n- Feed data directly into AI models or analytics tools\n- Works on macOS, Windows, and Linux\n\n

\n\n

Built-in error handling and request management

\n
\n\n- Comprehensive error handling and reporting\n- Smart rate limiting and request management\n\n

\n\n\n## 💡 Example Queries\nWhen you've set up the MCP server with **Claude**, you can make requests like:\n\n

Could you scrape https://www.google.com/search?q=ai page?

Scrape https://www.amazon.de/-/en/Smartphone-Contract-Function-Manufacturer-Exclusive/dp/B0CNKD651V with parse enabled

Scrape https://www.amazon.de/-/en/gp/bestsellers/beauty/ref=zg_bs_nav_beauty_0 with parse and render enabled

Use web unblocker with render to scrape https://www.bestbuy.com/site/top-deals/all-electronics-on-sale/pcmcat1674241939957.c

\n\n\n## ✅ Prerequisites\n\nBefore you begin, make sure you have:\n\n- **Oxylabs Account**: Obtain your username and password from [Oxylabs](https://dashboard.oxylabs.io/) (1-week free trial available)\n\n### Basic Usage (via Smithery CLI)\n- **Node.js** (v16+)\n- `npx` command-line tool\n\n### Local/Dev Setup\n- **Python 3.12+**\n- `uv` package manager – install it using [this guide](https://docs.astral.sh/uv/getting-started/installation/)\n\n## 🧩 API Parameters\n\nThe Oxylabs MCP server supports these parameters:\n\n| Parameter | Description | Values |\n|-----------|-------------|--------|\n| `url` | The URL to scrape | Any valid URL |\n| `parse` | Enable structured data extraction | `True` or `False` |\n| `render` | Use headless browser rendering | `html` or `None` |\n\n## ⚙️ Basic Setup Instructions\n\n### Install via Smithery\n\nAutomatically install Oxylabs MCP server for Claude Desktop via [Smithery](https://smithery.ai/server/@oxylabs/oxylabs-mcp):\n\n```bash\nnpx -y @smithery/cli install @oxylabs/oxylabs-mcp --client claude\n```\n---\n### Run on Cursor\n\n> [!IMPORTANT]\n> Requires Cursor version `0.45.6+`\n\nTo configure Oxylabs in Cursor:\n\n1. Open Cursor **Settings**\n2. Go to **Features > MCP Servers** \n3. Click \"**+ Add New MCP Server**\"\n4. Enter the following:\n - **Name**: `oxylabs` (or your preferred name)\n - **Type**: `command`\n - **Command**:`npx -y @smithery/cli@latest run @oxylabs/oxylabs-mcp --config \"{\\\"oxylabsUsername\\\":\\\"YOUR_USERNAME\\\",\\\"oxylabsPassword\\\":\\\"YOUR_PASSWORD\\\"}\"`\n \nReplace `your-username` and `your-password` with your Oxylabs credentials.\n\n> [!TIP]\n> If you're using Windows and run into issues, try this:\n> \n> `cmd /c \"set OXYLABS_USERNAME=your-username && set OXYLABS_PASSWORD=your-password && npx -y oxylabs-mcp\"`\n\nAfter that, refresh the MCP server list to see the new tools. The Composer Agent will automatically use Oxylabs when appropriate, but you can explicitly request it by describing your web scraping needs. Access the Composer via `Command+L` (Mac), select \"Agent\" next to the submit button, and enter your query.\n\n---\n### Set up with Claude Desktop\n\nEnable **Developer Mode** and then navigate to **Claude → Settings → Developer → Edit Config** and edit your `claude_desktop_config.json` file as follows:\n\n```json\n{\n \"mcpServers\": {\n \"oxylabs_scraper\": {\n \"command\": \"uvx\",\n \"args\": [\"oxylabs-mcp\"],\n \"env\": {\n \"OXYLABS_USERNAME\": \"YOUR_USERNAME_HERE\",\n \"OXYLABS_PASSWORD\": \"YOUR_PASSWORD_HERE\"\n }\n }\n }\n}\n```\n---\n\n## 💻 Local/Dev Setup Instructions\n\n### Clone repository\n\n```\ngit clone \n```\n\n### Install dependencies\n\nInstall MCP server dependencies:\n\n```bash\ncd mcp-server-oxylabs\n\n# Create virtual environment and activate it\nuv venv\n\nsource .venv/bin/activate # MacOS/Linux\n# OR\n.venv/Scripts/activate # Windows\n\n# Install dependencies\nuv sync\n```\n\n### Setup with Claude Desktop\n\nEnable **Developer Mode** and then navigate to **Claude → Settings → Developer → Edit Config** and edit your `claude_desktop_config.json` file as follows:\n\n```json\n{\n \"mcpServers\": {\n \"oxylabs_scraper\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"//oxylabs-mcp\",\n \"run\",\n \"oxylabs-mcp\"\n ],\n \"env\": {\n \"OXYLABS_USERNAME\": \"YOUR_USERNAME_HERE\",\n \"OXYLABS_PASSWORD\": \"YOUR_PASSWORD_HERE\"\n }\n }\n }\n}\n```\n---\n### 🐞 Debugging\n\n```bash\nmake run\n```\nThen access MCP Inspector at `http://localhost:5173`. You may need to add your username and password as environment variables in the inspector under `OXYLABS_USERNAME` and `OXYLABS_PASSWORD`.\n\n\n## 🛠️ Technical Details\n\nThis server provides two main tools:\n\n1. **oxylabs_scraper**: Uses Oxylabs Web Scraper API for general website scraping\n2. **oxylabs_web_unblocker**: Uses Oxylabs Web Unblocker for hard-to-access websites\n\n[Web Scraper API](https://oxylabs.io/products/scraper-api/web) supports JavaScript rendering, parsed structured data, and cleaned HTML in Markdown format. [Web Unblocker](https://oxylabs.io/products/web-unblocker) offers JavaScript rendering and cleaned HTML, but doesn’t return parsed data.\n\n---\n\n> [!WARNING]\n> Usage with the MCP Inspector is affected by an ongoing issue with the Python SDK for MCP, see: https://github.com/modelcontextprotocol/python-sdk/pull/85. For Claude, a forked version of the SDK is used as a temporary fix.\n\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## About Oxylabs\n\nEstablished in 2015, Oxylabs is a market-leading web intelligence collection\nplatform, driven by the highest business, ethics, and compliance standards,\nenabling companies worldwide to unlock data-driven insights.\n\n[![image](https://oxylabs.io/images/og-image.png)](https://oxylabs.io/)\n","url","https://github.com/oxylabs/oxylabs-mcp","githubRepository",{"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":80,"_84":85,"_86":87,"_89":90},"defaultBranch","main","fullName","oxylabs/oxylabs-mcp","githubTreeId",104783,"language","Python","name","oxylabs-mcp","owner",{"_81":82,"_17":83},"login","oxylabs","soqzNp8qpd","recentStargazers",2,"spdxLicense",{"_77":88},"MIT License","stargazers",8,"glamaJson","id",2678,"inspectable",true,"integrations",[98,108],{"_99":100,"_39":106,"_17":107},"brand",{"_101":102,"_77":103,"_104":105},"logoSvgPath","M.045 18.02c.072-.116.187-.124.348-.022 3.636 2.11 7.594 3.166 11.87 3.166 2.852 0 5.668-.533 8.447-1.595l.315-.14c.138-.06.234-.1.293-.13.226-.088.39-.046.525.13.12.174.09.336-.12.48-.256.19-.6.41-1.006.654-1.244.743-2.64 1.316-4.185 1.726a17.617 17.617 0 01-10.951-.577 17.88 17.88 0 01-5.43-3.35c-.1-.074-.151-.15-.151-.22 0-.047.021-.09.051-.13zm6.565-6.218c0-1.005.247-1.863.743-2.577.495-.71 1.17-1.25 2.04-1.615.796-.335 1.756-.575 2.912-.72.39-.046 1.033-.103 1.92-.174v-.37c0-.93-.105-1.558-.3-1.875-.302-.43-.78-.65-1.44-.65h-.182c-.48.046-.896.196-1.246.46-.35.27-.575.63-.675 1.096-.06.3-.206.465-.435.51l-2.52-.315c-.248-.06-.372-.18-.372-.39 0-.046.007-.09.022-.15.247-1.29.855-2.25 1.82-2.88.976-.616 2.1-.975 3.39-1.05h.54c1.65 0 2.957.434 3.888 1.29.135.15.27.3.405.48.12.165.224.314.283.45.075.134.15.33.195.57.06.254.105.42.135.51.03.104.062.3.076.615.01.313.02.493.02.553v5.28c0 .376.06.72.165 1.036.105.313.21.54.315.674l.51.674c.09.136.136.256.136.36 0 .12-.06.226-.18.314-1.2 1.05-1.86 1.62-1.963 1.71-.165.135-.375.15-.63.045a6.062 6.062 0 01-.526-.496l-.31-.347a9.391 9.391 0 01-.317-.42l-.3-.435c-.81.886-1.603 1.44-2.4 1.665-.494.15-1.093.227-1.83.227-1.11 0-2.04-.343-2.76-1.034-.72-.69-1.08-1.665-1.08-2.94l-.05-.076zm3.753-.438c0 .566.14 1.02.425 1.364.285.34.675.512 1.155.512.045 0 .106-.007.195-.02.09-.016.134-.023.166-.023.614-.16 1.08-.553 1.424-1.178.165-.28.285-.58.36-.91.09-.32.12-.59.135-.8.015-.195.015-.54.015-1.005v-.54c-.84 0-1.484.06-1.92.18-1.275.36-1.92 1.17-1.92 2.43l-.035-.02zm9.162 7.027c.03-.06.075-.11.132-.17.362-.243.714-.41 1.05-.5a8.094 8.094 0 011.612-.24c.14-.012.28 0 .41.03.65.06 1.05.168 1.172.33.063.09.099.228.099.39v.15c0 .51-.149 1.11-.424 1.8-.278.69-.664 1.248-1.156 1.68-.073.06-.14.09-.197.09-.03 0-.06 0-.09-.012-.09-.044-.107-.12-.064-.24.54-1.26.806-2.143.806-2.64 0-.15-.03-.27-.087-.344-.145-.166-.55-.257-1.224-.257-.243 0-.533.016-.87.046-.363.045-.7.09-1 .135-.09 0-.148-.014-.18-.044-.03-.03-.036-.047-.02-.077 0-.017.006-.03.02-.063v-.06z","Amazon","slug","amazon","Extracts structured data from Amazon product and category pages using dedicated parsers, with options for both desktop and mobile viewports","osepe3qt1b",{"_99":109,"_39":113,"_17":114},{"_101":110,"_77":111,"_104":112},"M12.48 10.92v3.28h7.84c-.24 1.84-.853 3.187-1.787 4.133-1.147 1.147-2.933 2.4-6.053 2.4-4.827 0-8.6-3.893-8.6-8.72s3.773-8.72 8.6-8.72c2.6 0 4.507 1.027 5.907 2.347l2.307-2.307C18.747 1.44 16.133 0 12.48 0 5.867 0 .307 5.387.307 12s5.56 12 12.173 12c3.573 0 6.267-1.173 8.373-3.36 2.16-2.16 2.84-5.213 2.84-7.667 0-.76-.053-1.467-.173-2.053H12.48z","Google","google","Extracts structured data from Google search result pages using dedicated parsers, allowing access to search results across various regions","zdgixldss7","Oxylabs MCP Server","namespace","npmPackage","prompts","redditPostForeignId","1jluszn","relatedMcpServerIds",[123,124,125,126,127,128],2063,897,2005,241,385,2406,"resources","scores",{"_132":133,"_134":133,"_135":133},"license",100,"quality","security","simpleIcon","supportedPlatforms",[139,140,141],"MACOS","WINDOWS","LINUX","tools",[144,178],{"_77":145,"_39":146,"_147":148},"oxylabs_scraper","Scrape url using Oxylabs Web Api","inputSchema",{"_41":48,"_149":150,"_46":151,"_35":152},"title","scrape_urlArguments",[65],{"_65":153,"_156":157,"_167":168},{"_41":42,"_149":154,"_39":155},"Url","Url to scrape","parse",{"_158":159,"_149":164,"_165":-5,"_39":166},"anyOf",[160,162],{"_41":161},"boolean",{"_41":163},"null","Parse","default","Should result be parsed. If result should not be parsed then html will be stripped and converted to markdown file","render",{"_158":169,"_149":176,"_165":-5,"_39":177},[170,175],{"_171":172,"_41":42},"enum",[173,174],"html","None",{"_41":163},"Render","Whether a headless browser should be used to render the page. See: https://developers.oxylabs.io/scraper-apis/web-scraper-api/features/javascript-rendering `html` will return rendered html page `None` will not use render for scraping.",{"_77":179,"_39":180,"_147":181},"oxylabs_web_unblocker","Scrape url using Oxylabs Web Unblocker",{"_41":48,"_149":182,"_46":183,"_35":184},"scrape_with_web_unblockerArguments",[65],{"_65":185,"_167":187},{"_41":42,"_149":154,"_39":186},"Url to scrape with web unblocker",{"_158":188,"_149":176,"_165":-5,"_39":192},[189,191],{"_171":190,"_41":42},[173,174],{"_41":163},"Whether a headless browser should be used to render the page. See: https://developers.oxylabs.io/advanced-proxy-solutions/web-unblocker/headless-browser/javascript-rendering `html` will return rendered html page `None` will not use render for scraping.","y2mjvi456d","updatedAt",["D",1743505398809],"meta",[198,200,202,209,212,214,217,220,223,226,229,231,234,237,239,241,243,245,247],{"_149":199},"Oxylabs MCP Server | Glama",{"_201":59,"_77":39},"content",{"_203":204,"_205":206,"_207":208},"href","https://glama.ai/mcp/servers/@oxylabs/oxylabs-mcp","rel","canonical","tagName","link",{"_201":115,"_210":211},"property","og:title",{"_201":59,"_210":213},"og:description",{"_201":215,"_210":216},"https://glama.ai/logo.png","og:logo",{"_201":218,"_210":219},"https://glama.ai/mcp/servers/@oxylabs/oxylabs-mcp/og-image","og:image",{"_201":221,"_210":222},"630","og:image:height",{"_201":224,"_210":225},"1200","og:image:width",{"_201":227,"_210":228},"website","og:type",{"_201":204,"_210":230},"og:url",{"_201":232,"_210":233},"ChatGPT alternative for power users","og:site_name",{"_201":235,"_77":236},"summary_large_image","twitter:card",{"_201":232,"_77":238},"twitter:title",{"_201":59,"_77":240},"twitter:description",{"_201":218,"_77":242},"twitter:image",{"_201":221,"_77":244},"twitter:image:height",{"_201":224,"_77":246},"twitter:image:width",{"_248":249},"script:ld+json",{"_250":251,"_252":253},"@context","http://schema.org","@graph",[254],{"_250":255,"_256":257,"_258":259},"https://schema.org","@type","BreadcrumbList","itemListElement",[260,267,270,274],{"_256":261,"_262":263,"_77":264,"_265":266},"ListItem","item","https://glama.ai/","Glama","position",1,{"_256":261,"_262":268,"_77":269,"_265":85},"https://glama.ai/mcp","MCP",{"_256":261,"_262":271,"_77":272,"_265":273},"https://glama.ai/mcp/servers","Servers",3,{"_256":261,"_262":204,"_77":115,"_265":275},4,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~branch/~/_route",{"_278":279,"_283":70,"_29":284,"_330":331,"_332":333},"blob",{"_201":280,"_281":282},"from . import server\n\n\ndef main():\n \"\"\"Main entry point for the package.\"\"\"\n server.main()\n\n\n# Optionally expose other important items at package level\n__all__ = [\"main\", \"server\"]\n","fileName","__init__.py","branch",{"_31":285,"_33":286,"_13":291,"_58":59,"_60":59,"_61":292,"_67":293,"_91":-5,"_92":93,"_94":95,"_96":296,"_77":115,"_116":82,"_117":-5,"_118":-5,"_119":120,"_121":301,"_129":-5,"_130":302,"_136":-5,"_104":78,"_137":303,"_142":304,"_17":193,"_194":329},["D",1742574426082],{"_35":287,"_46":290,"_41":48},{"_37":288,"_43":289},{"_39":40,"_41":42},{"_39":45,"_41":42},[43,37],[50,51,52,53,54,55,56,57],{"_63":64,"_65":66},{"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":294,"_84":85,"_86":295,"_89":90},{"_81":82,"_17":83},{"_77":88},[297,299],{"_99":298,"_39":106,"_17":107},{"_101":102,"_77":103,"_104":105},{"_99":300,"_39":113,"_17":114},{"_101":110,"_77":111,"_104":112},[123,124,125,126,127,128],{"_132":133,"_134":133,"_135":133},[139,140,141],[305,319],{"_77":145,"_39":146,"_147":306},{"_41":48,"_149":150,"_46":307,"_35":308},[65],{"_65":309,"_156":310,"_167":314},{"_41":42,"_149":154,"_39":155},{"_158":311,"_149":164,"_165":-5,"_39":166},[312,313],{"_41":161},{"_41":163},{"_158":315,"_149":176,"_165":-5,"_39":177},[316,318],{"_171":317,"_41":42},[173,174],{"_41":163},{"_77":179,"_39":180,"_147":320},{"_41":48,"_149":182,"_46":321,"_35":322},[65],{"_65":323,"_167":324},{"_41":42,"_149":154,"_39":186},{"_158":325,"_149":176,"_165":-5,"_39":192},[326,328],{"_171":327,"_41":42},[173,174],{"_41":163},["D",1743505398809],"path","src/oxylabs_mcp","treeMembers",[334,336,338],{"_330":335,"_41":278},"src/oxylabs_mcp/__init__.py",{"_330":337,"_41":278},"src/oxylabs_mcp/server.py",{"_330":339,"_41":278},"src/oxylabs_mcp/utils.py","actionData","errors"]