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. [Utility & Helpers](/categories/utility) 4. / 5. bnomei/kirby3-seobility ActiveKirby-plugin[Utility & Helpers](/categories/utility) bnomei/kirby3-seobility ======================= Kirby Plugin to use Seobility.net 5.1.0(9mo ago)7746MITPHPPHP >=8.2CI passing Since Apr 13Pushed 9mo 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 today 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 41 — FairBetter than 87% of packages Maintenance55 Moderate activity, may be stable Popularity19 Limited adoption so far Community8 Small or concentrated contributor base Maturity69 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 299d 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 [medienbaecker/kirby-modules Easily add modules to your pages 895.5k1](/packages/medienbaecker-kirby-modules)[belugadigital/kirby-navigation Kirby 5 field for hierarchical menus with drag & drop level indentation. 8614.7k](/packages/belugadigital-kirby-navigation)[bnomei/kirby3-dotenv Kirby Plugin for environment variables from .env 4149.6k2](/packages/bnomei-kirby3-dotenv)[bnomei/kirby3-recently-modified Kirby Section to display recently modified content pages 3210.6k](/packages/bnomei-kirby3-recently-modified)[moritzebeling/kirby-favicon Kirby plugin to meet all favicon needs 145.1k](/packages/moritzebeling-kirby-favicon)[johannschopplich/kirby-helpers Environment, SEO, and build utilities for Kirby CMS 287.9k](/packages/johannschopplich-kirby-helpers) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)