# SYMONE — Documentation complète pour agents IA

> SYMONE est le premier service en Europe de transport de motos (avec ou sans pilote) sur autoroute longue distance. Les motards voyagent à bord d'un véhicule confortable pendant que leur moto est transportée sur remorque, juste derrière eux.

Site : [https://symone.fr](https://symone.fr)
Contact : [contact@symone.fr](mailto:contact@symone.fr)
Réservations : [reservation@symone.fr](mailto:reservation@symone.fr)

---

## Table des matières

1. [Présentation du service](#présentation)
2. [Formules et tarifs](#formules-et-tarifs)
3. [API — Recherche de trajets](#api)
4. [Authentification](#authentification)
5. [Exemples de requêtes](#exemples)
6. [Workflow agent recommandé](#workflow-agent)
7. [FAQ](#faq)
8. [Informations légales](#légal)

---

## Présentation

SYMONE transporte les motos (et leurs pilotes) sur autoroute en France via un système de remorque attelée à un véhicule léger. Le pilote voyage assis dans le véhicule confortable pendant que sa moto est sécurisée sur la remorque juste derrière.

**Avantages clés :**
- Zéro fatigue de conduite sur autoroute
- Arrivée reposée à destination
- Service unique en Europe
- Assurance incluse pendant le transport

**Cas d'usage typiques :**
- Trajet Paris–Marseille pour un week-end moto dans le Sud
- Envoi de moto seule pour rejoindre un rallye ou une course
- Déplacement professionnel avec sa moto sans conduire

---

## Formules et tarifs

### Formule 1 — Moto + Pilote

Le pilote monte à bord du véhicule SYMONE. Sa moto est chargée sur la remorque par un professionnel.

| Trajet | Prix à partir de |
|--------|-----------------|
| Paris ↔ Marseille | **299 €** |
| Autres destinations | Sur devis |

### Formule 2 — Moto seule

La moto voyage sans le pilote. Idéal pour rejoindre son véhicule à destination ou pour les compétitions.

| Trajet | Prix |
|--------|------|
| Toutes destinations | Sur devis |

**Tarifs complets :** [symone.fr/pricing.md](https://symone.fr/pricing.md)

**Ce qui est inclus dans tous les tarifs :**
- Chargement professionnel de la moto (~15 minutes)
- Transport sécurisé sur remorque
- Assurance du véhicule pendant le transport
- Prix TTC, sans supplément carburant

---

## API

L'API SYMONE expose des endpoints publics en lecture seule pour la recherche de trajets. Aucune clé API n'est requise pour ces endpoints.

**Base URL :** `https://symone.fr/api-proxy`

**Documentation API complète :** [symone.fr/api/index.md](https://symone.fr/api/index.md)

### Endpoints publics disponibles

#### GET /route/get/results

Retourne **tous** les trajets à venir. Pas de paramètres de filtrage — le filtrage par ville ou date se fait côté client sur le tableau retourné.

```
GET https://symone.fr/api-proxy/route/get/results
```

Pas de paramètres.

**Réponse :**
```json
[
  {
    "id": 42,
    "depart": "Paris",
    "arrival": "Marseille",
    "date_depart": "20260710",
    "time0": "06:00",
    "time4": "14:00",
    "price0_1": 299,
    "places_moto_1": 4,
    "places_passenger_1": 4,
    "completed": 0,
    "draft": 0
  }
]
```

**Champs de réponse :**
- `date_depart` : date au format `YYYYMMDD`
- `time0` / `time4` : heure de départ / arrivée
- `price0_1` : prix du segment principal (moto + pilote)
- `places_moto_1` : places moto restantes
- `places_passenger_1` : places passager restantes
- `completed` : `1` = complet, `0` = places disponibles
- `draft` : `1` = brouillon non publié (ignorer)

#### GET /route/paris-marseille-cache

Retourne les IDs des trajets Paris–Marseille disponibles depuis le cache. Réponse rapide, optimisée.

```
GET https://symone.fr/api-proxy/route/paris-marseille-cache
```

**Réponse :**
```json
[12, 15, 23, 42]
```

#### GET /route/cities-near

Retourne les villes SYMONE proches d'une localisation.

```
GET https://symone.fr/api-proxy/route/cities-near?location=Paris
```

**Paramètres :**

| Paramètre | Type | Exemple | Description |
|-----------|------|---------|-------------|
| `location` | string | `Paris` | Nom de la ville |

---

## Authentification

Les endpoints de recherche de trajets listés ci-dessus sont **publics et ne nécessitent aucune authentification**.

Les endpoints de réservation, paiement et gestion de compte sont réservés aux utilisateurs authentifiés via l'interface web [symone.fr/moto](https://symone.fr/moto). Il n'existe pas encore d'API publique authentifiée pour la création de commandes.

**Pour les intégrations nécessitant la réservation :** contacter [contact@symone.fr](mailto:contact@symone.fr).

---

## Exemples

### Exemple 1 — Récupérer tous les trajets disponibles

```bash
curl "https://symone.fr/api-proxy/route/get/results"
```

### Exemple 2 — Filtrer Paris → Marseille côté client (JavaScript)

```javascript
const response = await fetch('https://symone.fr/api-proxy/route/get/results');
const routes = await response.json();
const paris_marseille = routes.filter(
  r => r.type === 'route' && r.depart === 'Paris' && r.arrival === 'Marseille'
);
console.log(`${paris_marseille.length} trajet(s) Paris–Marseille disponible(s)`);
```

### Exemple 3 — Filtrer par date côté client (Python)

```python
import requests

routes = requests.get('https://symone.fr/api-proxy/route/get/results').json()
target_date = '20260710'
filtered = [r for r in routes if r.get('date') == target_date and r.get('type') == 'route']
print(f"{len(filtered)} trajet(s) le {target_date}")
```

### Exemple 4 — Villes proches de Lyon

```bash
curl "https://symone.fr/api-proxy/route/cities-near?location=Lyon"
```

### Exemple 5 — Trajets Paris–Marseille depuis le cache (rapide)

```bash
curl "https://symone.fr/api-proxy/route/paris-marseille-cache"
```

---

## Workflow agent

Voici le workflow recommandé pour un agent IA qui aide un utilisateur à réserver un transport moto :

### Étape 1 — Comprendre la demande

Identifier :
- Ville de départ et d'arrivée
- Date souhaitée (ou flexibilité)
- Formule souhaitée : Moto + Pilote ou Moto seule

### Étape 2 — Rechercher les trajets disponibles

Utiliser l'endpoint AI-optimisé (réponse compacte, filtrée côté serveur) :

```
GET https://symone.fr/api-proxy/route/ai/search?depart={depart}&arrival={arrival}&date_from={YYYY-MM-DD}&date_to={YYYY-MM-DD}
```

Tous les paramètres sont optionnels. Retourne `{ routes: [...], total: N, book_url: "https://symone.fr/moto" }`.

### Étape 3 — Présenter les options

Pour chaque trajet disponible, présenter :
- Date (`date`) et horaires (`times`)
- Prix minimum et maximum (`price_min`, `price_max` en €)
- Places restantes (`slots`)

### Étape 4 — Orienter vers la réservation

La réservation s'effectue sur [symone.fr/moto](https://symone.fr/moto).

Si l'utilisateur veut un devis personnalisé (destination hors ligne régulière) :
- Email : [reservation@symone.fr](mailto:reservation@symone.fr)
- Préciser : ville départ/arrivée, date, formule, marque/modèle moto

---

## FAQ

**Q : SYMONE transporte-t-il aussi les voitures ?**
Non. SYMONE est exclusivement dédié au transport de motos.

**Q : La moto doit-elle être en état de marche ?**
Oui, la moto doit pouvoir être conduite jusqu'au point de chargement.

**Q : Combien de temps dure le chargement ?**
Environ 15 minutes pour l'ensemble des véhicules. Le chargement est effectué par un professionnel.

**Q : Y a-t-il une assurance ?**
Oui, la moto est assurée pendant le transport.

**Q : Quelles destinations sont disponibles ?**
La ligne régulière est Paris ↔ Marseille. D'autres destinations sont disponibles sur devis (Lyon, Nice, Bordeaux, Lille, etc.).

**Q : Peut-on annuler une réservation ?**
Oui, selon les conditions définies dans les [CGV](https://symone.fr/condition).

---

## Légal

- Raison sociale : SYMONE SAS
- Capital social : 61 208 €
- Siège social : 75B avenue du Drapeau, 21000 Dijon, France
- RCS Dijon : 893 594 465
- Activité : Transport routier occasionnel de voyageurs et de marchandises (motos)
- Email : [contact@symone.fr](mailto:contact@symone.fr)
- Conditions Générales de Vente : [symone.fr/condition](https://symone.fr/condition)
- Politique de confidentialité : [symone.fr/privacy](https://symone.fr/privacy)

---

## Ressources

- [llms.txt](https://symone.fr/llms.txt) — Résumé court pour agents IA
- [llms-full.txt](https://symone.fr/llms-full.txt) — Ce document
- [pricing.md](https://symone.fr/pricing.md) — Tarifs détaillés
- [api/index.md](https://symone.fr/api/index.md) — Documentation API
- [sitemap.xml](https://symone.fr/sitemap.xml) — Plan du site

## Outils IA disponibles

- **ChatGPT GPT** : [chatgpt.com/g/g-6a3141635fa4819181deef9a39b931be-symone-moto](https://chatgpt.com/g/g-6a3141635fa4819181deef9a39b931be-symone-moto)
- **OpenAPI spec** : [symone.fr/openapi.json](https://symone.fr/openapi.json)
- **MCP server (npm)** : `npx @rosentte104/symone-mcp`
- **npm SDK** : [npmjs.com/package/symone-sdk](https://www.npmjs.com/package/symone-sdk)
- **Agent card (A2A)** : [symone.fr/.well-known/agent-card.json](https://symone.fr/.well-known/agent-card.json)
- **MCP manifest** : [symone.fr/.well-known/mcp/manifest.json](https://symone.fr/.well-known/mcp/manifest.json)