CrawlBrief for LLMs.txt

Popis

CrawlBrief for LLMs.txt is a WordPress llms.txt generator that creates a structured /llms.txt file and optional Markdown versions of public WordPress content for AI assistants, AI agents and large language models.

The plugin supports the llms.txt v2 proposal, including rel="describedby" discovery for /llms.txt, rel="alternate" type="text/markdown" links for eligible WordPress content, and matching HTTP Link metadata on Markdown responses.

CrawlBrief combines automatic generation with editorial control. Instead of publishing an uncontrolled list of every URL, you can choose the pages that matter, organize important resources, edit descriptions, feature or exclude content, and provide clean Markdown representations that compatible AI tools can retrieve when needed.

WordPress llms.txt Generator

CrawlBrief automatically publishes:

  • /llms.txt – a structured, LLM-friendly overview of your WordPress website.
  • /index.html.md – a Markdown representation of the homepage.
  • /example-post/index.html.md – clean Markdown versions of eligible posts, pages and supported public post types.

The endpoints are served dynamically through WordPress. CrawlBrief does not create or overwrite physical llms.txt or Markdown files on your server.

llms.txt v2 Support

CrawlBrief includes discovery features from the current llms.txt v2 proposal:

  • Adds rel="describedby" so public pages can identify the applicable /llms.txt file.
  • Adds rel="alternate" type="text/markdown" for pages with a Markdown representation.
  • Sends matching discovery information through HTTP Link headers on Markdown responses.
  • Keeps the v2-compatible index.html.md URL format for WordPress URLs without filenames.
  • Links directly to clean Markdown resources from generated llms.txt sections when available.

Automatic and Manual Page Selection

Choose how CrawlBrief builds the important page sections of your llms.txt file:

  • Automatic – detect important WordPress pages automatically.
  • Automatic + Custom – use automatic detection and add your own selected WordPress resources.
  • Manual – control the selected resources yourself.

CrawlBrief can detect common site pages such as:

  • Homepage
  • About page
  • Contact page
  • Privacy Policy
  • Terms page
  • WordPress posts page
  • WooCommerce shop page when available

Automatically detected resources can be excluded individually.

Searchable WordPress Resource Selection

Add important WordPress pages using searchable selectors instead of manually copying URLs.

Selected resources are stored by WordPress post ID, so changing a page slug or permalink later does not break the corresponding llms.txt entry.

You can create separate selections for:

  • Start Here resources
  • Optional resources

Additional external URLs, archives and documentation hosted outside WordPress can still be added through the Advanced additional-links section.

Editable llms.txt Descriptions

CrawlBrief lets you control how important resources are described to AI systems.

You can:

  • Override descriptions for automatically detected pages.
  • Add description overrides to selected Start Here resources.
  • Add description overrides to selected Optional resources.
  • Set a dedicated llms.txt description on individual posts or pages.

If no override is supplied, CrawlBrief can fall back to the available WordPress description, excerpt, content-derived text or built-in role description.

Editorial Control

Each supported WordPress resource can use CrawlBrief’s editorial controls:

  • Automatic – let CrawlBrief include the resource normally.
  • Featured – prioritize the resource in a dedicated Featured Resources section.
  • Excluded – prevent the resource from appearing in generated CrawlBrief sections.

This makes CrawlBrief useful for curated llms.txt files rather than simple URL dumps.

Structured llms.txt Sections

Depending on your settings and content, CrawlBrief can generate sections for:

  • Start Here
  • Featured Resources
  • WordPress categories
  • Public post types
  • Pages
  • Site Indexes
  • Optional resources

You can configure the number of links per section, choose supported public post types, exclude selected category slugs, include the WordPress sitemap, and control optional sections.

CrawlBrief also prevents curated Optional resources from being duplicated in general page sections.

Clean Markdown for AI Assistants

Optional Markdown representations remove much of the surrounding theme and navigation markup and expose useful page content in a simpler text format.

Markdown output can contain:

  • Page or post title
  • Short description
  • Canonical URL
  • Author
  • Last-updated date
  • Featured image
  • Headings
  • Paragraphs
  • Lists
  • Links
  • Main page content

If a static WordPress homepage has no stored page body, CrawlBrief can use the configured site summary and detailed context so the homepage Markdown endpoint is still useful.

Caching and Automatic Regeneration

CrawlBrief includes an optional generated-output cache to reduce repeated database work.

It can:

  • Cache generated llms.txt output.
  • Regenerate cached content on a daily schedule.
  • Clear generated output when relevant WordPress content changes.
  • Invalidate stale output when CrawlBrief is upgraded.
  • Clear cached output when settings are saved.
  • Integrate with common WordPress caching plugins when available.

Privacy and Lightweight Operation

CrawlBrief performs generation inside your WordPress installation.

  • No external API is required.
  • No account is required.
  • No visitor analytics are collected by CrawlBrief.
  • Site content is not automatically sent to LLMs.txt Lab or another third-party service.
  • No public footer credit or backlink is added.
  • No physical llms.txt or Markdown files need to be written to the server.

Who Is CrawlBrief For?

CrawlBrief is useful for WordPress sites that want a maintained llms.txt file and clean Markdown content for AI assistants, AI agents, retrieval tools and other systems that support the llms.txt convention.

It can be used on:

  • Blogs
  • Educational websites
  • Documentation sites
  • Business websites
  • News and publishing sites
  • WooCommerce stores
  • Knowledge bases
  • Membership and learning websites
  • Sites using public custom post types

What Is llms.txt?

llms.txt is an emerging Markdown-based convention for giving AI systems a concise overview of a website and links to important machine-readable resources.

It is complementary to existing web standards such as robots.txt and XML sitemaps. CrawlBrief focuses on helping compatible AI assistants and agents discover and retrieve useful site content; it does not promise higher Google rankings or guaranteed inclusion in AI-generated answers.

Works With AI Assistants and Agents

CrawlBrief produces standard web and Markdown resources that can be accessed by compatible AI assistants, agents and retrieval tools, including tools associated with ecosystems such as ChatGPT, Claude, Perplexity and other large language model applications.

Actual use of llms.txt depends on the individual AI system or crawler.

Optional LLMs.txt Lab Tools

CrawlBrief generates and manages llms.txt inside WordPress. For additional checks or manual workflows, LLMs.txt Lab provides optional browser-based tools:

These tools are optional. CrawlBrief does not automatically send site content or generated llms.txt data to LLMs.txt Lab.

How to Verify the Plugin

After activation, open Settings > CrawlBrief for LLMs.txt. The settings page shows verification URLs for your website.

To check the generated llms.txt file, visit:

https://example.com/llms.txt

To check the homepage Markdown endpoint, visit:

https://example.com/index.html.md

To check a post or page Markdown endpoint, use the existing CrawlBrief pattern:

https://example.com/example-post/index.html.md

The /llms.txt URL should load as plain text. A post or page Markdown URL should load clean Markdown content with the title, canonical URL, last-updated date, author when available, and page body. The homepage Markdown endpoint contains the available homepage or configured site information.

For llms.txt v2 discovery, view the source of a public HTML page. CrawlBrief outputs:

<link rel="describedby" href="https://example.com/llms.txt">

For an eligible post or page with Markdown representations enabled, it also outputs:

<link rel="alternate" type="text/markdown" href="https://example.com/example-post/index.html.md">

Markdown endpoint responses also advertise the covering llms.txt file and canonical HTML page through the HTTP Link header.

LLMs.txt v2 Compatibility

CrawlBrief 1.2.5 follows the llms.txt v2 discovery model while retaining backward compatibility with existing CrawlBrief installations.

  • /llms.txt remains at the site root and covers the site’s public URLs.
  • Existing /index.html.md and /post/index.html.md representations are retained. llms.txt v2 explicitly permits index.html.md for URLs without file names.
  • Agents can discover Markdown representations through rel=“alternate“ type=“text/markdown“ rather than guessing URL transformations.
  • Public HTML pages point to the covering llms.txt with rel=“describedby“.
  • Markdown responses expose the same relationship through an HTTP Link header.
  • The Optional section remains available as a convention for secondary resources that agents may skip when a shorter context is needed; it is not treated as a special processing instruction.
  • Category and custom-post-type archive links remain normal HTML links unless CrawlBrief can actually serve a Markdown representation for the URL.

The llms.txt proposal remains an evolving community specification. See llmstxt.org for the current proposal.

Cache Compatibility

The plugin clears its internal transient cache when configured content changes. It also attempts to purge common caching plugins when available, including LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache and SiteGround Optimizer.

Other caching plugins can hook into:

crwbrf_txt_cache_purged

Privacy

This plugin does not collect analytics, track visitors or automatically send generated llms.txt content or site data to a third-party service. All generation happens inside WordPress using public site content and settings saved by the site administrator. Links to optional external tools, including LLMs.txt Lab, are opened only when an administrator chooses to visit them. CrawlBrief does not automatically transmit site content or generated llms.txt data through those links.

Snímky obrazovky

Instalace

  1. Upload the crawlbrief-llms-txt folder to /wp-content/plugins/.
  2. Activate CrawlBrief for LLMs.txt from the WordPress Plugins screen.
  3. Go to Settings > CrawlBrief for LLMs.txt.
  4. Choose a page-selection mode, review detected pages, add any custom resources, and configure the remaining options.
  5. Visit https://example.com/llms.txt to confirm the output loads.
  6. View the source of a public page to verify rel=“describedby“ and, when eligible, rel=“alternate“ type=“text/markdown“.

Nejčastější dotazy

What is llms.txt?

llms.txt is an emerging Markdown-based convention that gives AI assistants and agents a concise overview of a website and links to important resources.

Does CrawlBrief generate llms.txt automatically?

Yes. CrawlBrief dynamically serves a structured /llms.txt file from your WordPress content and settings.

Does CrawlBrief support llms.txt v2?

Yes. CrawlBrief supports v2 discovery features including rel="describedby", rel="alternate" type="text/markdown" and HTTP Link metadata for eligible Markdown resources.

Does CrawlBrief create Markdown versions of WordPress posts and pages?

Yes, when Markdown representations are enabled. Eligible public content can be accessed using URLs such as /example-post/index.html.md.

Can I choose which pages appear in llms.txt?

Yes. CrawlBrief provides Automatic, Automatic + Custom and Manual page-selection modes, along with per-resource Featured and Excluded controls.

Can I edit the descriptions shown in llms.txt?

Yes. Description overrides are available for automatically detected pages, selected WordPress resources and individual posts or pages.

Does CrawlBrief create physical files?

No. The /llms.txt and Markdown endpoints are served dynamically through WordPress rewrite rules.

Does CrawlBrief send my content to an external AI service?

No. CrawlBrief generates its output locally inside WordPress and does not require an external API. Optional LLMs.txt Lab links are opened only when an administrator chooses to visit them.

Will llms.txt improve my Google rankings?

CrawlBrief does not claim that llms.txt improves Google Search rankings. The file is intended as a structured resource for AI assistants, agents and tools that support the llms.txt convention.

Does CrawlBrief work with ChatGPT, Claude and Perplexity?

CrawlBrief publishes standard llms.txt and Markdown resources that compatible AI assistants, crawlers and retrieval systems can access. Whether a particular service fetches or uses those resources is controlled by that service.

Do I need Markdown representations?

No. You can disable Markdown representations if you only want /llms.txt. Public HTML pages can still advertise the applicable llms.txt file through rel="describedby".

Why does CrawlBrief keep index.html.md instead of changing to index.md?

The llms.txt v2 proposal permits both forms for URLs without file names. Keeping index.html.md preserves existing CrawlBrief URLs and avoids creating duplicate Markdown representations.

What does the Optional section mean in v2?

It is a convention for secondary resources that an agent may skip when a smaller context is preferred. CrawlBrief keeps Optional resources separate from general page sections.

What is the difference between the three page-selection modes?

Automatic uses important pages CrawlBrief can detect confidently. Automatic + Custom keeps those detected pages and lets you add more WordPress resources with searchable selectors. Manual disables automatic page inclusion and uses only your selected WordPress resources plus any additional external links.

Why store selected WordPress pages by post ID?

A post ID remains stable when a page slug or permalink changes. CrawlBrief resolves the current permalink when generating llms.txt, reducing broken curated links.

Should caching be enabled?

For most live websites, yes. Caching reduces repeated database work. CrawlBrief clears its generated cache when relevant content or settings change and also invalidates stale output after plugin upgrades.

Recenze

23. 8. 2026
Good, No extra load no extra files on server
Přečtěte si 1 recenzi

Autoři

CrawlBrief for LLMs.txt je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.

Spolupracovníci

Přehled změn

1.2.5

  • Updated the WordPress.org short description, tags, Description and FAQ with accurate keyword-focused documentation for llms.txt, WordPress, Markdown, AI assistants and llms.txt v2.
  • Streamlined the legacy free-form Start Here and Optional URL fields into one compact Additional / External Links Advanced section.
  • Renamed the visible fields to Additional Start Here Links and Additional Optional Links for clearer intent.
  • The Advanced section stays collapsed when both fields are empty and automatically opens when existing saved links are present.
  • Moved examples behind compact Show example controls to reduce settings-page clutter.
  • Preserved the existing start_here_links and optional_links setting keys, stored values, parsing, generation logic, and backward compatibility.
  • Reworked settings-save cache invalidation to use the WordPress Settings API option-update lifecycle, resolving Plugin Check nonce-verification warnings without changing user-facing behavior.
  • Preserved llms.txt generation, Markdown, v2 discovery, page selection, caching, editorial controls, and resource selection.

1.2.4

  • Added optional description overrides for automatically detected Start Here and Optional pages.
  • Added optional description overrides for searchable Start Here and Optional WordPress resources.
  • Leaving an override blank preserves the existing CrawlBrief description, excerpt, automatic role description, or fallback behavior.
  • Kept selected resources stored by WordPress post ID so permalink changes remain safe.
  • Preserved all existing page-selection modes, custom/external URL fields, editorial controls, Markdown endpoints, v2 discovery, caching, and generated-section behavior.

1.2.3

  • Automatically invalidates generated llms.txt cache after plugin version changes.
  • Clears generated output after a settings save even when the submitted values are unchanged.
  • Hardened curated-resource deduplication by reserving both WordPress IDs and canonical URLs.
  • Prevents Optional resources from leaking into generic post-type sections when URL-to-post resolution is unreliable.

1.2.2

  • Prevented curated Optional WordPress resources from being duplicated in generic Pages or custom-post-type sections.
  • Improved duplicate prevention for legacy/custom local curated URLs by resolving them back to their WordPress post ID when possible.
  • Improved static homepage Markdown output: when the front page has no stored post content, CrawlBrief now falls back to the configured site summary and detailed context instead of returning metadata only.
  • No settings, page-selection modes, v2 discovery behavior, Markdown URL patterns, editorial controls, or existing features were removed or changed.

1.2.1

  • Refreshed the CrawlBrief admin settings interface with a cleaner, modern WordPress-native visual layout.
  • Improved styling for form inputs, textareas, selection modes, automatic page cards, searchable resource pickers, dropdown results, add/remove controls, and responsive mobile layout.
  • This release is presentation-only: no setting keys, saved values, page-selection behavior, llms.txt generation logic, Markdown endpoints, or existing features were changed.

1.2.0

  • Added Automatic, Automatic + custom, and Manual page-selection modes.
  • Added safe automatic detection for Home, the posts page, About, Contact, Privacy Policy, Terms, and the WooCommerce shop page when available.
  • Added searchable AJAX-powered WordPress resource selectors for Start Here and Optional sections.
  • Selected WordPress resources are stored by post ID so permalink changes do not break llms.txt entries.
  • Added per-page opt-out controls for automatically detected resources.
  • Preserved existing free-form Start Here and Optional URL fields as Custom / External link fields.
  • Existing 1.1.x saved configurations remain in Manual mode after upgrade to avoid silently changing generated llms.txt output.
  • Added deduplication across automatically detected, manually selected, and custom URL resources within each curated section.
  • Prevented archive-backed WordPress pages such as the posts page and WooCommerce shop page from being rewritten to misleading Markdown mirror URLs.
  • Kept all existing llms.txt v2 discovery, Markdown endpoints, editorial controls, caching, category sections, sitemap support, and cache-plugin integrations.

1.1.0

  • Added support for the llms.txt v2 proposal while preserving existing CrawlBrief URLs and settings.
  • Added rel=“describedby“ discovery links from public HTML pages to the root /llms.txt file.
  • Added rel=“alternate“ type=“text/markdown“ discovery links for eligible HTML pages.
  • Added HTTP Link relationship metadata to Markdown responses.
  • Kept the existing index.html.md Markdown URL scheme, which remains valid under llms.txt v2.
  • Replaced URL-shape guessing with real WordPress resource resolution before converting configured links to Markdown URLs.
  • Prevented unsupported category/archive links from being rewritten to non-existent index.html.md endpoints.
  • Updated generated llms.txt guidance so agents follow advertised/direct Markdown links instead of guessing URL suffixes.
  • Updated Optional-section wording to match its v2 convention as secondary, skippable context.
  • Improved automatic section filling when earlier featured/excluded resources would otherwise reduce the configured link count.
  • Updated the settings screen and documentation with v2 verification guidance.
  • Prevented password-protected content from being exposed through Markdown endpoints or automatic llms.txt resource links.
  • Improved endpoint canonical-redirect handling for WordPress installations served from a subdirectory.

1.0.7

  • Added convenient links to LLMs.txt Lab validation and generation tools from the CrawlBrief settings page.

1.0.6

  • Improved sitemap URL discovery using the WordPress sitemap API.
  • Improved output escaping for llms.txt and Markdown responses.
  • General WordPress.org review compatibility improvements.

1.0.5

  • Updated the plugin slug and text domain to crawlbrief-llms-txt.
  • Updated the installation folder reference to match the reserved slug request.
  • Removed the outdated generic Plugin URI from the plugin header.

1.0.4

  • Kept WordPress query filters enabled during the one-time featured-resource migration.
  • Resolved the Plugin Check SuppressFilters_suppress_filters error.

1.0.3

  • Replaced the featured-resource post-meta filter with a maintained featured-post index.
  • Added a one-time batched migration for existing featured-resource selections.
  • Removed the Plugin Check slow meta query warnings.

1.0.2

  • Renamed the plugin to CrawlBrief for LLMs.txt.
  • Adopted the unique crwbrf_ prefix across plugin identifiers and stored data.
  • Updated the plugin author and website information.

1.0.1

  • Renamed the plugin with a distinctive identity and unique internal prefix.
  • Removed unrelated branding and promotional links.
  • Added featured/excluded editorial controls for individual resources.
  • Improved default-link, sitemap, homepage Markdown and cache-header behavior.

1.0.0

  • Initial pre-release submission.