API-Dokumentation

Diese Seite beschreibt alle maschinenlesbaren Endpunkte von neurohackingly.com. Maschinenlesbare Fassung: OpenAPI 3.1 · API-Katalog (RFC 9727) · auth.md (keine Authentifizierung nötig)

Newsletter: POST /api/subscribe

Meldet eine E-Mail-Adresse zum Newsletter an (ConvertKit, Double-Opt-in). Formular-Felder (application/x-www-form-urlencoded oder multipart/form-data):

• email – Pflichtfeld
• name – optionaler Vorname
• source – optionale Quelle der Anmeldung
• website – Honeypot, muss leer bleiben

Mit Accept: application/json antwortet der Endpunkt immer mit HTTP 200 und einem JSON-Body; das Ergebnis steht im Feld status (success, already oder error). Ohne diesen Header antwortet er mit HTTP 303 auf /newsletter?status=…. Rate-Limit: 5 Anfragen pro Minute und IP.

curl -X POST https://www.neurohackingly.com/api/subscribe \
  -H "Accept: application/json" \
  --data-urlencode "email=du@example.com"

{"status":"success"}

MCP-Server: POST /mcp

Read-only Model Context Protocol-Server (Streamable HTTP, JSON-Response-Modus, keine Authentifizierung) unter https://www.neurohackingly.com/mcp. Tools:

• search_posts – Volltextsuche über alle Posts (Titel, Beschreibung, Tags, Inhalt)
• get_post – liefert einen Post als sauberes Markdown (identisch mit dem /{slug}.md-Mirror)

Discovery: MCP Server Card (SEP-1649)

curl -X POST https://www.neurohackingly.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Inhalte für Agenten und Feedreader

• GET /llms.txt – Index der Website im llms.txt-Format (Markdown-Linkliste aller Posts)
• GET /llms-full.txt – der komplette Inhalt aller Posts in einer Markdown-Datei
• GET /rss.xml – RSS-2.0-Feed
• GET /{slug}.md – Markdown-Mirror: jeder Post ist unter seiner URL plus .md als sauberes Markdown abrufbar; alle Mirror-Links stehen in /llms.txt
• Accept: text/markdown – die Startseite und jede Post-URL liefern mit diesem Request-Header direkt Markdown statt HTML (Content-Negotiation; Startseiten-Mirror: /index.md)

Alle Inhalts-Endpunkte sind statisch vorgerendert, brauchen keine Authentifizierung und dürfen laut robots.txt (inkl. Content-Signals) auch von KI-Crawlern gelesen werden.