Tutoriel clix : démarrage rapide pour utiliser X/Twitter depuis le terminal

Si tu veux lire X/Twitter depuis le terminal sans passer par l’API officielle, clix est probablement l’un des outils les plus intéressants du moment.

Le repo officiel : https://github.com/spideystreet/clix

Dans ce tutoriel, on va faire simple :

• installer clix
• vérifier qu’il marche
• se connecter
• lancer les premières commandes utiles
• éviter les pièges classiques

Ce qu’il faut comprendre avant de commencer

clix ne repose pas sur l’API officielle X.

À la place, il s’appuie sur :

• les cookies de ton navigateur
• ou des tokens déjà présents/configurés

La conséquence est simple :

la meilleure machine pour utiliser clix, c’est généralement ton ordinateur personnel, pas un VPS sorti de nulle part.

Pourquoi ? Parce que sur ton laptop :

• tu es déjà connecté à X
• ton navigateur est déjà reconnu
• l’extraction des cookies a plus de chances de marcher
• X a moins de raisons de paniquer

Installation

La doc du projet propose :

uv pip install clix0

Si tu préfères un environnement isolé, tu peux aussi passer par un venv Python.

Exemple :

python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install clix0

Vérifier que le CLI répond

Commence par :

clix --help

Puis lance un diagnostic :

clix doctor

Et vérifie le statut de l’auth :

clix auth status

Si tu vois Not authenticated, c’est normal tant que tu n’as pas connecté de session X exploitable.

Se connecter

La commande de base est :

clix auth login

clix va essayer d’extraire les cookies depuis un navigateur compatible.

Si ça marche

Parfait. Tu peux passer à la suite.

Si ça échoue

Le message classique ressemble à ça :

• Could not extract cookies
• ou une erreur de login côté X

Dans ce cas, vérifie dans cet ordre :

1. tu es bien connecté à X dans ton navigateur local
2. tu n’es pas dans une session trop exotique (VPS, remote desktop bizarre, navigateur jetable)
3. tu utilises un navigateur supporté
4. tu n’essaies pas de faire ça depuis une IP ou une machine que X trouve suspecte

Si tu testes depuis un VPS, ne sois pas surpris si X te fait perdre ton temps.

Premières commandes utiles

Voir le feed

clix feed --type for-you --count 20

Ou pour un rendu plus propre côté script :

clix feed --type following --count 20 --json

Chercher des tweets

clix search "openclaw" --type latest --json

Types utiles :

• top
• latest
• photos
• videos

Voir un profil

clix user thomasgermain93 --json

Voir un tweet précis

clix tweet 1900000000000000000 --json

Récupérer ses bookmarks

clix bookmarks --json

Voir les tendances

clix trending --json

Sorties utiles pour les scripts et agents

Un des gros intérêts de clix, c’est qu’il ne pense pas seulement aux humains.

Tu peux choisir des formats adaptés à l’automatisation :

JSON

clix search "llm" --type latest --json

YAML

clix feed --yaml

Format compact

clix feed --compact

Texte complet

clix tweet 1900000000000000000 --full-text

Télécharger des médias

clix download <tweet-id> --output-dir /tmp/clix-media

Pratique si tu veux récupérer une vidéo, une image ou archiver des assets liés à un thread.

Listes et dossiers de bookmarks

Lister les listes

clix lists --json

Voir une liste

clix lists view <id> --json

Voir les dossiers de bookmarks

clix bookmarks-folders --json

Voir le contenu d’un dossier

clix bookmarks-folder <id> --json

MCP : brancher clix à un agent

clix expose aussi un serveur MCP :

clix mcp

C’est utile si tu veux brancher l’outil à un client compatible MCP.

Mais pour commencer, reste simple : utilise d’abord le CLI direct, vérifie que l’auth marche, puis seulement ensuite pense à l’intégration agentique.

Les commandes d’écriture : prudence

clix sait aussi faire des actions comme :

• poster
• liker
• retweeter
• suivre
• envoyer des DMs
• supprimer un tweet

Exemples :

clix post "hello world"
clix like <tweet-id>
clix retweet <tweet-id>
clix dm send <handle> "message"
clix delete <tweet-id>

Oui, c’est puissant.

Mais non, je ne te conseille pas de brancher ça à un agent en roue libre.

Le bon réflexe :

• commencer par les commandes de lecture
• réserver les commandes d’écriture aux actions validées explicitement

Les pièges les plus fréquents

1. Tester depuis un VPS

Mauvaise idée pour démarrer.

Tu risques de te prendre :

• des problèmes de cookies
• une session navigateur pas propre
• des refus de X
• une extraction d’auth qui ne marche pas

2. Croire que “sans API” veut dire “sans fragilité”

Ce n’est pas parce que tu évites l’API officielle que tout devient magique.

Tu échanges juste une dépendance API contre une dépendance navigateur/session/cookies.

3. Oublier les formats de sortie

Si tu veux automatiser un truc, utilise --json ou --compact. Sinon tu vas parser du texte humain moche pour rien.

Workflow recommandé pour démarrer

Si je voulais tester clix proprement aujourd’hui, je ferais exactement ça :

1. installer clix0 sur mon laptop
2. vérifier clix --help
3. lancer clix doctor
4. faire clix auth login
5. tester clix auth status
6. lancer une recherche simple avec clix search "openclaw" --type latest --json
7. tester le feed et les bookmarks
8. seulement après envisager un usage avec agent ou MCP

Mon conseil final

clix est un outil franchement malin, surtout pour :

• la veille
• la recherche
• l’exploration de X depuis le terminal
• les agents qui ont besoin de lire des signaux sociaux

Mais si tu veux éviter de te faire mal dès le début :

teste-le d’abord sur ta machine perso, pas sur un VPS.

Tu économiseras du temps, de la frustration, et probablement quelques insultes gratuites envers X.

Sources

• Repo GitHub : https://github.com/spideystreet/clix
• PyPI : https://pypi.org/project/clix0/