dsh-bing-search

简体中文

Веб-поиск для DeepSeek Harness (DSH), реализованный как небольшой MCP-сервер на базе curl_cffi.

Порядок search:

1. Проверяет доступность HTML-версии DuckDuckGo (html.duckduckgo.com) и кэширует результат примерно на 60 секунд. Из материкового Китая эта проверка часто не проходит без настройки прокси.

2. Использует DDG, когда он доступен.

3. Переключается на Bing, когда DDG недоступен, ограничен по частоте запросов (HTTP 202 / challenge) или набор результатов имеет quality_label=poor.

4. Направляет Bing в зависимости от языка: для китайского и рынков zh-* используется cn.bing.com, в остальных случаях — www.bing.com.

Каждый ответ поиска включает quality_score (0–1) и quality_label (good / weak / poor). Считайте poor непригодным к использованию (словарные страницы, мусор из первых токенов). Не цитируйте такие заголовки.

Плагин предоставляет агенту DSH три инструмента в стиле браузера:

• mcp__web__search — поиск по публичному вебу и возврат нормализованных органических результатов.

• mcp__web__open — открыть публичную веб-страницу и извлечь читаемый текст.

• mcp__web__find — найти текст на длинной странице и вернуть окружающий контекст.

DSH agent
  -> @deepseek-ai/dsh-mcp-client
  -> dsh-bing-search (MCP/stdio)
  -> curl_cffi.AsyncSession(impersonate="chrome")
  -> html.duckduckgo.com          (if reachable)
  -> else cn.bing.com / www.bing.com

Материковый Китай: без прокси или VPN DuckDuckGo часто недоступен. Это ожидаемо. В этом случае плагин использует Bing и устанавливает warnings в duckduckgo_unreachable. Дочерний MCP-процесс не наследует переменные HTTP_PROXY / HTTPS_PROXY из вашего shell (trust_env=False). Чтобы принудительно задать прокси, установите DSH_WEB_PROXY в процессе плагина (например, http://127.0.0.1:10808 в карте env: в cordis). Не рассчитывайте, что DDG будет работать в типичной домашней или университетской сети материкового Китая.

Сообщество плагинов: DeepSeek Harness просит сторонние плагины использовать тему dsh-plugin на GitHub для обнаружения.

Самая быстрая установка: передайте этот репозиторий агенту

Если ваш пишущий код агент имеет доступ к терминалу и файловой системе (Codex, Claude Code, Pi, OpenCode и т.д.), вставьте следующее:

Install this DeepSeek Harness plugin into my current DSH setup:
https://github.com/Biogod2020/dsh-bing-search

Read the repository README and INSTALL.md first. Install it with uv, detect my active
DSH profile, add it through cordis.patch.yml using the required `insert` patch form,
preserve all unrelated config, use the absolute path of the installed dsh-bing-search
executable, then verify that mcp__web__search, mcp__web__open, and mcp__web__find are
registered. Finally run one real web search smoke test and report what changed.

Это рекомендуемый путь. INSTALL.md содержит детерминированный контракт установки, написанный для агентов.

Related MCP server: webmcp

Установка вручную

1. Установите исполняемый файл

Требуется Python 3.10 или новее. С помощью uv:

uv tool install --force git+https://github.com/Biogod2020/dsh-bing-search.git

Найдите каталог bin инструмента:

uv tool dir --bin

Используйте абсолютный путь к dsh-bing-search (или dsh-bing-search.exe в Windows) в конфигурации DSH ниже.

Для разработки вместо установки как инструмента:

git clone https://github.com/Biogod2020/dsh-bing-search.git
cd dsh-bing-search
uv sync --extra dev

Репозиторий включает uv.lock для воспроизводимых установок в режиме разработки.

2. Добавьте его в DSH

Профили DSH объединяют корневой cordis.yml со слоем патчей cordis.patch.yml. При добавлении нового плагина через слой патчей запись обязательно должна быть обёрнута в insert:

- insert:
    - id: mcp-web
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: web
        transport: stdio
        command: /ABSOLUTE/PATH/TO/dsh-bing-search
        args: []
        toolCallTimeoutMs: 30000
        failOnStartupError: true
        reconnect:
          enabled: true
          initialDelayMs: 500
          maxDelayMs: 30000
          maxAttempts: 10

Не добавляйте запись - id: mcp-web в cordis.patch.yml без обёртки: такие записи патчат существующие ID, а неизвестный ID может быть пропущен. Если вы редактируете корневой cordis.yml напрямую, обычная запись плагина без обёртки — правильный вариант. См. cordis.example.yml.

3. Проверка

После перезагрузки профиля DSH модель должна увидеть:

mcp__web__search
mcp__web__open
mcp__web__find

Затем попросите агента найти что-то актуальное и открыть один результат. Успешный цикл подтверждает и доступ к поиску, и регистрацию в MCP. Перезапустите DSH (или дочерний MCP-процесс) после изменения кода плагина; процесс stdio не перезагружает Python на лету.

Инструменты

search

{
  "query": "DeepSeek Harness GitHub",
  "count": 8,
  "offset": 0,
  "market": "en-US",
  "safe_search": "Moderate"
}

Возвращает:

Используйте market=zh-CN для китайских запросов. Если запрос содержит символы CJK, запасной вариант Bing всё равно использует cn.bing.com, даже если market установлен в en-US.

Редиректы DuckDuckGo /l/?uddg= и Bing /ck/a декодируются там, где это возможно. Распространённые отслеживающие параметры удаляются, а дублирующиеся URL объединяются.

Для людей, статей или иллюстрированных блогов сначала ищите имя автора или короткое имя собственное. Если quality_label — poor, не продолжайте удлинять запрос. Китайские академические метаданные относятся к специализированному корпусу (например, CNKI), а не к этому общему веб-поиску.

open

{
  "url": "https://example.com/article",
  "max_chars": 24000
}

Загружает публичные HTTP(S)-страницы с помощью curl_cffi, применяет проверки DNS/IP и безопасные редиректы, ограничивает размер ответа и извлекает читаемый текст без выполнения JavaScript.

open предназначен для HTML, похожего на статьи. Это не браузер. Живые запуски DSH показали, что погодные и другие сайты с большим количеством виджетов (tianqi.com, weather.com.cn и подобные) часто возвращают навигационные элементы или почти пустой текст: Trafilatura не находит основную статью, и запасной вариант выгружает весь DOM. status при этом может быть ok. Для таких страниц доверяйте сниппету из поиска или открывайте более простой URL статьи. Не ожидайте живую температуру, карты или другой JS-рендеринг.

find

{
  "url": "https://example.com/article",
  "pattern": "DeepSeek",
  "max_matches": 5,
  "context_chars": 700
}

Возвращает соответствующие фрагменты, не вставляя всю страницу в контекст модели.

Почему три инструмента вместо одного большого search_and_summarize?

Плагин сохраняет детерминированный поиск и позволяет модели DSH управлять циклом исследования:

search -> inspect candidates -> open -> find / search again -> synthesize

Плагин обрабатывает HTTP, парсинг, очистку, кэширование, переключение движков, происхождение данных и оценку качества. Агент решает, что искать, каким источникам доверять, когда переформулировать запрос и когда собрано достаточно доказательств. Агент обязан читать quality_label и warnings.

Конфигурация

Тесты

Офлайн-тесты (парсеры, оценка качества, маршрутизация по локали, DDG-first / запасной вариант Bing):

uv run pytest -m "not live"

Живой смоук-тест:

RUN_LIVE_BING=1 uv run pytest -m live -s

Имя маркера по-прежнему live / RUN_LIVE_BING. Живой запуск сначала обращается к DDG и использует Bing только в том случае, если DDG недоступен.

CI покрывает Python 3.10, 3.12, 3.13 и 3.14.

Замечания по дизайну и безопасности

Это неофициальный адаптер DuckDuckGo HTML + Bing HTML. Он не использует снятый с поддержки Bing Search API.

• Разметка DDG находится в src/dsh_bing_search/providers/ddg.py.

• Разметка Bing находится в src/dsh_bing_search/providers/bing_parser.py.

• Оценка качества находится в src/dsh_bing_search/quality.py и не зависит от движка.

• Запросы используют curl_cffi.AsyncSession с имитацией браузера.

• URL-адреса страниц, предоставленные пользователем, ограничены публичными HTTP(S)-целями и включена безопасная обработка редиректов.

• Тела ответов ограничены по размеру.

• Страницы CAPTCHA / challenge / HTTP 202 сообщаются как status="blocked"; плагин не пытается их обходить.

• Headless Bing на www.bing.com часто возвращает структурно валидные, но нерелевантные карточки. cn.bing.com помогает с некоторыми горячими китайскими запросами; длиннохвостовые имена и заголовки всё ещё могут схлопываться до первого токена. Именно для этого нужна оценка качества.

• open не выполняет автоматические повторные попытки для медленных целевых сайтов; при необходимости увеличьте переменные окружения таймаута.

Сообщество

DeepSeek Harness в настоящее время находится в предварительной версии для разработчиков, поэтому интерфейсы плагинов могут ещё меняться. Для поддержки и поиска по DSH:

• Просмотрите тему dsh-plugin.

• См. репозиторий DeepSeek Harness.

• Присоединяйтесь к каналам сообщества DSH, ссылки на которые есть в официальном репозитории.

Приветствуются вклады и исправления парсеров.

Лицензия

MIT