Qwen Studio Browser Gateway

English

Ein inoffizieller Localhost-only-Gateway, der Claude Code eine zusätzliche nicht vertrauenswürdige Expertenmeinung von Qwen 3.8 Max über eine manuell autorisierte Web-Sitzung auf chat.qwen.ai bereitstellt.

Das ist keine offizielle Qwen-API, kein primärer Agent und keine Quelle für garantiert richtige Antworten. Der Benutzer meldet sich auf jedem Host manuell auf der Website an; das Projekt überträgt keine Cookies/Tokens, umgeht kein CAPTCHA/MFA und gibt Qwen keinen Zugriff auf Shell, Dateisystem oder lokale Tools.

Ablauf

Claude Code
  └─ MCP ask_qwen_expert
       └─ http://127.0.0.1:8798/v1/expert
            └─ FIFO, active = 1
                 └─ CDP http://127.0.0.1:9333
                      └─ одна видимая вкладка https://chat.qwen.ai
                           └─ точная Qwen3.8-Max

Vor jedem Senden wählt und bestätigt der Gateway qwen3.8-max / Qwen3.8-Max. Modellabweichung, unbekanntes DOM, Challenge, fehlender Login oder entfernter Endpoint führen zu einem Fehler. Nach dem Senden wird die Browser-Generierung nicht automatisch wiederholt.

Related MCP server: claude-consult-mcp

Voraussetzungen

• Node.js 22+;

• Chrome/Chromium mit grafischem Fenster;

• Linux für die vorgefertigten systemd-User-Vorlagen (der Node.js-Gateway selbst ist portabel);

• ein eigenes Qwen-Konto und das Recht, den Web-Dienst zu nutzen.

Installation

npm ci
npm run check
npm run build
npm test

Erstellen Sie eine private Konfiguration:

install -d -m 700 ~/.config/qwen-studio-browser-gateway
cp .env.example ~/.config/qwen-studio-browser-gateway/server.env
chmod 600 ~/.config/qwen-studio-browser-gateway/server.env

Bearbeiten Sie server.env:

• Setzen Sie den lokalen QWEN_BROWSER_EXECUTABLE_PATH;

• Generieren Sie einen neuen zufälligen QWEN_LOCAL_API_KEY für diesen Host;

• Ändern Sie die Loopback-Endpunkte nicht;

• Bestätigen Sie vor der Verwendung die aktuellen ID/Label des stärksten Modells im Live-UI.

Committen Sie server.env und das Browserprofil nicht.

Manuelle Anmeldung

Starten Sie einen separaten Browser:

set -a
source ~/.config/qwen-studio-browser-gateway/server.env
set +a
./start-qwen-browser.sh

Melden Sie sich im geöffneten Fenster selbst bei https://chat.qwen.ai an. CAPTCHA und MFA durchläuft nur der Benutzer. Lassen Sie einen Qwen-Tab offen.

Starten Sie den Gateway in einem anderen Terminal:

set -a
source ~/.config/qwen-studio-browser-gateway/server.env
set +a
node dist/cli.js serve

Für einen dauerhaften Linux-User-Service verwenden Sie die Vorlagen in systemd/ und die Anleitung in docs/setup.md.

Sichere Smoke-Tests

Diese Anfragen lösen keine Generierung aus:

node dist/cli.js browser doctor
curl -fsS -H "Authorization: Bearer $QWEN_LOCAL_API_KEY" \
  http://127.0.0.1:8798/health
curl -fsS -H "Authorization: Bearer $QWEN_LOCAL_API_KEY" \
  http://127.0.0.1:8798/v1/models
node dist/cli.js mcp install-config

POST /v1/expert und POST /v1/chat/completions starten eine echte Web-Generierung und können das Quota verbrauchen.

Claude Code MCP

Führen Sie nach npm run build Folgendes aus:

node dist/cli.js mcp install-config

Der Befehl gibt ein portables JSON mit den aktuellen Pfaden von Node.js und dist/cli.js aus. Fügen Sie das Objekt qwen-expert zur MCP-Konfiguration von Claude Code auf diesem Host hinzu. Der MCP veröffentlicht nur ask_qwen_expert; die Antwort wird immer als Advisory markiert und muss unabhängig überprüft werden.

Sicherheitsgrenzen

• HTTP und CDP akzeptieren nur Loopback-Endpunkte.

• QWEN_WEB_URL akzeptiert ausschließlich den Origin https://chat.qwen.ai.

• Ein lokaler API-Key ist erforderlich.

• Prompts werden nicht protokolliert; Screenshots sind standardmäßig deaktiviert.

• Ein Tab und eine FIFO-Warteschlange verhindern das Vermischen von Antworten.

• Qwen erhält keine ausführbaren Tools oder lokalen Dateien.

• Das Projekt ist nicht dazu gedacht, die Einschränkungen der Website zu umgehen oder Massenautomatisierung zu betreiben.

Weitere Informationen: AGENTS.md, docs/architecture.md, docs/security.md, docs/troubleshooting.md.