API & MCP — accès programmatique

Donne à un assistant IA (ou à tes scripts) un accès sans friction pour lire et publier des prompts sur Prompedia. La lecture est ouverte ; l'écriture demande une clé API personnelle.

1. Obtiens une clé API

Crée une clé depuis ta page Mon compte. Elle ne s'affiche qu'une fois — copie-la immédiatement. Publier nécessite aussi un pseudo et un e-mail vérifié. Toute écriture est attribuée à ton compte.

2. Branche un agent IA via MCP (recommandé)

Le serveur Model Context Protocol expose des outils prêts à l'emploi : search_prompts, get_prompt, list_categories, list_tags, whoami, create_prompt, update_prompt. Endpoint : https://xn--prompdia-f1a.com/api/mcp

Avec Claude Code :

claude mcp add --transport http prompedia https://xn--prompdia-f1a.com/api/mcp \
  --header "Authorization: Bearer ppd_TA_CLE"

Pour Claude Desktop / un autre client compatible, ajoute un serveur HTTP distant pointant sur la même URL avec le même en-tête Authorization. Sans clé, les outils de lecture fonctionnent quand même.

3. Ou utilise l'API REST

JSON, CORS activé, authentification par en-tête Authorization: Bearer ppd_…. Base : https://xn--prompdia-f1a.com/api/v1

GET/api/v1/prompts?query=&sort=recent&page=1Recherche/liste — public

GET/api/v1/prompts/{slug}Prompt complet (corps inclus) — public

GET/api/v1/prompts/{slug}?format=mdCorps brut en Markdown, prêt à coller — public

GET/api/v1/categoriesCatégories (id → categoryId) — public

GET/api/v1/tags?limit=50Tags populaires (slug) — public

GET/api/v1/meIdentité de la clé + droit de publier — clé requise

POST/api/v1/promptsPublier un prompt — clé requise

PATCH/api/v1/prompts/{slug}Éditer (partiel, auteur) — clé requise

Exemples :

# Chercher
curl "https://xn--prompdia-f1a.com/api/v1/prompts?query=traduction&sort=top"

# Lire le corps d'un prompt, prêt à coller dans un modèle
curl "https://xn--prompdia-f1a.com/api/v1/prompts/mon-prompt?format=md"

# Publier (clé requise)
curl -X POST "https://xn--prompdia-f1a.com/api/v1/prompts" \
  -H "Authorization: Bearer ppd_TA_CLE" \
  -H "Content-Type: application/json" \
  -d '{"title":"Résumé d'''article","body":"Tu es un assistant qui résume…","tags":["resume","ecriture"]}'

Contraintes & bonnes pratiques

Titre 3–140 caractères · corps 10–20 000 · résumé ≤200 · jusqu'à 8 tags en minuscules.
Licence par défaut : CC-BY-4.0. Publier exige un pseudo et un e-mail vérifié.
Limites de débit : lectures généreuses ; publications ~5/h, éditions ~20/h (par compte).
Pas de spam ni de doublons — respecte les règles de contribution.
Aperçu machine : /llms.txt