dsh-bing-search
dsh-bing-search
Websuche für DeepSeek Harness (DSH), implementiert als kleiner MCP-Server und unterstützt von curl_cffi.
search-Reihenfolge:
DuckDuckGo-HTML (
html.duckduckgo.com) prüfen und die Erreichbarkeit für etwa 60 Sekunden zwischenspeichern. Vom chinesischen Festland aus schlägt diese Prüfung oft fehl, sofern kein Proxy konfiguriert ist.DDG verwenden, wenn es erreichbar ist.
Auf Bing zurückfallen, wenn DDG nicht verfügbar ist, rate-limitiert (HTTP 202 / Challenge) ist oder das Ergebnisset
quality_label=pooraufweist.Bing je nach Sprache weiterleiten: Chinesische /
zh-*-Märkte gehen ancn.bing.com, andernfalls anwww.bing.com.
Jede Suchantwort enthält quality_score (0–1) und quality_label (good / weak / poor). Behandle poor als unbrauchbar (Wörterbuchseiten, Erst-Token-Müll). Zitiere diese Titel nicht.
Es gibt einem DSH-Agenten drei browserartige Werkzeuge:
mcp__web__search— durchsuche das öffentliche Web und gib normalisierte organische Ergebnisse zurück.mcp__web__open— öffne eine öffentliche Webseite und extrahiere lesbaren Text.mcp__web__find— finde Text in einer langen Seite und gib umliegenden Kontext zurück.
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.comFestlandchina: DuckDuckGo ist ohne Proxy oder VPN oft nicht erreichbar. Das ist zu erwarten. Das Plugin verwendet dann Bing und setzt warnings auf duckduckgo_unreachable. Der MCP-Kindprozess erbt nicht die HTTP_PROXY/HTTPS_PROXY-Einstellungen Ihrer Shell (trust_env=False). Um einen Proxy zu erzwingen, setzen Sie DSH_WEB_PROXY im Plugin-Prozess (zum Beispiel http://127.0.0.1:10808 in der env:-Map von cordis). Gehen Sie nicht davon aus, dass DDG in einem typischen Festland-Heim- oder Campusnetzwerk funktioniert.
Community-Plugin: DeepSeek Harness bittet Drittanbieter-Plugins, das GitHub-Thema
dsh-pluginzur Auffindbarkeit zu verwenden.
Schnellste Installation: Dieses Repository einem Agenten übergeben
Wenn Ihr Coding-Agent Terminal- und Dateisystemzugriff hat (Codex, Claude Code, Pi, OpenCode usw.), fügen Sie Folgendes ein:
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.Das ist der empfohlene Weg. INSTALL.md enthält einen deterministischen Installationsvertrag, der für Agenten geschrieben wurde.
Related MCP server: webmcp
Manuelle Installation
1. Die ausführbare Datei installieren
Python 3.10+ ist erforderlich. Mit uv:
uv tool install --force git+https://github.com/Biogod2020/dsh-bing-search.gitFinden Sie das Tool-Bin-Verzeichnis:
uv tool dir --binVerwenden Sie den absoluten Pfad zu dsh-bing-search (oder dsh-bing-search.exe unter Windows) in der DSH-Konfiguration unten.
Für die Entwicklung anstelle einer Tool-Installation:
git clone https://github.com/Biogod2020/dsh-bing-search.git
cd dsh-bing-search
uv sync --extra devDas Repository enthält uv.lock für reproduzierbare Entwicklungsinstallationen.
2. Zu DSH hinzufügen
DSH-Profile kombinieren eine Stamm-cordis.yml mit einer Patch-Schicht cordis.patch.yml. Wenn Sie ein neues Plugin über die Patch-Schicht hinzufügen, muss der Eintrag in insert eingebettet werden:
- 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: 10Fügen Sie keinen nackten Eintrag - id: mcp-web zu cordis.patch.yml hinzu: Nackte Einträge patchen vorhandene IDs, und eine unbekannte ID kann übersprungen werden. Wenn Sie die Stamm-cordis.yml direkt bearbeiten, ist ein normaler nackter Plugin-Eintrag korrekt. Siehe cordis.example.yml.
3. Überprüfen
Nachdem DSH das Profil neu geladen hat, sollte das Modell Folgendes sehen:
mcp__web__search
mcp__web__open
mcp__web__findBitten Sie den Agenten dann, nach etwas Aktuellem zu suchen und ein Ergebnis zu öffnen. Ein erfolgreicher Roundtrip bestätigt sowohl den Suchzugriff als auch die MCP-Registrierung. Starten Sie DSH (oder den MCP-Kindprozess) neu, nachdem Sie Plugin-Code geändert haben; der Stdio-Prozess lädt Python nicht neu.
Werkzeuge
search
{
"query": "DeepSeek Harness GitHub",
"count": 8,
"offset": 0,
"market": "en-US",
"safe_search": "Moderate"
}Gibt zurück:
Feld | Bedeutung |
|
|
| Organisches Ergebnis |
| Stabile ID aus der kanonischen URL |
| 0–1 Überlappung der Abfrage mit Titeln/Textauszügen |
|
|
| Fallback-Grund und Qualitätshinweise |
Verwenden Sie market=zh-CN für chinesische Abfragen. Wenn die Abfrage CJK enthält, verwendet der Bing-Fallback auch bei market=en-US weiterhin cn.bing.com.
DuckDuckGo-/l/?uddg=- und Bing-/ck/a-Weiterleitungen werden nach Möglichkeit dekodiert. Häufige Tracking-Parameter werden entfernt und doppelte URLs werden zusammengeführt.
Suchen Sie bei Personen, Papieren oder illustrierten Blogs zuerst nach dem Autorennamen oder einem kurzen Eigennamen. Wenn quality_label poor ist, verlängern Sie die Abfrage nicht weiter. Chinesische akademische Metadaten gehören in ein spezialisiertes Korpus (z. B. CNKI), nicht in diese allgemeine Websuche.
open
{
"url": "https://example.com/article",
"max_chars": 24000
}Ruft öffentliche HTTP(S)-Seiten mit curl_cffi ab, wendet DNS/IP-Prüfungen und sichere Weiterleitungen an, begrenzt die Antwortgröße und extrahiert lesbaren Text ohne JavaScript auszuführen.
open ist für artikelähnliches HTML gebaut. Es ist kein Browser. Live-DSH-Läufe zeigten, dass Wetter- und andere Widget-lastige Websites (tianqi.com, weather.com.cn und ähnliche) oft Navigations-Chrome oder fast leeren Text liefern: Trafilatura findet keinen Hauptartikel, und der Fallback gibt das gesamte DOM aus. status kann trotzdem ok sein. Vertrauen Sie bei diesen Seiten dem Such-snippet oder öffnen Sie eine einfachere Artikel-URL. Erwarten Sie keine Live-Temperatur, Karten oder andere JS-gerenderte Benutzeroberfläche.
find
{
"url": "https://example.com/article",
"pattern": "DeepSeek",
"max_matches": 5,
"context_chars": 700
}Gibt passende Bereiche zurück, ohne die gesamte Seite in den Modellkontext einzufügen.
Warum drei Werkzeuge statt eines riesigen search_and_summarize-Werkzeugs?
Das Plugin hält die Abfrage deterministisch und lässt das DSH-Modell die Recherche-Schleife steuern:
search -> inspect candidates -> open -> find / search again -> synthesizeDas Plugin übernimmt HTTP, Parsing, Bereinigung, Caching, Engine-Fallback, Herkunft und eine Qualitätskennzeichnung. Der Agent entscheidet, wonach gesucht wird, welchen Quellen er vertraut, wann die Abfrage umformuliert wird und wann genügend Beweise gesammelt wurden. Der Agent muss quality_label und warnings lesen.
Konfiguration
Umgebungsvariable | Standard | Zweck |
|
| Bing-HTML-Endpunkt nur überschreiben, wenn ein Nicht-Standardwert gesetzt ist (Tests). Andernfalls wird der Host anhand der Sprache gewählt |
|
|
|
| leer | HTTP/HTTPS/SOCKS-Proxy. Der Prozess verwendet |
|
| Übertragungs-Timeout |
|
| Verbindungs-Timeout |
|
| Maximale Größe des Inhalts für |
|
| Maximale Größe des Suchseiteninhalts |
|
| Maximale Anzahl an Weiterleitungen |
|
| Maximale gleichzeitige Anforderungen pro Prozess |
|
| Suchcache-TTL |
|
| Seiten-Cache-TTL |
Tests
Offline-Tests (Parser, Qualitätswert, Locale-Routing, DDG-zuerst / Bing-Fallback):
uv run pytest -m "not live"Live-Smoke-Test:
RUN_LIVE_BING=1 uv run pytest -m live -sDer Markername ist weiterhin live / RUN_LIVE_BING. Ein Live-Lauf greift zuerst auf DDG zu und verwendet Bing nur, wenn DDG nicht verfügbar ist.
CI umfasst Python 3.10, 3.12, 3.13 und 3.14.
Design- und Sicherheitshinweise
Dies ist ein inoffizieller DuckDuckGo-HTML- und Bing-HTML-Adapter. Er verwendet die eingestellte Bing-Such-API nicht.
DDG-Markup befindet sich in
src/dsh_bing_search/providers/ddg.py.Bing-Markup befindet sich in
src/dsh_bing_search/providers/bing_parser.py.Die Qualitätsbewertung befindet sich in
src/dsh_bing_search/quality.pyund ist engine-agnostisch.Anforderungen verwenden
curl_cffi.AsyncSessionmit Browser-Imitation.Benutzer bereitgestellte Seiten-URLs sind auf öffentliche HTTP(S)-Ziele beschränkt, und eine sichere Weiterleitungsbehandlung ist aktiviert.
Antwortkörper sind größenbegrenzt.
CAPTCHA-/Challenge-/HTTP-202-Seiten werden als
status="blocked"gemeldet; das Plugin versucht nicht, sie zu umgehen.Headless Bing auf
www.bing.comliefert oft strukturierte, aber unpassende Karten.cn.bing.comhilft bei einigen heißen chinesischen Abfragen; Long-Tail-Namen und Titel können weiterhin auf das erste Token kollabieren. Dafür ist die Qualitätskennzeichnung da.openwiederholt langsame Zielseiten nicht automatisch; erhöhen Sie bei Bedarf die Timeout-Umgebungsvariablen.
Community
DeepSeek Harness befindet sich derzeit in der Entwicklervorschau, daher können sich Plugin-Schnittstellen noch ändern. Für DSH-spezifischen Support und Auffindbarkeit:
Durchsuchen Sie das Thema
dsh-plugin.Siehe das DeepSeek Harness Repository.
Treten Sie den DSH-Community-Kanälen bei, die im offiziellen Repository verlinkt sind.
Beiträge und Parser-Fixes sind willkommen.
Lizenz
MIT
Available Tools
4 toolsfindFind in Web PageA
Find a literal phrase in a page and return compact context windows around matches.
Inputs: url (required), pattern (required), max_matches, context_chars. Returns: url, error, status, matches, +3 more
openOpen Web PageA
Fetch a public HTTP(S) page with curl_cffi and return cleaned readable text.
Use after search when result snippets are insufficient. Private/local addresses are rejected, redirect targets use curl_cffi safe-follow mode, and response bytes are capped.
Inputs: url (required), max_chars. Returns: text, error, title, status, +7 more
searchSearch the WebA
Search the public web. DuckDuckGo is tried first when reachable; Bing is the fallback.
Chinese queries / zh-* markets use cn.bing.com. Read quality_label: poor means the titles are unrelated or first-token junk — do not treat them as answers.
Args: query: Compact concrete nouns plus the qualifier that uniquely identifies the subject. "复旦光华楼" is better than "光华楼" — the extra place/institution is necessary, not padding. Do not write whole sentences. If a compact query is still ambiguous or hits the wrong entity, write more (place, institution, year, type). For a person plus a paper, search the author name first. count: Number of organic results to return, from 1 to 20. offset: Result offset for pagination, from 0 to 100. market: Locale such as en-US or zh-CN. Chinese text should use zh-CN. safe_search: SafeSearch level (used when Bing is the engine).
Inputs: query (required), count, market, offset, +1 more. Returns: error, query, market, offset, +10 more
search_imagesSearch ImagesA
Search image indexes and rank results with pure text so vision is not required.
auto (default) tries Bing Images first and falls back to Wikimedia Commons
when the top text score is below ~40, so one call yields a ranked set.
bing_images parses Bing Images metadata (original URL / thumbnail / source
page / title). commons queries Wikimedia Commons, a curated and
licence-clear platform. Every result carries a 0-100 text score, a domain
hint and explainable signals; pick the highest score, treat scores below
~40 as unverified, and optionally verify with find/open on the source
page before downloading.
Args: query: What the image should depict. Compact concrete nouns plus the qualifier that uniquely identifies the subject (e.g. "复旦光华楼", "台州城墙"). "复旦光华楼" is better than "光华楼". Do not write whole sentences. If a compact query is still ambiguous or hits the wrong entity, write more (place, institution, year, type). count: Number of ranked image results to return, from 1 to 20. market: Locale such as en-US or zh-CN (Bing Images; Commons is language-neutral). provider: auto (default), bing_images, or commons.
Inputs: query (required), count, market, provider. Returns: error, query, market, status, +6 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a clearly distinct action: web search, image search, page retrieval, and in-page phrase matching. Search and search_images are separated by media type, while open and find both operate on pages but serve complementary pre- and post-retrieval needs, so an agent can select without confusion.
All tool names are short imperative verbs in snake_case: search, search_images, open, find. The only compound name, search_images, naturally follows a verb_noun pattern, and the overall naming is predictable and consistent.
Four tools form a tightly scoped search-and-browse toolset. Each tool earns its place: web search, image search, full-page reading, and targeted phrase lookup. The count is neither thin nor bloated for the server's stated purpose.
The server covers the full core workflow: discovering content via web or image search, opening pages when snippets are insufficient, and locating specific phrases within pages. Pagination, locale, safesearch, and provider fallback options also cover important search variations, leaving no obvious dead ends.
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
Docs: https://docs.keenable.ai/mcp-server Keenable is a free, remote MCP server that gives agents access to the web index. Search the web with ranked results and date/site filters, then fetch any indexed page as clean markdown. Works out of the box with no account or API key.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceThis MCP server provides tools for AI agents to search the web, fetch page content, and query specific elements from pages using DuckDuckGo.11 npm-
- AlicenseNot gradedqualityCmaintenanceMCP server for web search and content extraction using DuckDuckGo or SearXNG, with Playwright-based fetching and LLM-powered data extraction.138MIT
- AlicenseAqualityDmaintenanceA general MCP server providing web search capabilities using DeepSeek's native online search API.137 npm33MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for internet search via direct Google and DuckDuckGo HTML scraping with AI-powered result normalization and optional summarization, requiring no API keys for search.MIT