export const metadata = {
  title: "Réservoir de mots-clés : Docs SEO Insight",
  description:
    "Interrogez le réservoir de mots-clés multi-source : volume, KD, CPC, tendances, intention et quick-wins GSC.",
};

# Réservoir de mots-clés

Le réservoir est un magasin unique et dédupliqué de chaque mot-clé issu de vos
sources. Chaque mot-clé conserve sa **source** et sa **date de mise à jour**, si
bien que les imports ne s'écrasent jamais silencieusement.

## Champs

Chaque mot-clé porte :

- `volume` : volume de recherche mensuel
- `kd` : difficulté du mot-clé (0 à 100)
- `cpc` : coût par clic
- `trend` : 12 mois d'historique de volume
- `intent` : informationnelle, commerciale, transactionnelle ou navigationnelle
- `position` : votre classement actuel, lorsque Search Console est connecté

## Lister les mots-clés

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

## Quick-wins

Les quick-wins sont les mots-clés classés en positions 11 à 20, tout proches de
la première page. Filtrez dessus pour prioriser le travail au meilleur retour
attendu :

```bash
curl "https://api.seoinsight.app/v1/keywords?quick_wins=true" \
  -H "Authorization: Bearer $SEO_INSIGHT_API_KEY"
```

Ce sont les mêmes données que le [serveur MCP](/docs/mcp) expose aux agents.