PHPackages                             jaybizzle/laravel-crawler-detect - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. jaybizzle/laravel-crawler-detect

ActiveLibrary[Utility & Helpers](/categories/utility)

jaybizzle/laravel-crawler-detect
================================

A Laravel package to detect web crawlers via the user agent

v2.1.0(2w ago)3312.8M↓46.4%27[2 issues](https://github.com/JayBizzle/Laravel-Crawler-Detect/issues)[1 PRs](https://github.com/JayBizzle/Laravel-Crawler-Detect/pulls)17MITPHPPHP ^8.1

Since Mar 23Pushed 4y ago12 watchersCompare

[ Source](https://github.com/JayBizzle/Laravel-Crawler-Detect)[ Packagist](https://packagist.org/packages/jaybizzle/laravel-crawler-detect)[ Docs](https://github.com/JayBizzle/Laravel-Crawler-Detect)[ RSS](/packages/jaybizzle-laravel-crawler-detect/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (7)Dependencies (8)Versions (10)Used By (17)

Laravel Crawler Detect
======================

[](#laravel-crawler-detect)

[![Tests](https://camo.githubusercontent.com/76da76bafb2675bb1a316cdbab226e89f0996127958f842621b5331a23f1b57f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f4a617942697a7a6c652f4c61726176656c2d437261776c65722d4465746563742f74657374732e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265266c6162656c3d7465737473)](https://github.com/JayBizzle/Laravel-Crawler-Detect/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/e48e4513d2e6e1ec6ee552adf84f3e54c565b4a2b3093735a767476dd386cf34/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f4a617942697a7a6c652f4c61726176656c2d437261776c65722d4465746563742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jaybizzle/laravel-crawler-detect)[![Latest Version](https://camo.githubusercontent.com/1de4de55ca35d4ba1278d160b0137d4856e7d6f26fcbe5ae28b2c960074b825e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4a617942697a7a6c652f4c61726176656c2d437261776c65722d4465746563742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jaybizzle/laravel-crawler-detect)[![License](https://camo.githubusercontent.com/978aa960cbc65363c562081e5a9b19c9edf4e7f3af684db3647debac5a956a5d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f4a617942697a7a6c652f4c61726176656c2d437261776c65722d4465746563742e7376673f7374796c653d666c61742d737175617265)](LICENSE)

A Laravel wrapper for [Crawler-Detect](https://github.com/JayBizzle/Crawler-Detect) - the web crawler detection library.

Requirements
------------

[](#requirements)

- PHP 8.1+
- Laravel 10, 11, 12 or 13

Need support for an older version of Laravel or PHP? Use [v1.3.0](https://github.com/JayBizzle/Laravel-Crawler-Detect/tree/v1.3.0) of this package.

Installation
------------

[](#installation)

```
composer require jaybizzle/laravel-crawler-detect
```

The service provider and the `Crawler` facade alias are registered automatically via package auto-discovery.

Usage
-----

[](#usage)

```
use Crawler;

// Check the current visitor's user agent
if (Crawler::isCrawler()) {
    // true if a crawler user agent was detected
}

// Or pass a user agent string to check
if (Crawler::isCrawler('Mozilla/5.0 (compatible; aiHitBot/2.9; +https://www.aihitdata.com/about)')) {
    // true if a crawler user agent was detected
}

// Output the name of the bot that matched (if any)
echo Crawler::getMatches();
```

You can also type-hint the underlying class and let the container inject it:

```
use Jaybizzle\CrawlerDetect\CrawlerDetect;

public function index(CrawlerDetect $crawlerDetect)
{
    if ($crawlerDetect->isCrawler()) {
        // ...
    }
}
```

Or use the `Request` macros, which detect using the current request:

```
use Illuminate\Http\Request;

public function index(Request $request)
{
    if ($request->isCrawler()) {
        // Output the name of the bot that matched (if any)
        echo $request->crawler()->getMatches();
    }

    // Or pass a user agent string to check
    if ($request->isCrawler('Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)')) {
        // ...
    }
}
```

Testing
-------

[](#testing)

```
composer test
```

License
-------

[](#license)

Laravel Crawler Detect is open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance53

Moderate activity, may be stable

Popularity61

Solid adoption and visibility

Community29

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 90.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~592 days

Recently: every ~867 days

Total

8

Last Release

20d ago

Major Versions

v1.3.0 → v2.0.02026-07-11

PHP version history (3 changes)v1.0.0PHP >=5.3.0

v1.0.2PHP >=5.4.0

v2.0.0PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/340752?v=4)[Mark Beech](/maintainers/JayBizzle)[@JayBizzle](https://github.com/JayBizzle)

---

Top Contributors

[![JayBizzle](https://avatars.githubusercontent.com/u/340752?v=4)](https://github.com/JayBizzle "JayBizzle (75 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (6 commits)")[![GC-Mark](https://avatars.githubusercontent.com/u/1477806?v=4)](https://github.com/GC-Mark "GC-Mark (2 commits)")

---

Tags

botcrawlerdetectlaravelphpspiderlaravelcrawlercrawler detectcrawler detectorphp crawler detectcrawlerdetectuser agentbotspiderdetect

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jaybizzle-laravel-crawler-detect/health.svg)

```
[![Health](https://phpackages.com/badges/jaybizzle-laravel-crawler-detect/health.svg)](https://phpackages.com/packages/jaybizzle-laravel-crawler-detect)
```

###  Alternatives

[jaybizzle/crawler-detect

CrawlerDetect is a PHP class for detecting bots/crawlers/spiders via the user agent

2.4k106.5M301](/packages/jaybizzle-crawler-detect)[nmure/crawler-detect-bundle

A Symfony bundle for the Crawler-Detect library (detects bots/crawlers/spiders via the user agent)

25285.8k](/packages/nmure-crawler-detect-bundle)[emargareten/inertia-modal

Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps.

90157.6k](/packages/emargareten-inertia-modal)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.8k](/packages/tomshaw-electricgrid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)