Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@JedSearch MCP Server search for latest MCP specification updates"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Model Context Protocol (MCP) server for web search with embedded Playwright browser.
JedSearch combines a web search API client with an embedded Playwright browser to deliver accurate, real-time web content:
Search – Queries the search API for top results by query.
Render – Launches a headless Chromium browser via Playwright WebSocket (ws://127.0.0.1:3000) to render JavaScript-heavy pages.
Extract – Strips UI noise (navbars, footers, ads, cookie banners) using CSS selectors, then parses clean HTML with unstructured.partition_html.
Fallback – If Playwright is unavailable, falls back to raw HTTP fetch with httpx.
Retry – Each page fetch retries up to 3 times with exponential backoff (0.5s × 1.5^n).
The container starts Playwright as a background sidecar process via entrypoint.sh, then runs the MCP server in the foreground on port 3001 (SSE or streamable-http transport).
Related MCP server: MCP MyZ Search
Tool | Description |
web_search | Search the web and fetch full page content for top results. Ideal for finding up-to-date API documentation, changelogs, release notes, or any information requiring live web lookup. Returns title, URL, strategy, and content for each result. |
fetch_web_page | Fetch full page content from a single URL. Renders JavaScript via Playwright, falls back to HTTP. Returns title, URL, strategy, and content. |
Variable | Description | Default |
| Search API key | Required |
| Cloud folder ID | Required |
| Search region ( |
|
| API key for authentication | (optional) |
| Transport mode ( |
|
| Port for SSE mode |
|
| Playwright timeout (ms) |
|
| HTTP fallback timeout (s) |
|
| Max content length (chars) |
|
| Noise threshold (chars) |
|
| Max retry attempts |
|
| Initial retry delay (s) |
|
| Backoff multiplier |
|
services:
jedsearch:
build: .
container_name: jedsearch
restart: unless-stopped
ports:
- "3001:3001"
environment:
YANDEX_SEARCH_API_KEY: "${YANDEX_SEARCH_API_KEY}"
YANDEX_FOLDER_ID: "${YANDEX_FOLDER_ID}"
YANDEX_SEARCH_REGION: "${YANDEX_SEARCH_REGION:-ru}"
JEDSEARCH_API_KEY: "${JEDSEARCH_API_KEY}"
MCP_TRANSPORT: streamable-http
MCP_PORT: "3001"
healthcheck:
test: ["CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:3001/health')"]
interval: 10s
timeout: 5s
retries: 3With a matching .env:
YANDEX_SEARCH_API_KEY=your-yandex-search-api-key
YANDEX_FOLDER_ID=your-yandex-folder-id
YANDEX_SEARCH_REGION=ru
JEDSEARCH_API_KEY=your-jedsearch-api-keyStart with:
cd jed-web-search-mcp-server
docker compose up --build --waitYANDEX_SEARCH_API_KEY=... YANDEX_FOLDER_ID=... python3 server.pyReplace the URL with your own server address:
{
"servers": {
"JedSearch": {
"url": "http://your-server-address:3001/mcp",
"type": "http",
"headers": {
"X-API-Key": "your-api-key-here",
"X-Search-Region": "ru"
}
}
}
}This server cannot be deployed
Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.
Web search, URL content extraction to Markdown, site mapping, and recursive web crawler.
Reliable web fetching for AI agents with retry, circuit breaker, caching, and anti-bot bypass
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
