export const metadata = {
  title: "Démarrage rapide : Docs SEO Insight",
  description:
    "Créez un espace de travail, générez une clé API et envoyez votre première requête authentifiée à l'API SEO Insight.",
};

# Démarrage rapide

Ce guide vous mène d'un nouveau compte à votre première requête API
authentifiée en quelques minutes.

## 1. Créer un espace de travail

Inscrivez-vous et créez un espace de travail pour chaque site (ou client) que
vous gérez. Un espace de travail possède son propre réservoir de mots-clés, son
profil de backlinks et son pipeline de contenu, ainsi que les sièges et
intégrations qui lui sont rattachés.

## 2. Générer une clé API

Dans **Réglages → Clés API**, créez une clé. Traitez-la comme un mot de passe :
elle donne un accès complet à l'espace de travail. Stockez-la dans une variable
d'environnement, jamais dans le code source.

```bash
export SEO_INSIGHT_API_KEY="sk_live_xxxxxxxxxxxxxxxx"
```

## 3. Envoyer votre première requête

Chaque endpoint vit sous `https://api.seoinsight.app/v1`. Authentifiez-vous
avec un token Bearer. Voici une requête sur le réservoir de mots-clés de
l'espace de travail courant :

```bash
curl https://api.seoinsight.app/v1/keywords \
  -H "Authorization: Bearer $SEO_INSIGHT_API_KEY" \
  -G -d "limit=3"
```

Une réponse réussie renvoie du JSON :

```json
{
  "data": [
    { "keyword": "seo mcp tool", "volume": 880, "kd": 34, "cpc": 3.1, "position": 12 },
    { "keyword": "seo mcp server", "volume": 320, "kd": 28, "cpc": 2.4, "position": 14 }
  ],
  "has_more": true
}
```

## 4. Essayer depuis le code

Le même appel depuis un service TypeScript :

```ts
const res = await fetch("https://api.seoinsight.app/v1/keywords?limit=3", {
  headers: { Authorization: `Bearer ${process.env.SEO_INSIGHT_API_KEY}` },
});

const { data } = await res.json();
console.log(data);
```

## Étapes suivantes

- Connectez un agent dans [MCP & agents IA](/docs/mcp).
- Comprenez le modèle d'authentification dans [Authentification](/docs/authentication).
- Explorez le [Réservoir de mots-clés](/docs/keywords).