qwased/dsh-web-search-browser

web-search — Busca na Web com Edge via DSH

No DSH, use o Edge nativo + Playwright MCP para realizar buscas na web "como em um site oficial": o modelo chama as ferramentas MCP do navegador para acionar um Edge real, abrir o Bing, capturar um snapshot da página e retorná-lo ao contexto do DSH. Em seguida, filtra cada resultado de acordo com regras de segurança e gera um resumo. Isso não utiliza a interface web_search interna do DSH; é uma busca real com um navegador.

Composição (Dois Componentes)

Componente	Localização	Descrição
Configuração do Playwright MCP	cordis.yml do DSH (plugin dsh-mcp-client)	Permite que o DSH acione o Edge
Esta skill de instrução	.agents/skills/web-search/SKILL.md	Registra etapas de configuração, fluxo de busca e regras de segurança

Ambos são necessários para que a capacidade de busca esteja completa.

1. Configuração em um Novo Computador

Pré-requisitos

• Node.js instalado (incluindo npm)
• Microsoft Edge instalado (Win10/11 já vem com ele)
• DSH já funcional

Passo 1: Instalar o Pacote Playwright MCP

Se a política de execução do PowerShell bloquear scripts .ps1, use npm.cmd / npx.cmd.

npm install -g @playwright/mcp@latest --no-audit --no-fund

Verifique se pode ser iniciado:

node "$env:APPDATA\npm\node_modules\@playwright\mcp\cli.js" --help

Se aparecer uma lista de opções, a instalação está concluída.

Passo 2: Registrar o Cliente MCP no cordis.yml do DSH

Adicione uma entrada do plugin @deepseek-ai/dsh-mcp-client ao cordis.yml do perfil/preset que executa o DSH (uma entrada por servidor MCP):

- id: mcp-playwright
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: playwright
    transport: stdio
    comando: npx.cmd
    args: ['-y', '@playwright/mcp@latest', '--browser', 'msedge']

• --browser msedge chama diretamente o Edge nativo, sem precisar baixar o Chromium.
• comando definido como npx.cmd contorna a política de execução do PowerShell; se não houver bloqueio, npx também funciona.
• O DSH registra as ferramentas MCP como mcp__<serverName>__<nome original da ferramenta>, por exemplo, mcp__playwright__browser_navigate, mcp__playwright__browser_snapshot, etc.

Passo 3: Reiniciar para Efeito

O cordis.yml é carregado na inicialização do DSH; o plugin MCP executa listTools() e registra as ferramentas ao conectar. Após alterações, reinicie o DSH para que as ferramentas apareçam.

2. Fluxo de Busca

1. Chame mcp__playwright__browser_navigate para abrir o Bing: https://www.bing.com/search?q=<palavra-chave codificada em URL>.
2. Chame mcp__playwright__browser_snapshot para capturar o snapshot da página de resultados (título / domínio / URL / descrição). Se o snapshot não for suficiente, use mcp__playwright__browser_take_screenshot para visualizar.
3. Para cada resultado, classifique-o de acordo com a "Classificação de Segurança" abaixo.
4. Apenas resultados "Confiáveis" podem ser abertos com mcp__playwright__browser_click para ler detalhes; resultados suspeitos e bloqueados não são acessados.
5. Organize os resultados de acordo com o "Formato de Saída" e responda; as URLs citadas devem ser links em markdown.

Cada busca automática abrirá brevemente uma janela do Edge, o que é normal. Para executar em segundo plano sem janela, adicione --headless aos argumentos do MCP, mas isso perde a visualização e geralmente não é recomendado.

3. Classificação de Segurança (Filtragem Média)

Os resultados dos mecanismos de busca são mistos (phishing, sites falsos, fazendas de SEO, downloads empacotados, sites de software malicioso). Cada resultado deve ser classificado individualmente. Não depende de bibliotecas externas; apenas regras de filtragem.

🔒 Confiável (pode abrir detalhes normalmente)

• Sites oficiais (domínio corresponde à marca, como brand.com / brand.com.cn)
• Sites de autoridade: Wikipedia, Zhihu, documentação oficial, .gov / .edu / domínios de grandes empresas
• Sites grandes e conhecidos (registro antigo, reputação clara)

⚠️ Suspeito (apenas título e URL; não acessar, não fornecer links de download)

• Resultados marcados como anúncio (marcação ad do Bing, sp=ad, patrocinado, etc.)
• Sites agregadores de download / sites de recursos (Huajun, Pacific, Software Home, Green Software Alliance, xpgod, ZOL Download, etc.)
• Domínios falsificados: imitam propositalmente o oficial, como brand-official.com, brand-download.net, com hífen/variações numéricas
• Domínios recém-registrados, sem HTTPS, descrições com excesso de palavras-chave

🚫 Bloqueado (marcado em vermelho, não utilizado)

• Sites claramente de phishing, jogos de azar, conteúdo adulto, que solicitam download de .exe suspeitos
• Qualquer site de "versão crackeada / versão verde / site de download de software X"

4. Regras Rígidas

• Nunca baixe automaticamente nenhum arquivo (.exe / .apk / .zip / .dmg — nenhum é permitido)
• Nunca forneça links de download de sites suspeitos diretamente
• Se precisar de software, recomende apenas o site oficial ou a loja oficial de aplicativos do sistema
• Por padrão, não abra detalhes de páginas suspeitas; apenas resultados "Confiáveis" podem ser abertos para leitura aprofundada

5. Formato de Saída

Retorne no seguinte formato (em português):

🔒 Resultados Confiáveis
1. [Título] (domínio) – Breve descrição
2. ...

⚠️ Apenas para Referência (não verificado)
- Título (domínio) – Aviso: motivo da suspeita
...

🚫 Bloqueados (não recomendado acessar)
- Título (domínio) – Motivo

6. Por que Usar Regras de Filtragem em Vez de Trocar o Mecanismo de Busca

O problema não está no mecanismo de busca, mas na falta de uma camada de filtragem: trocar de mecanismo apenas trará um novo conjunto de anúncios/patrocínios. Mantenha as regras de filtragem; qualquer resultado de qualquer mecanismo deve passar pela classificação primeiro. Também não tente integrar listas negras de URLs de terceiros (como a base de dados do Huorong): essas listas são fechadas e não possuem API pública de consulta, impossibilitando a verificação no fluxo.