Skip to content
Back to search

mcp-server-rag-web-browser

A MCP Server for the RAG Web Browser Actor

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/apify--mcp-server-rag-web-browser/badge.svg)](/listings/apify--mcp-server-rag-web-browser)

HTML

<a href="/listings/apify--mcp-server-rag-web-browser"><img src="/api/listings/apify--mcp-server-rag-web-browser/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 151 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Server for the RAG Web Browser Actor 🌐
  2. Implementation of an MCP server for the [RAG Web Browser Actor](https://apify.com/apify/rag-web-browser).
  3. This Actor serves as a web browser for large language models (LLMs) and RAG pipelines, similar to a web search in ChatGPT.
  4. > **This MCP server is deprecated in favor of [mcp.apify.com](https://mcp.apify.com)**
  5. >
  6. > For the same functionality and much more, please use one of these alternatives:
  7. ## 🚀 Recommended: use mcp.apify.com
  8. The easiest way to get the same web browsing capabilities is to use **[mcp.apify.com](https://mcp.apify.com)** with default settings.
  9. **Benefits:**
  10. - ✅ No local setup required
  11. - ✅ Always up-to-date
  12. - ✅ Access to 6,000+ Apify Actors (including RAG Web Browser)
  13. - ✅ OAuth support for easy connection
  14. - ✅ Dynamic tool discovery
  15. **Quick Setup:**
  16. 1. Go to https://mcp.apify.com
  17. 2. Authorize the client (Claude, VS Code, etc.)
  18. 3. Copy the generated MCP server configuration (or use OAuth flow if supported)
  19. 4. Start using browsing & other tools immediately
  20. ## 🌐 Alternative: direct RAG Web Browser integration
  21. You can also call the [RAG Web Browser Actor](https://apify.com/apify/rag-web-browser) directly via its HTTP/SSE interface.
  22. **Benefits:**
  23. - ✅ Direct integration without mcp.apify.com
  24. - ✅ Real-time streaming via Server-Sent Events
  25. - ✅ Full control over the integration
  26. - ✅ No additional dependencies
  27. **Docs:** [Actor Documentation](https://apify.com/apify/rag-web-browser#anthropic-model-context-protocol-mcp-server)
  28. ---
  29. ## 🎯 What does this MCP server do?
  30. This server is specifically designed to provide fast responses to AI agents and LLMs, allowing them to interact with the web and extract information from web pages.
  31. It runs locally and communicates with the [RAG Web Browser Actor](https://apify.com/apify/rag-web-browser) in [**Standby mode**](https://docs.apify.com/platform/actors/running/standby),
  32. sending search queries and receiving extracted web content in response.
  33. - **Web Search**: Query Google Search, scrape top N URLs, and return cleaned content as Markdown
  34. - **Single URL Fetching**: Fetch a specific URL and return its content as Markdown
  35. - **Local MCP Integration**: Standard input/output (stdio) communication with AI clients
  36. ## 🧱 Components
  37. ### Tools
  38. - name: `search`
  39. description: Query Google Search OR fetch a direct URL and return cleaned page contents.
  40. arguments:
  41. - `query` (string, required): Search keywords or a full URL. Advanced Google operators supported.
  42. - `maxResults` (number, optional, default: 1): Max organic results to fetch (ignored when `query` is a URL).
  43. - `scrapingTool` (string, optional, default: `raw-http`): One of `browser-playwright` | `raw-http`.
  44. - `raw-http`: Fast (no JS execution) – good for static pages.
  45. - `browser-playwright`: Handles JS-heavy sites – slower, more robust.
  46. - `outputFormats` (array of strings, optional, default: [`markdown`]): One or more of `text`, `markdown`, `html`.
  47. - `requestTimeoutSecs` (number, optional, default: 40, min 1 max 300): Total server-side AND client wait budget. A local abort is enforced.
  48. ## 🔄 Migration Guide
  49. ### From Local MCP Server to mcp.apify.com
  50. **Before (Deprecated local server):**
  51. ```json
  52. {
  53. "mcpServers": {
  54. "rag-web-browser": {
  55. "command": "npx",
  56. "args": ["@apify/mcp-server-rag-web-browser"],
  57. "env": {
  58. "APIFY_TOKEN": "your-apify-api-token"
  59. }
  60. }
  61. }
  62. }
  63. ```
  64. **After (Recommended Apify server):**
  65. ```json
  66. {
  67. "mcpServers": {
  68. "apify": {
  69. "command": "npx",
  70. "args": ["@apify/actors-mcp-server"],
  71. "env": {
  72. "APIFY_TOKEN": "your-apify-api-token"
  73. }
  74. }
  75. }
  76. }
  77. ```
  78. Or use the hosted endpoint: `https://mcp.apify.com` (when your client supports HTTP transport / remote MCP).
  79. ### MCP clients
  80. - Claude Desktop: https://claude.ai/download
  81. - Visual Studio Code
  82. - Apify Tester MCP Client: https://apify.com/jiri.spilka/tester-mcp-client
  83. ## 🛠️ Development
  84. ### Prerequisites
  85. - Node.js (v18 or higher)
  86. - Apify API Token (`APIFY_TOKEN`)
  87. Clone & install:
  88. ```bash
  89. git clone https://github.com/apify/mcp-server-rag-web-browser.git
  90. cd mcp-server-rag-web-browser
  91. npm install
  92. ```
  93. ### Build
  94. ```bash
  95. npm install
  96. npm run build
  97. ```
  98. ### Debugging
  99. Since MCP servers operate over standard input/output (stdio), debugging can be challenging.
  100. For the best debugging experience, use the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
  101. You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
  102. ```bash
  103. export APIFY_TOKEN=your-apify-api-token
  104. npx @modelcontextprotocol/inspector node dist/index.js
  105. ```
  106. Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
  107. # 📖 Learn more
  108. - [Model Context Protocol](https://modelcontextprotocol.org/)
  109. - [RAG Web Browser Actor](https://apify.com/apify/rag-web-browser)
  110. - [What are AI Agents?](https://blog.apify.com/what-are-ai-agents/)
  111. - [What is MCP and why does it matter?](https://blog.apify.com/what-is-model-context-protocol/)
  112. - [How to use MCP with Apify Actors](https://blog.apify.com/how-to-use-mcp/)
  113. - [Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client)
  114. - [Webinar: Building and Monetizing MCP Servers on Apify](https://www.youtube.com/watch?v=w3AH3jIrXXo)
  115. - [How to build and monetize an AI agent on Apify](https://blog.apify.com/how-to-build-an-ai-agent/)
  116. - [Build and deploy MCP servers in minutes with a TypeScript template](https://blog.apify.com/build-and-deploy-mcp-servers-typescript/)
  117. *This repository is maintained for archival purposes only. Please use the recommended alternatives above for active development.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.