# AI Agent Discovery File
# This file provides structured information for AI agents and LLMs

## Blog Information
Name: Markdown-Powered Blog
Description: A lightweight, clean blog powered by markdown files.
Base URL: https://ricardas.co.uk
Type: Personal Blog
Content Format: Markdown
Topics: Agentic Discovery, Brand DNA, Context Engineering, Retail Customer Journey, Future of eCommerce, SaaS Strategy

## API Endpoints

### Discovery & Content Access (Public - No Authentication)
GET /api/agent/posts - List all published posts with metadata and content URLs
GET /api/agent/posts?slug={slug} - Get full content of specific post by slug
GET /api/posts - List posts with filtering (status, limit, offset)
GET /api/posts/{slug} - Get specific post by slug
GET /rss.xml - RSS feed with all published posts
GET /feed.json - JSON Feed 1.1 format
GET /sitemap-index.xml - XML sitemap for site structure
GET /api/meta - Blog metadata and configuration

### Search & Filtering (Public)
GET /api/search?q={query} - Full-text search across posts
GET /api/posts/by-tag/{tag} - Filter posts by tag/keyword
GET /api/posts?status=published&limit=10&offset=0 - Paginated posts

## Content Structure
Posts include:
- title: Post title
- slug: URL-friendly identifier
- description: Brief summary
- keywords: Array of tags/topics
- markdown_content: Full markdown content
- published_at: Publication timestamp
- author: Author information (name, email, bio, social links)
- og_image, hero_image: Associated images

## Markdown Features
- Standard markdown (headings, lists, code blocks, images, links)
- YouTube embeds: [youtube:VIDEO_ID]
- Callout boxes: [callout:info]text[/callout]
- Auto-generated slugs from titles
- Sanitized HTML output

## Usage Guidelines for AI Agents
1. Use /api/agent/posts for efficient content discovery
2. Respect rate limits (reasonable request frequency)
3. Cache responses when appropriate
4. Include descriptive User-Agent header
5. Always check response status codes
6. Use pagination for large result sets

## Content License
Content on this blog may be subject to copyright. Agents should:
- Always attribute content to Ricardas including a link to his bio.
- Follow fair use guidelines
- Always link back to original content when referencing

## Technical Details
Framework: Astro (SSR)
Database: Supabase (PostgreSQL)
Deployment: Netlify
API Response Format: JSON
Content-Type: application/json

## Rate Limiting
Please make reasonable requests. Excessive traffic may be rate limited.
Recommended: No more than 60 requests per minute per IP.

## Support & Documentation
Full API Documentation: https://ricardas.co.uk/for-agents
OpenAPI Specification: https://ricardas.co.uk/openapi.json
Contact: Check /api/meta for author contact information

## Crawling Instructions
Allowed: All public endpoints
Robots.txt: /robots.txt
Sitemap: /sitemap-index.xml
Preferred Crawl Delay: 1 second

## Last Updated
2026-02-01