QwenコードにWeb検索を追加する方法：ターミナルエージェント用のスクレイプレスMCP統合

重要なポイント:

• Qwen Codeには組み込みのWeb検索機能はない — MCPがWebを見る方法です。 組み込みのweb_searchツールは初期リリースで削除されました。公式ドキュメントでは、Web検索はMCPサーバーに接続することによって提供されると明示されています。その接続をScrapelessに向けることで、端末エージェントはリアルタイムのGoogle検索、ページ描画、および完全なクラウドブラウザを一度に得ることができます。
• ~/.qwen/settings.jsonの1つのブロックですべてを接続します。 mcpServersオブジェクトにscrapelessエントリを1つ追加すると、エージェントはGoogle SERPスクレイパー、トレンドスクレイパー、HTML/Markdown/スクリーンショットヘルパー、そして16種類のブラウザ自動化ツールを手に入れます — SDKコードも、ホスティングサービスも必要ありません。
• エージェントは自然なプロンプトから検索、描画し、ブラウザを操作します。 自然言語でGoogle検索をリクエストしたり、JavaScriptが多いページをきれいなMarkdownとして読んだり、マルチステップのフローをクリックしたりすると、Qwen Codeは訓練のカットオフ知識とローカルファイルに制限されることなく、適切なツール呼び出しを順次作成します。
• 住宅用プロキシと検出回避はクラウド側で処理されます。 すべてのリクエストはScrapelessの検出回避クラウドブラウザを通じて処理され、195以上の国に住宅用プロキシがあるため、エージェントはプロキシやフィンガープリンティングの設定なしで商業サイトからレンダリングされた、使える応答を得ることができます。
• SERP、ステートレススクレイピング、およびブラウザ自動化にわたる21のツール。 Scrapeless MCPサーバーはgoogle_search、google_trends、scrape_html/scrape_markdown/scrape_screenshotを公開し、さらに16のbrowser_*ツールがあります — エージェントのプランナーが毎回引き出す名前空間です。
• stdioまたはHTTPストリーミング可能なトランスポート。 npxでローカルにサーバーを開始するか、同じ構成をストリーミング可能なHTTPエンドポイントに向けてリモート開発コンテナやCIランナーに使用します。
• 無料で開始可能。 新規Scrapelessアカウントには無料のスクレイピングブラウザ実行時間が含まれています — Scrapelessでサインアップしてください。

導入: ライブWebを読むことができるターミナルコーディングエージェント

Qwen Codeは、ターミナル内で動作するオープンソースのAIエージェントで、Qwenシリーズのモデルに最適化されています。大規模なコードベースを読み、ファイルを編集し、コマンドを実行し、プロジェクトの煩雑な部分を自動化します — すべてシェルを離れることなく行います。単独では、ライブWebを見ることはできません。その知識はモデルの訓練カットオフとディスク上のファイルで止まります。

このギャップはQwen Codeでは特に明確です。組み込みのweb_searchツールは初期バージョンで削除され、公式文書には「Web検索は外部MCPサーバーに接続することによって提供される」と明記されています。言い換えれば、Qwen CodeでのリアルタイムWebアクセスは後付けのものではなく、意図された拡張ポイントです。接続しなければ、エージェントは現在のSERPを取得したり、競合の価格ページを読んだり、最新の変更履歴を確認したり、JavaScript専用アプリをレンダリングしたりすることができません。

この記事では、このギャップをScrapeless MCPサーバーをQwen Codeに接続することで埋めます。~/.qwen/settings.jsonの1つのブロックで、エージェントにGoogle検索、JavaScript描画、および完全な検出回避クラウドブラウザを提供します。すべての機能は、コードに対して既に使用している自然言語プロンプトを通じてアクセスできます。他のMCPクライアントを通じて同じScrapelessインターフェイスについては、Google AntigravityのウォークスルーおよびPiエージェントの統合を参照してください。

これを使ってできること

• ターミナルでのライブSERPリサーチ。 エージェントにクエリのためにgoogle_searchを実行させ、JSONとしてトップ結果を返させることで、研究がシェル内で行われ、別のブラウザタブを必要としません。
• 競合および価格スナップショット。 プロンプトにURLを入れると、エージェントがページをレンダリングし、プラン名、価格、機能を抽出して、コードの横に置ける構造化された記録を作成します。
• コードに役立つドキュメントや変更履歴の検索。 エージェントにライブラリの現在のドキュメントやリリースノートをクリーンなMarkdownとして取得させ、レンダリングされたテキストに対して記述することができます。
• 市場やトレンドの確認。 google_trendsを使用して、ターゲット地域におけるトピックの興味の信号を引き出し、それに基づいて機能コピー、コンテンツプラン、または実験アイデアを育成します。
• JavaScriptページからの型付きレコードへの抽出。 エージェントをシングルページアプリに向けさせます; クラウドブラウザがそれを補充し、エージェントは結果を構築中のスクリプト用の型付きオブジェクトとして解析します。
• マルチステップのブラウザフロー。 browser_goto、browser_click、browser_type、browser_scrollを連鎖させ、エージェントがページネーションを歩いたり、パネルを展開したり、ウィザードを通過したりして、抽出を行います。
• レビュー用のスクリーンショットキャプチャ。 scrape_screenshotまたはbrowser_screenshotを使用して、エージェントがワークスペースに保存できる画像としてレンダリングされたページをキャッチします。
• 検索後読み取りパイプライン。 google_search と scrape_markdown を組み合わせることで、エージェントはトップの結果を見つけ、それぞれを読み、単一のターミナルターンで要約します。

Scrapelessでは、適用される法律、規制、およびウェブサイトのプライバシーポリシーを厳守しながら、公開されているデータのみにアクセスします。この投稿の内容はデモンストレーション目的のみです。

Scrapeless MCPサーバーの理由

Scrapeless MCPサーバーは、AIエージェントとライブウェブの間のカスタマイズ可能でアンチデテクションなブリッジです。特にQwen Codeのために、以下を提供します：

• JavaScriptレンダリングを備えたアンチデテクションクラウドブラウザ。 ページは完全な Scrapeless Scraping Browser でハイドレートされてから抽出されるため、SPA、無限スクロールフィード、およびレイジーロードパネルが browser_goto + browser_get_htmlのための一級のターゲットとなります。
• 195か国以上の住宅プロキシ。 地域制約のあるクエリは、ローカルユーザーが見るリスティングを返し、プロキシの出口は完全にScrapeless側で処理されます。
• npxを介した1つのstdioコマンド、SDKコードなし。 サーバーは npx -y scrapeless-mcp-server から子プロセスとして起動されます。構築、ホスティング、またはプロジェクトにインポートする必要はありません。
• SERP、ステートレススクレイピング、および完全なブラウザ自動化を網羅する21のツール。 google_search と google_trends はSERPデータをカバーし、scrape_html / scrape_markdown / scrape_screenshot はワンショットのページ取得をカバーし、16の browser_* ツールがステートフルなナビゲーション、クリック、タイピング、スクロール、スクリーンショットをカバーします。
• Qwen Code独自の web_fetch への補完。 Qwen Codeはプレーンページ取得のためのシンプルな web_fetch を提供していますが、JavaScriptをレンダリングしたり、アンチデテクションを行ったりすることはありません。Scrapelessツールはまさにそのギャップを埋めます — エージェントが持っていなかった検索、さらにレンダリングされたプロキシ経由のページアクセスを提供します。

無料プランでもこの環境を構築し、実際のプロンプトを実行するのに十分です。成長した際は 価格ページ でクォータを比較してください。無料プランでAPIキーを取得するには Scrapeless にアクセスしてください。

前提条件

• ワークステーションにNode.js 22以上 — Qwen CodeはNode 22+を必要とし、stdio MCPサーバーは npx で生成されます。
• Qwen Codeがインストールされ、モデルプロバイダーが設定されていること。 Qwen CodeはLLMバックエンドに対して認証されます。エージェントループはツールコールが実行される前に動作するモデルが必要です。
• ScrapelessアカウントとAPIキー — app.scrapeless.com で無料プランにサインアップし、設定→APIキー管理からキーをコピーします。
• 基本的なターミナルの理解 — 全体の設定は、数コマンドと1つの小さなJSONファイルから成ります。

インストール

セットアップは5つのサブステップで、それぞれ独立して検証可能です。

1. Qwen Codeをインストール

npmからCLIをグローバルにインストールし、バージョンを確認します：

npm install -g @qwen-code/qwen-code
qwen --version

グローバルインストールなしで npx -y @qwen-code/qwen-code@latest を使用して実行することもできます。

2. モデルプロバイダーを接続する

Qwen CodeはLLMバックエンドと通信します。OpenAI互換モードをサポートしているため、OpenAI互換のエンドポイントはどれでも機能します — 認証タイプ、APIキー、ベースURL、およびモデルを設定します：

export OPENAI_API_KEY="your_provider_key_here"
export OPENAI_BASE_URL="https://your-openai-compatible-endpoint/v1"
qwen --auth-type openai -m "your-model-id"

同じ値は --openai-api-key と --openai-base-url フラグとして渡すこともできます。ツールコールをうまく処理できるモデルを選んでください — Qwen Codeはエージェント的なツール使用の周りに構築されているため、現在のQwenシリーズのコーダーモデルは自然な適合です。

3. Scrapeless MCPサーバー（stdio）を追加

Qwen Codeは ~/.qwen/settings.json （ユーザー範囲）またはプロジェクトルートの .qwen/settings.json からMCPサーバーを読み取ります。mcpServersオブジェクトに scrapeless ブロックを追加します：

{
  "mcpServers": {
    "scrapeless": {
      "command": "npx",
      "args": ["-y", "scrapeless-mcp-server"],
      "env": { "SCRAPELESS_KEY": "$SCRAPELESS_KEY" },
      "timeout": 60000,
      "trust": true
    }
  }
}

ここで重要な2つの詳細があります。まず、Scrapeless MCPサーバーは SCRAPELESS_KEY からキーを読み取ります。これは SCRAPELESS_API_KEY ではありません — Scrapeless CLIとSDKは SCRAPELESS_API_KEY を使用しますが、MCPサーバーはドキュメント化された例外です。次に、Qwen Codeは env オブジェクト内で $VAR および ${VAR} を展開するため、環境にキーを保持し（export SCRAPELESS_KEY=...）、ファイル内にリテラル値を張り付ける代わりに $SCRAPELESS_KEY として参照できます。サーバーのソースは github.com/scrapeless-ai/scrapeless-mcp-server にあります。

手動でJSONを編集する代わりにCLIからサーバーを追加することもできます：

qwen mcp add --transport stdio --scope user --env SCRAPELESS_KEY=$SCRAPELESS_KEY --trust scrapeless npx -y scrapeless-mcp-server

4. またはHTTPストリーミングモードを使用

ホストが npx を信頼性高くスピンアップできない場合 — ホステッド開発コンテナ、リモートワークスペース、またはCIサンドボックス — は、Qwen Code をローカルプロセスの代わりに Scrapeless HTTP エンドポイントにポイントしてください。HTTP トランスポートの場合、Qwen Code はオプションの headers オブジェクトを伴う httpUrl キーを使用します。

{
  "mcpServers": {
    "scrapeless": {
      "httpUrl": "https://api.scrapeless.com/mcp",
      "headers": { "x-api-token": "YOUR_SCRAPELESS_KEY" }
    }
  }
}

同じキーの値は両方のモードで機能します。HTTP ストリーミングは、SCRAPELESS_KEY 環境変数の代わりに x-api-token ヘッダーとして渡します。Stdio は開発者ワークステーションでの適切なデフォルトであり、HTTP ストリーミングは長寿命の子プロセスを生かしておくのが難しい場所での適切なデフォルトです。

5. 接続を確認する

構成された MCP サーバーの一覧を表示します：

qwen mcp list

scrapeless サーバーは Connected と報告するはずで、これは Qwen Code が stdio プロセスを起動し、MCP ハンドシェイクを完了したことを意味します。そこからエージェントはサーバーの 21 のツール — Google データツール（google_search、google_trends）、ワンショットページヘルパー（scrape_html、scrape_markdown、scrape_screenshot）、およびクラウドブラウザのプラミティブ（browser_create、browser_goto、browser_get_html、browser_get_text、browser_click、browser_type、browser_press_key、browser_scroll、browser_scroll_to、browser_screenshot、browser_snapshot、browser_wait、browser_wait_for、browser_go_back、browser_go_forward、browser_close）を列挙できます。

実際の使い方：Qwen Code エージェントにプロンプトを出す

MCP サーバーを接続した後、ターミナルで Qwen Code に話しかけることでライブウェブデータを取得できます — ツール呼び出しを手動で書くのではありません。エージェントは Scrapeless MCP サーバーが公開するツールリストを読み込んで、必要に応じて google_search、scrape_markdown、または browser_* ツールを選択し、自然言語のプロンプトから順番にそれらを構成します。あなた側でツール JSON を作成する必要はありません。Qwen Code はプロンプトをインタラクティブにセッション内で、または提示を位置引数として渡すことで（または stdin でパイプすることで）一回限りの実行やスクリプトとして非インタラクティブに実行します。

貼り付けできるプロンプト

実演例

あなたが入力する（一回限り、プロンプトをstdinで渡す）：

echo "scrapeless google_search ツールを利用して「qwen code github」のトップ結果を見つけ、最上位の3件を{title, link}のJSON配列として返してください。" | qwen --approval-mode yolo --allowed-mcp-server-names scrapeless

エージェントの計画（平易な英語で）：

1. google_search を q: "qwen code github"、hl: "en"、gl: "us" で呼び出す。
2. 結果行の配列を受け取り、position、title、および link フィールドを読み取る。
3. position でソートし、最初の3行を保持する。
4. 各行を {title, link} オブジェクトにマッピングする。
5. JSON配列をターミナルに返す。

あなたが受け取るもの（例示的な形 — エージェントはこのような行から作業します）：

[
  { "title": "Qwen Codeはターミナル用のオープンソースAIエージェントです...", "link": "https://qwen.ai/qwencode" },
  { "title": "Qwen Codeの概要", "link": "https://qwenlm.github.io/qwen-code-docs/en/users/overview/" },
  { "title": "qwen-code/qwen-code-core", "link": "https://www.npmjs.com/package/@qwen-code/qwen-code-core" }
]
// フィールド名は google_search 行の形状と一致; 値は例示的なサンプルです。

--allowed-mcp-server-names scrapelessは実行をScrapelessツールに限定し、--approval-mode yoloはエージェントが対話型プロンプトなしで信頼されたツールを実行できるようにします — ヘッドレスおよびスクリプト実行に便利です。ステートレスデータツールは、そのペイロードをResponse:\n\nで始まるボディとして返します; エージェントはそのプレフィックスを展開してからJSONを解析するため、回答の中でそれを見ることはありません。

プロンプトの形状

以下は、基盤となる参照です — ツールのインターフェース、正確な戻り値の形、エージェントがあなたのために扱う動作。

Scrapeless MCPツールインターフェース

サーバーが接続されると、Qwen CodeはSERPデータ、ステートレススクレイピング、完全なアンチデetectionクラウドブラウザー制御を含む21のツールを見ることができます。

無料プランでAPIキーを取得: Scrapeless

戻り値

google_search呼び出しは、オーガニック結果行のJSON配列を返します。各行は同じキーを持っているため、エージェントはタイトル、リンク、スニペットに直接マッピングできます。

// フィールド名はgoogle_searchツールの出力を反映しており; 値は例示的なサンプルです。
[
  {
    "position": 1,
    "title": "Pythonでのウェブスクレイピング: 完全ガイド",
    "link": "https://example.com/python-web-scraping",
    "snippet": "Pythonを使用してウェブをスクレイピングし、HTMLを解析するためのステップバイステップガイド。",
    "source": "example.com"
  },
  {
    "position": 2,
    "title": "動的サイトのスクレイピング",
    "link": "https://example.org/dynamic-scraping",
    "snippet": "データを抽出する前にJavaScriptページをレンダリングする方法。",
    "source": "example.org"
  }
]

プロンプトを実行し始めたときのいくつかの正直な観察:

• google_searchやscrape_markdownのようなステートレスツールは、Response:\n\nで始まるボディを返し、その後にJSONペイロードが続きます; エージェントはそのプレフィックスを自動的に展開するため、データを扱い、ラッパーを扱う必要はありません。
• browser_*ツールはResponse:\n\nプレフィックスなしでプレーンテキストを返します。
• ツール引数はキャメルケースです: sessionId、proxyCountry、および類似のフィールドを元の名前の正確なままで渡してください。
• proxyCountryはリクエストであり、保証ではありません — アカウントに設定された地域に委ねることがあるため、地理的ターゲティングが重要な場合はエグレス地域を確認してください。
• ツール出力内の値はコンテンツ依存です: 結果数、順序、スニペットテキストはライブクエリによって異なります。

結論: ターミナルから検索、レンダリング、閲覧

全体の統合は、1つのMCPブロックと自然言語プロンプトに集約されます。~/.qwen/settings.jsonにscrapelessエントリがあり、環境にあなたのキーがあれば、Qwen CodeはライブGoogle検索、JavaScriptレンダリング、完全なアンチデtectionクラウドブラウザーを取得します — エージェントが自分自身で提供しないまさにウェブレイヤーです。タスクを説明します; エージェントがツールを選びます。
もし他のエージェントを接続する場合、同じScrapeless MCPサーバーもそれらに落ち込む: Google Antigravity や Pi Agent の統合、及び Scrapeless MCPサーバーの概要 を参照して、ツールの完全なリファレンスを確認してください。APIキーは SCRAPELESS_KEY に保持し、ローカルCLIにはstdioトランスポートを、ホストされたエージェントにはHTTPストリーミングを好み、エージェントにツールを選ばせてください。完全なリファレンスは docs.scrapeless.com でご確認ください。

AI駆動型データパイプラインの構築の準備はできていますか？

無料プランを取得し、Qwen Code + Scrapeless MCPエージェントを構築している開発者とつながるためにコミュニティに参加しましょう: Discord · Telegram。

無料のScraping Browserランタイムを取得するには Scrapeless にサインアップし、上記の統合をチームが必要とするSERP、ページ、地域に適応させてください。完全なリファレンスは docs.scrapeless.com でご確認ください。

FAQ

なぜQwen Codeはウェブ検索のためにMCPサーバーを必要とするのですか？

それは、組み込みのウェブ検索がないからです。web_searchコアツールは初期バージョンで削除され、公式ドキュメントはウェブ検索をMCPサーバーを通じてルーティングします。Scrapelessを接続することで、エージェントにその欠けている検索機能、ページのレンダリングされたアクセス、および完全なクラウドブラウザを提供します。

これはQwen Codeの組み込み web_fetch とどのように異なりますか？

web_fetchはURLの単純な取得を行います。JavaScriptをレンダリングせず、検出防止やプロキシ層もないため、単一ページアプリやボット保護されたサイトでは苦労します。Scrapelessツールは、欠けている検索（google_search）、クリーンなレンダリングされたテキスト（scrape_markdown）、そして住宅プロキシ上の状態を持つ検出防止ブラウザ（browser_*）を追加します。

どの環境変数がScrapelessキーを保持しますか？

SCRAPELESS_KEYです。これは文書化された例外です — Scrapeless CLIとSDKは SCRAPELESS_API_KEY を読みますが、MCPサーバーは SCRAPELESS_KEY を読みます。Qwen Codeは、設定の env オブジェクト内で $SCRAPELESS_KEY を通じてあなたの環境からそれを拡張できます。

Qwen CodeはMCP構成をどこから読みますか？

ユーザーのスコープで ~/.qwen/settings.json から、またはプロジェクトのスコープでプロジェクトルートの .qwen/settings.json からです。どちらも mcpServersオブジェクトを使用します。また、qwen mcp add でサーバーを追加し、qwen mcp list で接続を検査できます。

stdio対HTTPストリーミング — それぞれをいつ使用すべきですか？

サーバーがCLIと共にローカルで実行されている場合はstdioを使用します: Qwen Codeは scrapeless-mcp-server を子プロセスとして起動し、標準入力/出力を介して通信します。エージェントがホストされているかリモートでローカルプロセスをスパーンできない場合は、HTTPストリーミング（httpUrlキーがhttps://api.scrapeless.com/mcpを指し、x-api-tokenヘッダーを含む）を使用します。

proxyCountryは常に適用されますか？

必ずしもそうではありません。proxyCountryは、あなたのアカウントに設定された地域に依存することができる好みです。ジオターゲティングが重要な場合は、コールごとの値が常に勝つと仮定するのではなく、出口地域を確認してください。

エージェントを介したウェブスクレイピングは合法ですか？

公開されているデータのスクレイピングは一般的に許可されていますが、その利用方法に責任があります。各サイトの利用規約を確認し、robots.txtを尊重し、個人データおよびアクセスに関するルールは管轄によって異なることを覚えておいてください。疑問がある場合は、特定の使用ケースに関して法的アドバイスを受けてください。

AIエージェントなしでこれを使用できますか？

はい。Scrapeless MCPサーバーは標準のMCPサーバーなので、MCP互換のクライアントはそれを呼び出すことができます — またはJSON-RPCを通じて直接ドライブすることもできます（initialize、その後 tools/list と tools/call）。エージェントは便利さであり、必須ではありません。