Documentation
littlebook calcule, pour une date de naissance, les cartes natales et la carte de chaque cycle (vie : 13 ans, sept ans : 1 an, période de 52 jours, jour), à n'importe quelle date entre la naissance et ses 120 ans. Les profils ne sont pas enregistrés : chaque appel les transmet.
Connecteur MCP (Claude, ChatGPT)
Adresse du connecteur : https://api.littlebook.cards/mcp
- claude.ai, ChatGPT : ajoutez un connecteur personnalisé avec cette adresse. L'application vous renvoie ici pour vous connecter et autoriser l'accès (OAuth).
- Claude Code, avec votre clé d'API :
claude mcp add --transport http littlebook https://api.littlebook.cards/mcp \ --header "Authorization: Bearer VOTRE_CLÉ"
Outils : get_profile, get_cycle_cards, get_timeline, find_card_dates, get_spread, get_card_in_tableau, compare_profiles. Donnez la date de naissance, et si possible l'heure et le fuseau : sans eux, les régentes peuvent être ambiguës.
API REST
Authentification : Authorization: Bearer VOTRE_CLÉ (clé sur votre compte). Les profils voyagent dans le corps JSON de requêtes POST, jamais dans l'URL.
curl -s https://api.littlebook.cards/v1/cycles -H "Authorization: Bearer VOTRE_CLÉ" \
-H "Content-Type: application/json" \
-d '{"profile": {"birthdate": "1990-05-17", "birthtime": "08:15", "tz": "Asia/Tokyo"}, "date": "2026-01-01"}'
| Appel | Rôle |
|---|---|
POST /v1/profile | cartes natales, régentes, suites |
POST /v1/cycles | carte de chaque cycle à une date |
POST /v1/timeline | cartes d'un cycle sur une période |
POST /v1/search/card-dates | quand une carte revient dans un cycle |
POST /v1/spreads/current | tableau d'un cycle à une date |
POST /v1/relation | cartes communes de deux profils |
GET /v1/spreads/{index}/cards/{card_id} | une carte dans un tableau : place, cartes environnement et déplacement |
GET /v1/spreads/{index}, GET /v1/cards | tableaux et cartes |
Référence complète : Swagger (OpenAPI). Les erreurs ont toutes la forme {"error", "message", "details"}. Limite : 10 requêtes par seconde par clé, rafales de 30.