Aller au contenu principal

CLI CiteMe

Développeurs

citeme est la ligne de commande de CiteMe, publiée sous @citeme-io/cli. Elle analyse le code d'un dépôt, applique les suggestions techniques approuvées, génère un llms.txt et fait tourner votre machine comme agent des Actions. Elle demande Node.js 18 ou plus récent et un forfait payant (voir Forfaits).

npm install -g @citeme-io/cli
citeme login

Se connecter​

citeme login ouvre votre navigateur sur CiteMe, puis enregistre une clé sur votre machine. citeme login --no-browser demande l'email et le mot de passe dans le terminal. La connexion expire au bout de 5 minutes si vous ne la terminez pas.

  • La clé expire au bout de 90 jours : relancez citeme login.
  • Chaque citeme login crée sa propre clé. Se reconnecter, sur ce poste ou sur un autre, ne révoque aucune clé existante, ni celle de votre CI ni celle de l'extension Chrome. Les clés en cours sont listées, et se révoquent, dans Réglages → Outils développeur, section Outils connectés.
  • Les droits suivent votre rôle dans l'organisation : un Lecteur lit, les commandes qui modifient quelque chose sont refusées. Une personne invitée sur une seule marque, sans siège dans l'organisation, ne peut pas se connecter.
  • citeme config affiche l'emplacement du fichier de configuration, citeme whoami et citeme status l'état de la connexion, citeme logout supprime la clé.
  • Pour un CI ou un agent sans navigateur, exportez la clé dans CITEME_API_KEY. CITEME_API_URL change l'URL de l'API et CITEME_PROJECT_ID la marque par défaut.
Ce n'est pas une clé API cm_

La clé de citeme login ne fonctionne que sur /api/v1/cli/* et sur le serveur MCP hébergé. Elle est refusée par /api/v1/projects/*, qui exige une clé cm_ du dashboard. Voir Authentification. Pour piloter CiteMe depuis un agent, citeme login suffit : ne cherchez pas de clé API.


Dans un CI​

Lancez citeme login une fois sur votre poste, puis copiez apiKey depuis le fichier affiché par citeme config dans un secret du dépôt, par exemple CITEME_API_KEY. Cette clé reste valide 90 jours, même si vous vous reconnectez ensuite : chaque citeme login crée une nouvelle clé sans toucher aux précédentes. Révoquez-la dans Outils connectés quand le CI n'en a plus besoin, puis remplacez le secret.

L'action GitHub prête à l'emploi analyse le code à chaque pull request :

- uses: CiteMe/cli-citeme/actions/geo-audit@cli-v0.7.0
with:
api-key: ${{ secrets.CITEME_API_KEY }}
threshold: 60

Elle échoue sous threshold et expose code-score (le score de l'analyse du code, pas le score GEO du dashboard ; score reste un alias déprécié), technical-score, issues et passed. Elle ne lance un audit GEO qu'avec run-geo-audit: true et project, car chaque audit consomme votre quota. Une clé cm_ est refusée.

Sans l'action, citeme audit --json --threshold 60 avec CITEME_API_KEY dans l'environnement fait la même chose. Les codes de sortie sont dans la référence des commandes.


Ce que la CLI sait faire, et ce qu'elle ne sait pas faire​

Elle couvre le code, les suggestions et les Actions. Elle ne couvre pas encore le côté GEO de la plateforme : pas de commande pour créer ou lister des prompts et des thèmes, choisir les questions d'un audit, suivre son avancement ou lire ses résultats (réponses par question, citations, concurrents). C'est suivi dans cli-citeme#57.

citeme audit est une analyse du code du dépôt courant, pas l'audit GEO du dashboard. Quand une marque est sélectionnée, elle met aussi en file un audit GEO du site en ligne (sur les prompts actifs de la marque), et --wait attend son score. C'est tout : pour le détail des réponses, utilisez le MCP ou l'API.

Pour créer des prompts, lancer un audit et lire ses réponses depuis un agent, utilisez le serveur MCP hébergé : la recette est dans Piloter CiteMe depuis un agent IA.


Paquet MCP local​

@citeme-io/mcp est un serveur MCP qui tourne sur votre machine en stdio, pour les clients qui ne savent lancer qu'un processus local (Claude Desktop, Cursor, Claude Code). Il réutilise la connexion de citeme login.

npm install -g @citeme-io/cli @citeme-io/mcp
claude mcp add citeme -- npx -y @citeme-io/mcp

Une fois connecté, il reprend les 47 outils du serveur hébergé, sous les mêmes noms et avec les mêmes arguments, audits compris (run_audit, get_audit, list_audits), ainsi que ses quatre prompts prêts à l'emploi (why_am_i_losing, what_should_i_fix_first, am_i_improving, who_is_reading_my_site). Il y ajoute quatre outils à lui, qui appellent /api/v1/cli/* : get_project, list_workflows, run_workflow et get_workflow_run. Aucun de ces outils locaux ne masque un outil hébergé. Voir Connecter votre assistant.

run_workflow et la commande citeme agent peuvent modifier des fichiers et ouvrir des pull requests sur la machine qui exécute l'agent : n'y branchez que des workflows que vous avez relus.


Référence des commandes →