PHPackages                             bnomei/kirby3-seobility - 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. bnomei/kirby3-seobility

ActiveKirby-plugin

bnomei/kirby3-seobility
=======================

Kirby Plugin to use Seobility.net

5.1.0(8mo ago)7745MITPHPPHP >=8.2CI passing

Since Apr 13Pushed 8mo ago2 watchersCompare

[ Source](https://github.com/bnomei/kirby3-seobility)[ Packagist](https://packagist.org/packages/bnomei/kirby3-seobility)[ RSS](/packages/bnomei-kirby3-seobility/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (6)Versions (14)Used By (0)

Kirby Seobility
===============

[](#kirby-seobility)

[![Kirby 5](https://camo.githubusercontent.com/b1a1b2ccd58e96259a9722c2489d91f40378c01b6c4c3e9fd27ed1d12c269d7c/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f4b697262792f353f636f6c6f723d454343373438)](https://getkirby.com)[![PHP 8.2](https://camo.githubusercontent.com/fd050028b4459f3f6e4db5703412957375ceb180d27951213d421eb2a23c8c8e/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f5048502f382e323f636f6c6f723d3445354239332669636f6e3d706870266c6162656c)](https://camo.githubusercontent.com/fd050028b4459f3f6e4db5703412957375ceb180d27951213d421eb2a23c8c8e/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f5048502f382e323f636f6c6f723d3445354239332669636f6e3d706870266c6162656c)[![Release](https://camo.githubusercontent.com/381798173188c03a5f72836610893a6a289291b7c1bec9cc346656aeed2fc2cf/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f626e6f6d65692f6b69726279332d73656f62696c6974793f636f6c6f723d6165383166662669636f6e3d676974687562266c6162656c)](https://camo.githubusercontent.com/381798173188c03a5f72836610893a6a289291b7c1bec9cc346656aeed2fc2cf/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f626e6f6d65692f6b69726279332d73656f62696c6974793f636f6c6f723d6165383166662669636f6e3d676974687562266c6162656c)[![Downloads](https://camo.githubusercontent.com/72fedb5a79a4714c05e1d54af9570c95a5923d929f52d3cba9bae6dad6b3ddd9/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f626e6f6d65692f6b69726279332d73656f62696c6974793f636f6c6f723d3237323832322669636f6e3d676974687562266c6162656c)](https://camo.githubusercontent.com/72fedb5a79a4714c05e1d54af9570c95a5923d929f52d3cba9bae6dad6b3ddd9/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f626e6f6d65692f6b69726279332d73656f62696c6974793f636f6c6f723d3237323832322669636f6e3d676974687562266c6162656c)[![Coverage](https://camo.githubusercontent.com/efd3250ca4707d695cd23a7619de5f8c343da45ed90e6e682ab2c04ded3ae444/68747470733a2f2f666c61742e62616467656e2e6e65742f636f6465636c696d6174652f636f7665726167652f626e6f6d65692f6b69726279332d73656f62696c6974793f69636f6e3d636f6465636c696d617465266c6162656c)](https://codeclimate.com/github/bnomei/kirby3-seobility)[![Maintainability](https://camo.githubusercontent.com/5d23815f989023bbfa0bf4b5ef23bd1cdcb187899f19f5cbc3eaabc6b6346117/68747470733a2f2f666c61742e62616467656e2e6e65742f636f6465636c696d6174652f6d61696e7461696e6162696c6974792f626e6f6d65692f6b69726279332d73656f62696c6974793f69636f6e3d636f6465636c696d617465266c6162656c)](https://codeclimate.com/github/bnomei/kirby3-seobility/issues)[![Discord](https://camo.githubusercontent.com/36eaef1b06f4996feb7587aa3281dcbd658e57535bc6b5e10110ed108e7a7a03/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f646973636f72642f626e6f6d65693f636f6c6f723d3732383964612669636f6e3d646973636f7264266c6162656c)](https://discordapp.com/users/bnomei)[![Buymecoffee](https://camo.githubusercontent.com/62e55d1129b82bf9c2fd4656451e81ab87a9787e7c9676ca58276532ed9666ee/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f69636f6e2f646f6e6174653f69636f6e3d6275796d6561636f6666656526636f6c6f723d464638313346266c6162656c)](https://www.buymeacoffee.com/bnomei)

Kirby Plugin to use [Seobility.net](https://www.seobility.net/?ref=kirby3-seobility-plugin)

- keyword check (paid api)
- real time SERP ranking (paid api)
- term suggestion (paid api)

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

[](#installation)

- unzip [master.zip](https://github.com/bnomei/kirby3-seobility/archive/master.zip) as folder `site/plugins/kirby3-seobility` or
- `git submodule add https://github.com/bnomei/kirby3-seobility.git site/plugins/kirby3-seobility` or
- `composer require bnomei/kirby3-seobility`

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

[](#requirements)

### robots.txt

[](#robotstxt)

You need a `robots.txt` file for the checks to work on your production server. Either you create a custom `robots.txt`-file or use my [Robots.txt plugin](https://github.com/bnomei/kirby3-robots-txt). Make sure the [Seobility.net](https://www.seobility.net/?ref=kirby3-seobility-plugin) bot can crawl the website by setting your global debug config to `false` or by adding the following to your `robots.txt`:

```
User-agent: *
Disallow: /kirby/
Disallow: /site/
Disallow: /cdn-cgi/
Allow: /media/

```

### Localhost = No Score

[](#localhost--no-score)

The plugin will not query the API on localhost since the API would not be able to read the HTML content of your page.

Usage
-----

[](#usage)

### Keyword check (paid api)

[](#keyword-check-paid-api)

Add the field `keywordcheck` to your blueprints.

**site/blueprints/default.yml**

```
fields:
  keywordcheck: # the field id must be exactly like this
    label: Seobility.net Keywordcheck
    type: keywordcheck
```

Enter keywords(s) in the Panel. Save and get a score. Clicking on the score will take you to new browser tab with the full report.

[![keywordcheck](https://raw.githubusercontent.com/bnomei/kirby3-seobility/master/screenshot-keywordcheck.png)](https://raw.githubusercontent.com/bnomei/kirby3-seobility/master/screenshot-keywordcheck.png)

You can also read the score with a PageMethod if you need it in you business logic.

**site/templates/default.php**

```
echo $page->keywordcheckScore();
```

To show the score of the `keywordcheck` field the plugin will query your paid API account and cache the results until the content page is modified or cache expires (see settings below).

Tip

EVERY time you press the save button in the Panel for a page with this field a request to the API will be made. This might delay saving by a second or two. The paid API is a tiny bit faster.

### Real-time SERP Ranking (paid api)

[](#real-time-serp-ranking-paid-api)

This field is a button to trigger a real-time, synchronous (direct) API call. The average response time is **up to 30 seconds** and it will return the rank, title and description as listed on the specified search engine (see config setting `bnomei.seobility.searchengine`).

Note

You need to have a `keywordcheck` field on the same blueprint and at least one keyword set to get a SERP ranking.

**site/blueprints/default.yml**

```
fields:
  ranking:
    headline: Seobility.net SERP Ranking
    label: Fetch Rank
    progress: Fetching Rank...
    # notranked: Page is not ranked.
    type: ranking
```

[![ranking](https://raw.githubusercontent.com/bnomei/kirby3-seobility/master/screenshot-ranking.png)](https://raw.githubusercontent.com/bnomei/kirby3-seobility/master/screenshot-ranking.png)

### Term Suggestion (paid api)

[](#term-suggestion-paid-api)

This field is a button to trigger a term suggestion (more, less, ok) for the specified search engine (see settings).

Note

You need to have a `keywordcheck` field on the same blueprint and at least one keyword set to get further term suggestions.

**site/blueprints/default.yml**

```
fields:
  termsuggestion:
    headline: Seobility.net Term Suggestion
    label: Fetch Term Suggestions
    progress: Fetching Term Suggestions...
    type: termsuggestion
```

[![termsuggestion](https://raw.githubusercontent.com/bnomei/kirby3-seobility/master/screenshot-termsuggestion.png)](https://raw.githubusercontent.com/bnomei/kirby3-seobility/master/screenshot-termsuggestion.png)

Paid API
--------

[](#paid-api)

You need to set the API-key in the config if you want to use features from the [paid api](https://www.seobility.net/static/api/documentation.html).

**site/config/config.php**

```
return [
    // other config settings ...
    'bnomei.seobility.apikey' => 'YOUR-KEY-HERE',
];
```

You can also set a callback if you use the [dotenv Plugin](https://github.com/bnomei/kirby3-dotenv).

**site/config/config.php**

```
return [
    // other config settings ...
    'bnomei.seobility.apikey' => function() {
        return env('SEOBILITY_APIKEY');
    },
];
```

Cache
-----

[](#cache)

When Kirby's **global** debug config is set to `true` the complete plugin cache will be flushed but caches will still be created.

Settings
--------

[](#settings)

bnomei.seobility.DefaultDescriptionenabled`true`but disabled on localhost by defaultexpire`0`will expire on modified or after n-minutesapikey`null`string or callbacksearchengine`google.com`the target searchengine domainDisclaimer
----------

[](#disclaimer)

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please [create a new issue](https://github.com/bnomei/kirby3-seobility/issues/new).

License
-------

[](#license)

[MIT](https://opensource.org/licenses/MIT)

It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance61

Regular maintenance activity

Popularity19

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~103 days

Recently: every ~307 days

Total

13

Last Release

249d ago

Major Versions

1.4.1 → 5.0.12024-12-03

PHP version history (2 changes)1.0.0PHP >=7.4.0

5.0.1PHP >=8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3265642?v=4)[Bruno Meilick](/maintainers/bnomei)[@bnomei](https://github.com/bnomei)

---

Top Contributors

[![bnomei](https://avatars.githubusercontent.com/u/3265642?v=4)](https://github.com/bnomei "bnomei (35 commits)")

---

Tags

auditcheckkeywordkirbykirby-cmskirby-pluginkirby4kirby5seoseobilitysitesuggestiontermtf-idfcheckAuditkeywordseositetermkirbykirby-pluginkirby-cmsrankingTF-IDFsuggestionTFIDFseobility

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/bnomei-kirby3-seobility/health.svg)

```
[![Health](https://phpackages.com/badges/bnomei-kirby3-seobility/health.svg)](https://phpackages.com/packages/bnomei-kirby3-seobility)
```

###  Alternatives

[bnomei/kirby3-janitor

Kirby Plugin for running commands like cleaning the cache from within the Panel, PHP code or a cronjob

9339.9k2](/packages/bnomei-kirby3-janitor)[bnomei/kirby3-feed

Generate a Atom/JSON/RSS-Feed and XML-Sitemap from Pages-Collections

7224.8k](/packages/bnomei-kirby3-feed)[belugadigital/kirby-navigation

Kirby 5 field for hierarchical menus with drag & drop level indentation.

8713.4k](/packages/belugadigital-kirby-navigation)[bnomei/kirby3-dotenv

Kirby Plugin for environment variables from .env

4144.1k1](/packages/bnomei-kirby3-dotenv)[moritzebeling/kirby-favicon

Kirby plugin to meet all favicon needs

144.8k](/packages/moritzebeling-kirby-favicon)[bnomei/kirby3-fingerprint

File Method and css/js helper to add cache-busting hash and optional Subresource Integrity to file

4130.5k1](/packages/bnomei-kirby3-fingerprint)

PHPackages © 2026

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