Developer portal

Build against the public surfaces of this site.

This is a small personal site, not a SaaS API. The useful integration points are read-only: writing metadata, post markdown, sitemap discovery, and agent-readable docs. No API key is required today.

Docs index

/docs.md gives agents the map: pages, APIs, content types, and examples.

LLM brief

/llms.txt is the compact machine-readable overview of Madhu, current work, and routes.

Blog API

/api/blog returns post metadata as JSON. /api/blog/:slug returns one post.

Sandbox

Use live read-only endpoints as the sandbox. They are safe to call from scripts and agents.

Quickstart

# Discover crawlable routes
curl -s https://madhugb.com/sitemap.xml

# Fetch the writing index
curl -s https://madhugb.com/api/blog

# Fetch one post as JSON
curl -s https://madhugb.com/api/blog/hermes-needs-a-window

# Ask for markdown when available
curl -H 'Accept: text/markdown' https://madhugb.com/about

API keys

No public write API exists, so no API keys are issued. If that changes, key creation and scoped permissions will be documented here first.

Available endpoints

GET /api/blogGET /api/blog/:slugGET /blog/posts/:slug.mdGET /sitemap.xmlGET /llms.txtGET /docs.md

Agent behavior

Unknown paths return a real 404, not the app shell.
Prefer /sitemap.xml, /llms.txt, and /docs.md before scraping HTML.
Use Accept: text/markdown for supported human pages when you want a compact text version.