v1.3.7 — Actively maintained

The open-source standard for bot detection.

Identify crawlers, spiders, and bots from any user-agent string. Three methods, zero dependencies, one Composer install.

Try it live View on GitHub

php interactive shell

> $detect = new CrawlerDetect;

> $detect->isCrawler('');

> $detect->getMatches();

= ""

97M+

Total installs

2.3M

Monthly installs

2,332

GitHub stars

276

Forks

What sets it apart

Not another SaaS dashboard. A single PHP class that does one thing and does it well.

Zero network overhead

Pure regex matching against a local signature database. No API calls, no latency penalty, no third-party dependency.

Thousands of signatures

Community-maintained list of known bots, crawlers, and spiders. Updated regularly with new signatures as they appear in the wild.

Three-method API

isCrawler(), getMatches(), and setUserAgent(). That's the entire surface area. Works standalone or with Laravel, Symfony, and Yii.

Interactive demo

See it in action

Drop in any user-agent string and CrawlerDetect will analyse it in real time. Try it — it's instant.

Up and running in seconds

One Composer command. No config files, no service providers, no setup.

Install

$ composer require jaybizzle/crawler-detect

Usage

PHP

use Jaybizzle\CrawlerDetect\CrawlerDetect;

// Check the current visitor's user-agent
$detect = new CrawlerDetect();

if ($detect->isCrawler()) {
    // It's a bot
}

// Or pass any user-agent string
$detect->isCrawler('Googlebot/2.1'); // true

// Get the name of the matched bot
$detect->getMatches(); // "Googlebot"