Qwen Studio Browser Gateway

English

Claude Code に対して、手動で承認された chat.qwen.ai の Web セッションを介して、Qwen 3.8 Max の信頼できない専門家の意見を 1 つ提供する、非公式の localhost 限定ゲートウェイです。

これは Qwen の公式 API ではなく、主要なエージェントでも、正しい回答を保証するものではありません。ユーザーは各ホストで手動的にサイトにログインします。プロジェクトは cookies/tokens を転送せず、CAPTCHA/MFA を回避せず、Qwen にシェル、ファイルシステム、またはローカルツールへのアクセスを与えることもありません。

フロー

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

Send の前に、ゲートウェイは qwen3.8-max / Qwen3.8-Max を選択して確認します。モデルの不一致、不明な DOM、チャレンジ、ログインの欠落、リモートエンドポイントは、すべてエラーになります。Send 後、ブラウザの生成は自動的に繰り返されません。

Related MCP server: claude-consult-mcp

要件

• Node.js 22+;

• グラフィカルウィンドウ付きの Chrome / Chromium;

• 既製の systemd user テンプレート用 Linux（Node.js ゲートウェイ自体は移植可能です）;

• 自分自身の Qwen アカウントと Web サービスを利用する権利。

インストール

npm ci
npm run check
npm run build
npm test

プライベートな設定を作成します:

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

server.env を編集します:

• ローカルの QWEN_BROWSER_EXECUTABLE_PATH を設定してください;

• このホスト用に新しいランダムな QWEN_LOCAL_API_KEY を生成してください;

• loopback エンドポイントを変更しないでください;

• 使用前に、実際の UI で最強のモデルの最新の ID/label を確認してください。

server.env とブラウザプロファイルをコミットしないでください。

手動ログイン

別のブラウザを起動します:

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

開いたウィンドウで https://chat.qwen.ai に自分でログインします。CAPTCHA と MFA はユーザーだけが通過できます。Qwen のタブを 1 つ開いたままにしてください。

別のターミナルでゲートウェイを起動します:

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

Linux の永続的なユーザーサービスには、systemd/ のテンプレートと docs/setup.md の説明を使用してください。

安全なスモークテスト

これらのリクエストは生成を開始しません:

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 と POST /v1/chat/completions は実際の Web 生成を実行し、クォータを消費する可能性があります。

Claude Code MCP

npm run build の後に次を実行します:

node dist/cli.js mcp install-config

このコマンドは、現在の Node.js と dist/cli.js のパスを含む移植可能な JSON を出力します。qwen-expert オブジェクトを、このホストの Claude Code の MCP 設定に追加してください。MCP は ask_qwen_expert のみを公開します。応答は常に advisory としてマークされ、独立して検証する必要があります。

セキュリティの境界

• HTTP と CDP は loopback エンドポイントのみ受け付けます。

• QWEN_WEB_URL はオリジン https://chat.qwen.ai のみを受け取ります。

• ローカル API キーが必須です。

• プロンプトはログに記録されません。スクリーンショットはデフォルトでオフです。

• 1 つのタブと 1 つの FIFO キューが応答の混在を防ぎます。

• Qwen は実行可能なツールやローカルファイルを受け取りません。

• このプロジェクトは、サイトの制限の回避や大量自動化を目的としていません。

詳細: AGENTS.md、docs/architecture.md、docs/security.md、docs/troubleshooting.md。