๐ Getting Started
This publisher provides content in multiple formats for AI systems, crawlers, and licensing platforms.
# Start the API server
cd /Users/pfarrow/Coding/drpaulfarrowcom/public/publisher
npm install
npm start
# Server runs on http://localhost:3000
๐ View Full API Documentation
๐ฆ README | ๐ง Installation Guide
๐ Available Formats
- โ HTML Articles - Semantic HTML with Schema.org, OpenGraph, AI permissions
- โ RSS/Atom Feeds - Global, category, and tag-based feeds
- โ XML Sitemaps - For search engines and crawlers
- โ REST API - JSON API with pagination and filtering
- โ GraphQL - Flexible queries with GraphiQL interface
- โ MCP Protocol - Model Context Protocol for LLMs
- โ NLWeb Format - Natural Language Web structured summaries
- โ Archive Export - JSON, NDJSON, XML bulk exports
๐ Articles
Start the server to access articles through the API
- โ The Future of Privacy-First Advertising
- โ Neural Networks and Synaptic Plasticity
- โ AMPA Receptors: A Deep Dive
- โ Prebid's Approach to Privacy Solutions
- โ AI Ethics in Digital Advertising
- โ Navigating the Post-Cookie World
- โ From Neuroscience to Tech: A Career Journey
- โ Privacy Enhancing Technologies Explained
- โ The Future of Programmatic Advertising
- โ From Research to Product Management
๐ Quick Links (Server Required)
๐งช Example API Calls
# REST API - List all articles
curl http://localhost:3000/api/v1/articles
# Get single article
curl http://localhost:3000/api/v1/articles/privacy-first-advertising
# MCP - Model Context Protocol
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{"tool":"get_article","parameters":{"slug":"privacy-first-advertising"}}'
# NLWeb Format
curl http://localhost:3000/nlweb/articles/privacy-first-advertising
# GraphQL Query
curl -X POST http://localhost:3000/graphql \
-H "Content-Type: application/json" \
-d '{"query":"{ articles(limit:5) { id title } }"}'
๐ Features
- AI-Ready: All articles include AI permission metadata
- Rate Limited: 100 requests per 15 minutes per IP
- Logged: All requests logged with user-agent and AI identifiers
- CORS Enabled: Cross-origin requests supported
- Performance: <200ms for API endpoints, <400ms for HTML