Repository navigation
feat(site): ready for AI agents - #1
Merged
Merged
Conversation
- Every page as Markdown: the site's own pages are written out from their <main> after the build, next to the docs' own; each page links to it, and the zone serves it for Accept: text/markdown. - An MCP server over the docs at /docs/mcp (search_docs, read_page, list_pages), the one address that runs code, and the same tools in the browser through WebMCP. - /.well-known: the API catalog, the MCP server card, the AI catalog and the skills index with a Firenook skill; /auth.md says nothing needs an account. - robots.txt with Content Signals and the AI crawlers by name; a Link header on the home page; Vary: Accept. - A docs page, /docs/tools/agents, and check:site checks the Markdown, every search result's page and heading, and the skill's digest. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YXrJymDkQp71Esk3fwMmYV
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Makes firenook.dev ready for AI agents, by the checks of Cloudflare's Agent Readiness scanner.
<main>after the build (the docs already had theirs), each page links to its Markdown, and a zone rewrite rule serves it toAccept: text/markdown./docs/mcpwithsearch_docs,read_pageandlist_pages, on Streamable HTTP. It is the one address that runs code (runWorkerFirst); everything else stays static. The same tools are registered in the browser through WebMCP./.well-known: API catalog (RFC 9727), MCP server card, AI catalog, skills index and a Firenook skill./auth.mdsays nothing needs an account.Linkheader; every response getsVary: Accept./docs/tools/agents.check:sitenow checks every page's Markdown, every search result's page and heading (431 anchors), and the skill's digest.Tested locally with
cf-wrangler dev: the official MCP SDK client (1.32.1) connects, lists the tools and calls each; WebMCP registers its four tools on site and docs pages.🤖 Generated with Claude Code
https://claude.ai/code/session_01YXrJymDkQp71Esk3fwMmYV