puppeteer/puppeteer

JavaScriptからChromeやFirefoxを操作し、ページ操作を自動化するライブラリです。

優良食堂ギット飯が実際に動かして検証し、選んだリポジトリです解説ページへ →
開発の材料自由に使える · Apache-2.0自動化・ワークフローTypeScript難易度
95,6540 保存
9,587フォーク243Issue
デモ・公式サイトをひらくpptr.dev

中辛 の解説

Chromeなどのブラウザ操作をJavaScriptやTypeScriptのコードから行えるライブラリで、ページ遷移、入力、クリック、テキスト取得をまとめて記述できます。インストールは、npm i puppeteerでChrome込みの版を入れる方法と、npm i puppeteer-coreでChromeを含まない版を入れる方法の2通りが示されています。READMEは、npmやpnpmなどが既定でインストールスクリプトをブロックする場合があり、その際はnpx puppeteer browsers installでブラウザを手動取得するよう案内しています。MCPサーバーのchrome-devtools-mcpもPuppeteerを基盤にしていると記載されています。実行に必要なNode.jsのバージョンは、この抜粋からは確認できません。

こんなリポジトリです

こんなときに便利です

  • JavaScript開発者が、ヘッドレスのChromeでページを開き、検索や要素のクリックを自動化したいとき
  • chrome-devtools-mcpなどのPuppeteerベースのMCPサーバーを通じて、ブラウザの自動操作やデバッグを行いたいとき
  • ページ上の特定のテキストを指定して取り出し、コンソールに出力したいとき

主な機能

DevTools ProtocolまたはWebDriver BiDi経由でChromeとFirefoxを操作画面を表示しないヘッドレス実行がデフォルトaria名やテキストで要素を指定するロケーター機能

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • npmなどのパッケージマネージャーが使える環境
  • インストールスクリプトがブロックされると、ブラウザが取得されず実行時エラーになるため、その場合は npx puppeteer browsers install で手動取得が必要
  • puppeteer-coreを使う場合、ブラウザの用意方法はこの抜粋からは確認できません
  • 実行に必要なNode.jsのバージョンはこの抜粋からは確認できません

すぐに始める

方法は2通りあります。どちらか一方を選んで実行してください。

方法A:Chrome込みの版を入れる(README記載のデフォルト)

  1. puppeteerをインストールします。インストール時にChromeが自動でダウンロードされます。
npm i puppeteer
  1. インストールスクリプトがブロックされ、ブラウザが取得されなかった場合のみ、手動で取得します。
npx puppeteer browsers install

方法B:Chromeを含まない版を入れる(ライブラリとして組み込む場合)

  1. puppeteer-coreをインストールします。この場合Chromeはダウンロードされません。
npm i puppeteer-core

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try puppeteer/puppeteer

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

95,6547日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

まねしやすいサンプル評点 50/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2017 年に作成

「自動化・ワークフロー」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/puppeteer/puppeteer.svg)](https://www.gitbap.com/r/puppeteer/puppeteer)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る