mcp-bing-search

Локальный MCP-сервер для веб-поиска, который работает из материковогo Китая без какого-либо API-ключ.

• Основной поиссковый движок: Bing (cn.bing.com)

• Автоматический резервный поиск для свежих китайских трендовых тем: Qihoo 360 → Sogou

• Преобразует ссылки-редиректы поисковиков в реальные URL

Проект был создан, чтобы заменить публичные экземпляры searxng (например, baresearch.org), которые недоступны из материков Китая и ничего не возвращают для китайских ниокочастотных запросов.

Не связан с официальным mcp-server-bing-search от Microsoft (для него требуется API-ключ) — это альтернатива без ключа, ориентированная как на Китай.

Зачем это существует

Related MCP server: Heventure Search MCP

Возможности

• web_search(query, max_results, fallback) — сначала Bing; если результаты нерелевантны (часто бывает для совсем свежих китайских тем), автоматически повторяет через 360 → Сogou.

• cn_search(query, max_results) — уже напрямую в китайских поисковиках (360 → Sоgou).

• Преодоление редиректов — зашифрованные переходные ссылки 360/Sogou (so.com/link?m=...) разрешаются по-настоящему в финальный URL (поддерживаются HTTP-редиректы и JS-редакцы).

• Самодостаточный единый файл; зависит исключительно от mcp, и от httpx, и от lxml.

Установка

Вариант A: pip (рекомендуется)

pip install mcp-bing-search

Вариант B: из исходников

git clone https://github.com/Quqing-future/mcp-bing-search.git
cd mcp-bing-search
pip install .
# or run directly without installing:
python mcp_bing_search.py

Настройка в Reasonix

Добавьте в глобальный config.toml (все проекты) или в reasonix.toml проекта:

[[plugins]]
name    = "bing-search"
command = "python"                      # or the absolute path to python.exe
args    = ["-m", "mcp_bing_search"]     # if installed via pip
# args = ["/path/to/mcp_bing_search.py"] # if running from source

Или используйте стандартный .mcp.json:

{
  "mcpServers": {
    "bing-search": {
      "command": "python",
      "args": ["-m", "mcp_bing_search"]
    }
  }
}

Изменения вступают в силу со следующего сеанса. Инструменты доступны как mcp__bing-search__web_search и mcp__bing-search__cn_search.

Настройка с other MCP-клиентами

Подойт любой MCP-клиент — Claude Desktop, Cursor, VS Code и т. д. Подкажите ему:

python -m mcp_bing_search
# or
python /path/to/mcp_bing_search.py

Инструменты

web_search(query: str, max_results: int = 8, fallback: bool = True) -> str

Ищет в вебе. Сначала — Bing; если fallback включён и Bing возвращает нерелевантные результаты (ни один заголовок или URL не содержит ни одного токена запроса), повторяется запрос через Qihoo 360, затем через Sogou.

cn_search(query: str, max_results: int = 8) -> str

Ищет напрямую в китайских поисков (360 → Sogou). Исп use для свежих китайских трендов, студенческих или Weibo-новостей, либо всего, что Bing индексирует плохо.

Как это работает

MCP client (Reasonix / Claude Desktop / ...)
   ↕  stdio + JSON-RPC
mcp_bing_search.py  (MCP server)
   ↕  HTTPS (plain HTTP GET, browser User-Agent)
cn.bing.com  →  www.so.com  →  www.sogou.com

1. Запрос — httpx запрашивает https://cn.bing.com/search?q=... с User-Agent настольного браузера.

2. Парсинг — lxml и XPath извлекают title / url / snippet из узлов li.b_algo.

3. Проверка релевантности — если ни в одном заголовке/URL результата нет ни одного токена запроса (например, "本地大模型", "部署教程"), набор результатов считается нерелевантным.

4. Резервный поиск — при пустых или нерелевантных результатах Bing пробует 360 → Sogou и берёт первый движок с релевантными результатами.

5. Очистка ссылок — ссылки-редиректы (so.com/link?m=..., /link?url=...) повторно разрешаются в свой настоящий адрес (заголовок Location или window.location.replace(...)).

Известные ограничения

• Парсинг зависит от HTML-структуры поисковых движков; редизайн может сломать парсинг.

• Нет ключа = нет SLA; очень частые вызовы могут быть ограничены по частоте.

• Bing слабо покрывает свежие темы из китайских соцсетей — используйте для них fallback или cn_search.

• Baidu убран намеренно: он агрессивно защищается от автоматических запросов капчами.

• Дисклеймер (ToS): этот проект работает за счёт парсинга открытых страниц результатов поиска. Он предназначен для личного или образовательного использования и не претендует на соответствие порожними условиями пользования Bing, Qihoo 360 или Sogou. Парсинг может нарушать эти условия; автоматический доступ может быть ограничен или заблокирован. Используйте на собственный риск, а для производственного применения рассмотрите официальные поисковые API.

Лицензия

MIT © Todo-будущее