WP Manifestindependent plugin directory
manifest / ai / okf-for-wordpress

BotsBrief

Generate and auto-serve an Open Knowledge Format (OKF) bundle of your WordPress content for AI agents at /okf/

by Suganthan Mohanadasan · github.com/suganthan-mohanadasan/okf-for-wordpress · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/suganthan-mohanadasan/okf-for-wordpress/archive/refs/heads/main.zip

Readme

BotsBrief

Grade how ready your content is for AI crawlers and agents, see which bots read your site, and make it usable by agents. A self contained WordPress plugin: everything runs on your own server, nothing leaves your site.

Most AI crawlers do not run JavaScript and read your raw server HTML, so a PHP plugin sees exactly what they see. BotsBrief grades that view honestly, proves it with your own bot logs, and generates the agent surface almost no site has yet.

Three layers

  • Read — a 0 to 100 readiness grade for every post and page, in the block editor as you write and across the whole site worst first, each result explained with a fix. It grades the signals that decide whether an AI system can read and quote you: content in the server HTML, crawler access, an answer first lead, and clean structure.
  • Retrieve — serve any page as clean Markdown, plus an optional llms.txt and an Open Knowledge Format bundle at /okf/.
  • Act — generate a Model Context Protocol server on WordPress core's Abilities API so agents can query your content through read only tools, plus an experimental WebMCP bridge. Off by default.

Alongside the three layers, AI Activity is a local monitor of which AI crawlers and agents read your site, how often, and which pages, honest about the fact that a full page cache can hide some hits.

Install

  1. Download the latest zip from the releases page, or clone this repo into wp-content/plugins/.
  2. Activate the plugin from the Plugins screen.
  3. Open BotsBrief in the admin. The Dashboard shows your grade, the bots reading you, and your agent capabilities on one screen.
  4. Run a scan from Grade to score every page, and open Agent to turn on the Markdown endpoints or the MCP server.

For the clean /okf/ address, enable pretty permalinks under Settings, Permalinks.

Admin app

The admin is a React app built with Vite. The source is in admin-src/; build it with npm install && npm run build (output: build/botsbrief-admin.js). The bundled libraries (React, Mantine, lucide) are MIT licensed.

Requirements

  • WordPress 6.0 or later
  • PHP 7.4 or later

Background

License

GPL-2.0-or-later.

Read the full README on GitHub →