$ botsbrief serve
Your site, briefed for bots.
BotsBrief turns your published WordPress content into a clean, linked Markdown bundle and serves it at /okf/, so AI agents and answer engines can read what your site knows, without fighting your theme.
- Free and open source (GPL)
- No external calls
- Installs in under a minute
the problem
Agents should not have to parse your theme
A modern page is mostly markup: navigation, widgets, scripts, and styling wrapped around a few paragraphs of actual content. BotsBrief strips all of that away.
<!DOCTYPE html> <html><head><script src="gtm.js"></script> <link rel="stylesheet" href="theme.css">…</head> <body class="theme-x sidebar-on"> <div class="header-wrap"><nav class="menu"> <ul><li><a>Home</a></li><li><a>Shop</a>… <div class="cookie-banner">We use cookies…</div> <aside class="widgets"><div class="ad">…</div> <main><article> <h1>Toy safety</h1> <p>The actual content lives in here, buried under nine layers of <div>.</p> </article></main> <footer class="mega">…240 more links…</footer>
features
One plugin, the whole agent-ready stack
BotsBrief reads your content once and gives you everything an AI agent needs to understand your site, plus the tools to tidy it up.
Generates an OKF bundle
Every published post and page becomes its own clean Markdown file with a short YAML header, the Open Knowledge Format.
Serves it at /okf/
Live, cached, and sent with the correct Markdown content type. A ?okf= fallback covers sites on plain permalinks.
Live knowledge graph
See how your content links together, drawn right in your dashboard. Drag, zoom, and click a node to open the page.
llms.txt and discovery
Optionally publishes an llms.txt and a head hint, so agents can find the bundle the moment they arrive.
Internal link audit
Orphan pages, internal authority (a PageRank over your links), and link opportunities, from the same graph. Export to CSV.
Stays in sync
Publish, edit, or delete a post and the bundle rebuilds itself. Nothing to run by hand, nothing to remember.
how it works
Live in three steps
No configuration needed to start. Install it, and your bundle is live.
Install and activate
Upload the plugin in WordPress, or install it from the directory, and activate. That is the whole setup.
It reads your content
BotsBrief builds the bundle from your published posts and pages, skipping anything you have marked noindex by default.
Agents read /okf/
Your knowledge is now clean, linked Markdown at a stable address, ready for the crawlers and agents that read the web.
safe by design
Built to be safe and boring
It does one job and gets out of the way. Free software under the GPL, provided as is, so you can read every line before it touches your site.
- Makes no external calls, generated and served from your own site
- Reads your published content; never edits or deletes your posts
- Respects noindex from Rank Math and Yoast by default
- Cached and stored, so there is no rebuild on every request
questions
Everything you might be wondering
What is the Open Knowledge Format?
It is a way to publish your content as clean, linked Markdown that machines can read without parsing your theme. BotsBrief produces a bundle in that format. There is a full explainer on suganthan.com.
Does it slow my site down?
No. The bundle is built when your content changes and stored, then served from that stored copy. Visitors and agents read a cached result, so there is no rebuild on every request.
Does it work with custom post types?
Yes. Any public post type can be included from the settings page. Posts and pages are on by default.
Will it expose pages I have hidden from search?
Not by default. Anything you mark noindex in Rank Math or Yoast is skipped, so agents see only what you already let search engines see. You can change this in settings.
Does it send my content anywhere?
No. There are no external calls. Everything is generated and served from your own server.
$ wp plugin install botsbrief
Make your site readable by AI agents
Install BotsBrief and your content is a clean, linked Markdown bundle in minutes. Free, open source, and out of your way.