API & CLI

Öffentliche Lese-API (v1): alle öffentlichen Prompts, Versionen, Tags und Profile als JSON. Kein API-Key nötig, CORS erlaubt, Limit 120 Anfragen/Minute.

CLI

Der schnellste Weg, einen Prompt in dein Projekt zu holen:

Empfohlen – mit Integritätsprüfung (SHA-256):

curl -fsSLO https://promthub.org/cli/releases/v1.0.0/prompthub
curl -fsSLO https://promthub.org/cli/releases/v1.0.0/prompthub.sha256
sha256sum -c prompthub.sha256
install -m 0755 prompthub /usr/local/bin/prompthub

Kurzform ohne Prüfung (nur für schnelles Ausprobieren):

curl -fsSL https://promthub.org/cli/prompthub -o /usr/local/bin/prompthub
chmod +x /usr/local/bin/prompthub

prompthub pull alice/email-summarizer          # → PROMPT.md
prompthub cat alice/email-summarizer           # → stdout
prompthub pull alice/email-summarizer --version 1.0.0 -o prompts/summarizer.md
prompthub search "code review"
prompthub versions alice/email-summarizer

Benötigt nur curl (für search/versions zusätzlich python3).

Endpunkte

GET /api/v1/repos                     Liste; Parameter: page, sort=top|trending|new, q, tag
GET /api/v1/repos/{owner}/{name}               Detail inkl. Inhalt, Variablen, Parametern
GET /api/v1/repos/{owner}/{name}/versions      Versionsliste
GET /api/v1/repos/{owner}/{name}/versions/{v}  Inhalt einer Version
GET /api/v1/repos/{owner}/{name}/raw           text/plain, optional ?version=x.y.z
GET /api/v1/tags                               Alle Tags mit Zählern
GET /api/v1/users/{handle}                     Profil inkl. Repo-Liste

Beispiel

curl -s https://promthub.org/api/v1/repos?q=email | python3 -m json.tool

curl -s https://promthub.org/api/v1/repos/alice/email-summarizer/raw

Antwortformat: Listen kommen als {"data": […], "meta": {"page", "pages", "total"}}, Einzelobjekte als {"data": {…}}, Fehler als {"error": {"code", "message"}}.

Schreib-API (Tokens)

Mit einem persönlichen Token (unter Konto-Einstellungen) lassen sich neue Versionen per API veröffentlichen – z. B. aus CI-Pipelines:

curl -X POST https://promthub.org/api/v1/repos/DEIN-HANDLE/DEIN-REPO/versions \
  -H "Authorization: Bearer ph_…" -H "Content-Type: application/json" \
  -d '{"content": "…", "changelog": "Feinschliff", "bump": "patch"}'

Oder per CLI: PROMPTHUB_TOKEN=ph_… prompthub push owner/repo prompt.txt "Feinschliff" patch

MCP

PromptHub ist auch ein MCP-Server (Streamable HTTP): Claude Code, Claude Desktop und andere MCP-Clients können Prompts direkt suchen und abrufen.

claude mcp add --transport http prompthub https://promthub.org/mcp

Werkzeuge: search_prompts, get_prompt, list_versions, list_tags – nur Lesezugriffe auf öffentliche Daten, kein API-Key nötig.

Fair Use

Die API liefert ausschließlich öffentliche Daten. Bitte einen sprechenden User-Agent senden und Antworten cachen (Cache-Control wird gesetzt). Schreibzugriffe folgen in einer späteren Version mit API-Tokens.