What is Puppeteer?

Puppeteer is a bot in the headless browsers category, operated by Google.

Bot name
Puppeteer
Operator
Google
Type
Bot
Respects robots.txt
No
robots.txt user agent
Puppeteer
Signs requests (Web Bot Auth)
No

About Puppeteer

Puppeteer is a Node.js library from the Chrome team that controls Chrome or Firefox from code. It is used for testing, screenshots, PDF generation and scraping.

Headless browsers run a full browser engine without a screen. They are used for testing, rendering and scraping sites that need JavaScript. Most scrapers that evade simple checks run in a headless browser, so client side detection matters more than the user agent here.

Puppeteer user agent

Anyone can copy a user agent string. Transfon Security also checks where each request comes from, so a request that claims to be a known crawler but comes from the wrong network is treated as a fake, not as the real crawler.

How to block Puppeteer in robots.txt

Puppeteer does not read robots.txt. The rules below record your policy, but they will not stop it. To actually block Puppeteer, use a WAF rule as shown in the next section.

Block Puppeteer from the whole site

User-agent: Puppeteer
Disallow: /

Block Puppeteer from some folders

User-agent: Puppeteer
Disallow: /private/
Disallow: /search

Allow Puppeteer only on some folders

User-agent: Puppeteer
Allow: /blog/
Disallow: /

Allow Puppeteer and block other crawlers

User-agent: Puppeteer
Allow: /

User-agent: *
Disallow: /

Things to know

  • Each host needs its own file. Rules on www.example.com do not apply to shop.example.com.
  • A crawler obeys only the most specific group that names it. Once you add a User-agent: Puppeteer group, Puppeteer ignores your User-agent: * rules, so repeat any that should still apply.
  • The user agent name is not case sensitive. We take Puppeteer from Puppeteer's user agent; check Google's own documentation if it publishes a different robots.txt name.
  • Crawlers cache robots.txt, so changes can take up to a day to apply. Disallow stops crawling but does not remove pages already collected or indexed.

Limits of robots.txt

  1. Puppeteer may not follow the rule. Puppeteer does not read robots.txt at all, so a rule for it has no effect.
  2. The user agent could be fake. robots.txt matches the name a request claims. Anyone can send Puppeteer's user agent, and a scraper using it is not bound by Google's robots.txt policy. Only checking the source network tells a real Puppeteer from a fake one.

Treat robots.txt as a statement of your policy, and enforce it where requests arrive.

Who should care about Puppeteer

Publishers

Puppeteer is a common tool for scrapers. Real readers never use it, so block it on article pages and keep it out of ad requests.

Transfon Security for publishers

Media buyers and advertisers

Traffic from Puppeteer on landing pages is automated. It inflates clicks and visits, so filter it from campaign data and raise it with the ad network.

Transfon Security for advertisers

E-commerce

Price scrapers, stock checkers and card testing scripts often run on Puppeteer. Block it on product, cart and checkout pages.

Transfon Security for e-commerce

SaaS and APIs

Puppeteer is normal for API clients but not for your web app. Allow it only on API routes that need a key, and rate limit it there.

Transfon Security for SaaS and APIs

Block Puppeteer with Transfon Security

Puppeteer ignores robots.txt, so it has to be stopped when the request arrives. Transfon Security shows Puppeteer by name in the Top Bots report, so you can see how often it visits and which pages it reads. Block or allow it with a User Agent rule, or slow it down with a rate limit decision rule.

Transfon Security

Control Puppeteer on your site

  • See every Puppeteer visit and the pages it reads
  • Spot bots that fake trusted crawler names
  • Block, allow or rate limit Puppeteer with one rule
  • Works with or without robots.txt support

Frequently asked questions

What is Puppeteer?

Puppeteer is a bot in the headless browsers category, operated by Google. Puppeteer is a Node.js library from the Chrome team that controls Chrome or Firefox from code. It is used for testing, screenshots, PDF generation and scraping.

Does Puppeteer respect robots.txt?

No. Puppeteer does not follow robots.txt, so a Disallow rule will not stop it. Block it by user agent at your server, CDN or WAF instead.

How do I block Puppeteer?

Block requests whose user agent contains "Puppeteer" at your server, CDN or WAF, because Puppeteer does not read robots.txt. In Transfon Security that is one User Agent block rule.

Is robots.txt enough to block Puppeteer?

No. robots.txt is voluntary, so Puppeteer may not follow it, and anyone can send Puppeteer's user agent, so a fake Puppeteer ignores your rule. Enforce the rule where requests arrive, at your WAF, and check the source network.

Should I block Puppeteer?

Headless browsers run a full browser engine without a screen. They are used for testing, rendering and scraping sites that need JavaScript. Most scrapers that evade simple checks run in a headless browser, so client side detection matters more than the user agent here.

Related bots

All headless browsers · Full bot directory

See Which Bots Visit Your Site

Transfon Security identifies every bot in this directory in your traffic reports, flags fake search crawlers, and lets you allow, block or rate limit each bot.

Stay ahead of the publishing curve

Privacy, security, monetization, and performance insights. A few emails a month, no spam.

By subscribing you agree to our privacy policy.