Skip to content

Add agent discovery headers and Content-Signal to robots.txt - #1160

Merged
marco-s merged 6 commits into
linuxfoundation:mainfrom
LinuxAzzamean:agent-discovery-content-signals
Aug 20, 2026
Merged

Add agent discovery headers and Content-Signal to robots.txt#1160
marco-s merged 6 commits into
linuxfoundation:mainfrom
LinuxAzzamean:agent-discovery-content-signals

Conversation

@LinuxAzzamean

Copy link
Copy Markdown
Contributor

Goal 1: Link headers for agent discovery
Adds a Link: </.well-known/api-catalog>; rel="api-catalog" header on the homepage
Adds a /.well-known/api-catalog endpoint (RFC 9727 Linkset format) so the header resolves to a real document instead of a 404

Goal 2: Content Signals in robots.txt
Adds Content-Signal: ai-train=no, search=yes, ai-input=no via the existing the_seo_framework_robots_txt_sections filter, alongside the current llms.txt pointer
Tested against dev (dev-lfeventsci.pantheonsite.io), all four checks (homepage headers, robots.txt, api-catalog endpoint) confirmed working.

Signed-off-by: Andrew Bringaze <abringaze@linuxfoundation.org>
@LinuxAzzamean
LinuxAzzamean force-pushed the agent-discovery-content-signals branch from 131c20b to 2f38980 Compare August 20, 2026 19:15
@marco-s
marco-s requested a balanced review from Copilot August 20, 2026 19:18

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds agent-facing API discovery and AI content-use preferences.

Changes:

  • Adds homepage API-catalog discovery headers.
  • Serves an RFC 9727 API catalog.
  • Adds Content Signals to robots.txt.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
public/class-lfevents-public.php Adds the homepage discovery header.
includes/class-lfevents.php Registers discovery and robots hooks.
includes/class-lfevents-well-known.php Implements the API catalog endpoint.
includes/class-lfevents-llms-txt.php Adds the Content-Signal directive.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines +104 to +107
$sections['lfe_content_signal'] = array(
'raw' => 'Content-Signal: ai-train=no, search=yes, ai-input=no' . "\n",
'priority' => 900,
);
Per RFC 9264, link target objects only support defined members like
title, not an arbitrary description field. This keeps the same text
but represents it correctly so the document conforms to the declared
RFC 9727 profile.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Andrew B. <137023659+LinuxAzzamean@users.noreply.github.com>
@marco-s
marco-s requested a balanced review from Copilot August 20, 2026 19:47

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.

Suppressed comments (1)

web/wp-content/mu-plugins/custom/lfevents/includes/class-lfevents-llms-txt.php:107

  • This section emits the directive without a User-agent declaration. The SEO Framework appends raw sections after its generated groups, so the signal can be associated with whichever bot-specific group precedes it (or treated as orphaned) rather than applying to all agents. Emit a complete wildcard group so the intended site-wide policy has deterministic scope.
		$sections['lfe_content_signal'] = array(
			'raw'      => 'Content-Signal: ai-train=no, search=yes, ai-input=no' . "\n",
			'priority' => 900,
		);

per Copilot suggestion

Signed-off-by: Marco Schmoecker <dsw@gmx.net>
Clean up edit

Signed-off-by: Marco Schmoecker <dsw@gmx.net>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.

Signed-off-by: Andrew Bringaze <abringaze@linuxfoundation.org>
Signed-off-by: Andrew Bringaze <abringaze@linuxfoundation.org>
@marco-s
marco-s merged commit 3701b91 into linuxfoundation:main Aug 20, 2026
5 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants