# MCP MyZ Search

Poorman's search mcp.

## Usage


```
npx playwright install chromium
npx mcp-myz-search
```

## Command line options
```
Usage: program [options]

Options:
  --default-provider <provider>  default search provider (choices: "bing", "duckduckgo", "google", default: "bing")
  --port <number>                port number
  --proxy <proxy>                proxy server
  --timeout <ms>                 navigation timeout in ms
  --headed                       headed mode
  --channel <name>               browser channel (default: "chrome")
  --profile <dir>                persistent user data directory
  --human-wait <ms>              wait ms for human to solve challenge
  --stdio                        use stdio transport instead of HTTP
  --log-file <path>              log file path (default: stderr)
  -h, --help                     display help for command
```

## Server Parameters (startup only)
- `--port <number>` or `MYZ_SEARCH_PORT` (fallback `PORT`), default `3000`.
- `--proxy <http|socks URL>` or `MYZ_SEARCH_PROXY` applied to Playwright.
- `--timeout <ms>` or `MYZ_SEARCH_TIMEOUT` for navigation/default timeouts.
- `--profile <dir>` or `MYZ_SEARCH_PROFILE_DIR` to persist session/cookies.
- `--human-wait <ms>` or `MYZ_SEARCH_HUMAN_WAIT` to allow human challenge solve in non-headless.

## MCP HTTP Endpoint
- Streamable HTTP MCP at `POST /mcp` using `@modelcontextprotocol/sdk`.
- Tools:
  - `search-links` args `{ q: string; limit?: number<=50; provider?: 'bing'|'duckduckgo'|'google' }` returns `{ results: Array<{link,title,snippet}>, total }`.
    - Provider defaults to `bing`, or you can change it via `--default-provider` switch.
  - `extract-page-text` args `{ url: string; selector?: string }` returns `{ text, isContentPage, url, message }`.

## Providers
- `bing`
- `duckduckgo`
- `google`

## Examples
- Custom port + proxy: `npx mcp-myz-search --port 3100 --proxy socks5://127.0.0.1:1080`
- Persistent profile + human wait: `npx mcp-myz-search --headed --profile ~/.myz-bing --human-wait 20000`

Notes
- The server reuses a single Playwright browser/context/page and serializes access to improve performance.
- Challenge pages are detected; when not using API, you can allow human solve via `--human-wait` in non-headless mode.
- Text extraction prefers `main`, `#content`, `article`, or a provided selector; returns a message when content is not found.