Premiers pas

Importer des prompts

Apportez une liste de prompts depuis un fichier CSV, avec une catégorie et une intention pour chacun. Cette page donne le format du fichier, ce qui arrive aux prompts que vous suivez déjà, et comment récupérer la liste.

Comment importer

Ouvrez la page Prompts du site et appuyez sur Importer.
Déposez un fichier sur la boîte de dialogue, ou cliquez sur parcourir. Les fichiers se terminant par .csv, .tsv ou .txt sont acceptés.
Vérifiez l’aperçu. Il montre les cinq premières lignes et une mention du type « 12 nouveaux · 3 déjà suivis ». Rien n’est stocké à ce stade.
Appuyez sur Importer.

Télécharger le modèle dans la boîte de dialogue vous donne un fichier avec le bon en-tête et deux lignes d’exemple.

Importer ne demande rien à aucun assistant et ne coûte rien. Les nouveaux prompts sont posés à la prochaine analyse que vous lancez.

Colonnes

Un fichier a jusqu’à trois colonnes. Seul le prompt est obligatoire.

Colonne	En-tête	Ce qu’elle contient
Prompt	`prompt`, `query`, `keyword`, `search term`, `question` ou `text`, entre autres	La question. Un texte de plus de 500 caractères est coupé à 500. Une ligne de moins de 3 caractères est ignorée.
Catégorie	`category`, `group` ou `tag`	Votre propre étiquette. Peut être vide. Plusieurs catégories vont dans la même cellule, voir ci-dessous.
Intention	`intent`	`informational`, `commercial`, `transactional` ou `navigational`. Vide ou toute autre valeur devient informational.

prompt,category,intent
"Which email marketing platform is best for a small online shop?",choosing a tool,commercial
"How do I improve the deliverability of my newsletters?",deliverability,informational
"What does email automation cost for 10,000 contacts?",pricing; choosing a tool,commercial

Les cellules peuvent être séparées par des virgules, des points-virgules ou des tabulations. Teddit le déduit du fichier, donc un CSV enregistré par Excel dans n’importe quelle région, ou un export séparé par des tabulations, fonctionne tel quel.
Mettez une cellule entre guillemets doubles quand elle contient le séparateur, le prompt avant tout. Sans les guillemets, le texte qui suit est lu comme la colonne suivante. Un guillemet double à l’intérieur d’une cellule entre guillemets s’écrit deux fois : "".
Un prompt par ligne. Une cellule entre guillemets peut s’étendre sur plusieurs lignes.
Le fichier peut être en UTF-8 ou dans les encodages plus anciens utilisés par Excel (comme Windows-1251 pour le cyrillique), ou en « Texte Unicode » d’Excel.
Les lignes vides sont ignorées, et les espaces autour d’une cellule sont retirés.
Deux autres mots d’intention sont compris, parce que les outils de mots-clés les utilisent : research est stocké comme commercial, et learn and solve comme informational.

Avec et sans ligne d’en-tête

La première ligne est lue comme un en-tête quand l’une de ses cellules nomme la colonne du prompt : prompt, query, keyword, question et noms similaires, en anglais, en ukrainien ou en russe. Majuscules et minuscules n’ont pas d’importance.

Avec un en-tête, les colonnes sont trouvées par leur nom : la colonne du prompt, puis les colonnes de catégorie et d’intention où qu’elles soient. L’ordre est libre, et toute autre colonne est ignorée. Un export d’un outil de mots-clés fonctionne généralement tel quel.
Sans en-tête, chaque ligne est un prompt et les colonnes sont lues par position : le prompt d’abord, la catégorie ensuite, l’intention en troisième, le même ordre qu’un export.

Sans en-tête, l’ordre est prompt, catégorie, intention, le même que le modèle et qu’un export. Avec tout autre ordre, gardez la ligne d’en-tête.

Un fichier avec une seule colonne et sans en-tête est simplement une liste de prompts, un par ligne. Mettez entre guillemets les prompts qui contiennent une virgule.

Plusieurs catégories pour un prompt

Écrivez les catégories dans une seule cellule, séparées par un point-virgule ou une barre verticale :

prompt,category
"What does email automation cost for 10,000 contacts?",pricing; choosing a tool
"Which tools send both email and SMS campaigns?",channels | choosing a tool

Dans un fichier séparé par des points-virgules, mettez une telle cellule entre guillemets doubles.
Un prompt peut avoir jusqu’à huit catégories. Celles au-delà de la huitième sont abandonnées.
Une catégorie répétée dans la cellule est gardée une fois. « Tarifs » et « tarifs » sont la même catégorie ; l’orthographe écrite en premier est conservée.
Une catégorie qui n’existe pas encore est créée par l’import.
La première catégorie de la cellule est celle selon laquelle la liste est triée.

Doublons et prompts que vous suivez déjà

Une ligne correspond à un prompt existant quand le texte est exactement le même, lettre pour lettre.

Ligne	Ce qui se passe
Nouveau texte	Un prompt est ajouté avec les catégories et l’intention de la ligne.
Texte déjà suivi sur ce site	Aucun second prompt n’est ajouté. Le prompt existant garde ses réponses, son historique, son intention et son statut. Si la ligne nomme des catégories, elles remplacent celles du prompt. Si la cellule de catégorie de la ligne est vide, les catégories du prompt restent telles quelles.
Le même texte deux fois dans un fichier	La première ligne ajoute le prompt. La seconde est traitée comme déjà suivie.
Plus de nouvelles lignes que la limite de prompts du site ne permet	Les lignes sont ajoutées jusqu’à ce que le site atteigne sa limite de prompts. Le reste est ignoré.

Les catégories sont remplacées, pas fusionnées. Une ligne qui nomme deux catégories laisse le prompt avec exactement ces deux-là, quoi qu’il ait eu avant. Pour laisser les catégories d’un prompt intactes, laissez la cellule vide.

L’aperçu compte ces cas avant que quoi que ce soit soit stocké : nouveaux, déjà suivis et ignorés.

Le statut des prompts importés

Les prompts importés avec la boîte de dialogue Importer sont actifs. Ils font partie de la prochaine analyse.

Les prompts importés via l’API REST ou l’outil MCP import_queries sont des brouillons, sauf si l’appel demande active. Un brouillon n’est pas analysé. Quand un site a des brouillons, la liste des Prompts montre un onglet Brouillons ; cochez-y les prompts et activez Actif pour les rendre actifs.

Chaque prompt importé se souvient du texte avec lequel il a été importé. Via l’API ou MCP, vous pouvez ensuite faire réécrire de courtes requêtes de recherche en questions complètes (rewrite_queries). La réécriture ne touche que les prompts importés dont le texte n’a pas été modifié depuis.

Export

Appuyez sur CSV sur la page Prompts. Choisissez tous les prompts ou une catégorie et téléchargez le fichier. Il s’appelle prompts-<domain>-<date>.csv et a une ligne par prompt.

Colonne	Contenu
`ID`	Le numéro du prompt, le même que celui utilisé par l’API et MCP.
`Prompt`	Le texte.
`Category`	Toutes les catégories du prompt, jointes par `;` .
`Cluster`, `Source`	D’où vient le prompt : `manual` pour les prompts saisis, `keyword` pour les importés.
`Intent`, `Funnel`, `Status`	Comment le prompt est classé, et s’il est actif, en pause ou en brouillon.
`ChatGPT`, `Claude`, `Perplexity`, `Gemini`, `AI Overviews`, `AI Mode`	Une colonne pour chaque assistant qui a répondu sur ce site. La valeur est le verdict de sa dernière réponse : `mentioned`, `cited` (lié mais pas cité), `not mentioned`, `failed` ou `not scanned`.
`Best rank`	Votre meilleure place parmi les marques citées, tous assistants confondus. Vide quand aucun assistant ne vous cite.
`Last scan`	La date de la dernière réponse au prompt.

Un fichier exporté peut être réimporté tel quel, dans le même site ou dans un autre. Les colonnes Prompt, Category et Intent sont trouvées par leur nom et les autres colonnes sont ignorées.

Les mêmes lignes sont disponibles en JSON depuis l’API (GET /api/projects/:id/prompts) et depuis l’outil MCP list_prompts. L’API accepte aussi les filtres de la liste sur l’adresse d’export ; voir Endpoints.

Précédent‹ Indicateurs et statuts SuivantAccès des robots IA ›