rukuma.dev — Agentic Website

An agentic website built entirely on Cloudflare's free tier ($0/month).

What's Live

URL	What	Status
https://rukuma.dev	Home page (static site)	✅
https://rukuma.dev/blog	Blog listing page	✅
https://rukuma.dev/search	AI-powered semantic search UI	✅
https://rukuma.dev/mcp	Stateless MCP server (4 tools)	✅
https://rukuma.dev/llms.txt	LLM documentation index	✅
https://rukuma.dev/robots.txt	Agent-friendly robots.txt	✅
https://rukuma.dev/sitemap.xml	XML sitemap	✅
https://rukuma.dev/manifest.json	Web manifest	✅
https://rukuma.dev/api/health	Health check	✅
https://rukuma.dev/api/pages	List all pages (JSON)	✅
https://rukuma.dev/api/page/:slug	Get page detail (JSON)	✅
https://rukuma.dev/api/search	Semantic search (POST)	✅
https://rukuma.dev/api/agent-stats	AI agent visit analytics	✅
https://rukuma.dev/md/:slug	Markdown for agents	✅
https://rukuma.dev/json/:slug	JSON for agents	✅

Stack

• Worker: Single Cloudflare Worker (the 1 allowed on free plan)
• D1: Content storage (pages, analytics, agent visits) — 5GB free
• KV: Edge caching (page cache, API response cache)
• Vectorize: Semantic search index (1024-dim bge-m3 embeddings)
• Workers AI: Embedding generation (bge-m3) — 10K Neurons/day free
• Static Assets: HTML/CSS/JS served from the Worker

MCP Tools

The /mcp endpoint exposes 4 tools for AI agents:

1. search(query, limit?) — Semantic search across all content
2. read_page(slug) — Get full markdown of any page
3. list_pages(category?) — List all available pages
4. site_info() — Site metadata and capabilities

Cron Jobs

Schedule	Purpose
0 */6 * * *	Re-index content → Vectorize embeddings
0 0 * * *	Cleanup old analytics (>30 days)

Deploy

export CLOUDFLARE_API_TOKEN="your-token"

# Apply D1 migrations
npx wrangler d1 migrations apply rukuma-dev-db --remote

# Seed content
python3 seed.py

# Index content into Vectorize
python3 index_content.py

# Deploy Worker
npx wrangler deploy

Project Structure

rukuma-dev/
├── wrangler.jsonc          # Worker configuration
├── tsconfig.json           # TypeScript config
├── src/
│   └── worker.ts           # Main Worker (API + MCP + static serving)
├── public/                  # Static Assets
│   ├── index.html           # Home page
│   ├── blog/
│   │   └── index.html       # Blog listing
│   ├── search/
│   │   └── index.html       # Search UI
│   ├── css/
│   │   └── style.css        # Site styling
│   └── js/
│       ├── app.js           # Home page JS
│       ├── blog.js          # Blog page JS
│       └── search.js        # Search page JS
├── migrations/
│   └── 0001_init.sql        # D1 schema
├── seed.py                  # D1 content seeder
├── index_content.py         # Vectorize indexer
└── README.md

Cost: $0/month

Everything runs within Cloudflare's free tier limits.