Libérez la recherche X/Twitter avec une CLI rapide

Lors de la création d’agents d’IA ou l’exécution d’investigations basées sur les données, vous avez besoin d’un moyen fiable d’extraire les conversations de X/Twitter. x‑research‑skill propose exactement cela — une interface en ligne de commande de bout en bout écrite en TypeScript qui se connecte directement à Claude Code ou à OpenClaw. Vous bénéficiez d’une navigation instantanée, économique et consciente des coûts des tweets, fils de discussion et activités des utilisateurs, tout en laissant votre agent concentré sur le raisonnement de haut niveau.

Pourquoi cela compte-t-il

• Barrières faibles — Pas d’interface graphique lourde ni de configuration serveur ; juste git clone, installer Bun, et authentifier.
• Transparence des coûts — Après chaque requête, la CLI affiche le coût exact de l’API X, vous permettant de rester dans votre budget.
• Économies basées sur le cache — Les requêtes répétées bénéficient d’un cache de 15 minutes (1 heure en mode rapide), éliminant les appels API en double.
• Mode rapide — Une seule page, vérification par impulsion de 10 résultats, réduisant les clics et crédits au minimum.
• Surveillance des listes de suivi — Suivez les conversations autour de n’importe quel ensemble de comptes, alertant automatiquement lorsqu’une nouvelle activité apparaît.

Commencer

Voici la feuille de route étape par étape, du clonage du dépôt à l’exécution de votre première recherche.

Prérequis

1. Obtenez un X Bearer Token depuis le Portail développeur X (un accès en lecture seule suffit).
2. Exportez-le dans votre shell export X_BEARER_TOKEN="your-token-here" ou ajoutez X_BEARER_TOKEN=your-token-here à ~/.config/env/global.env.
3. Installez Bun (l’environnement d’exécution JavaScript léger qui alimente la CLI).

Cloner dans votre espace de travail

# Pour Claude Code
mkdir -p .claude/skills && cd .claude/skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

# Pour OpenClaw
mkdir -p skills && cd skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

Exécuter une recherche d’exemple

cd skills/x-research
bun run x-search.ts search "OpenAI" --sort likes --limit 5

Le terminal affichera le texte du tweet, l’auteur, la date, les métriques d’engagement et finalement le coût de la requête (par ex. $0.50).

Fonctionnalités clés expliquées

Recherche et tri

Utilisez le langage naturel ou des indicateurs avancés :

bun run x-search.ts search "AI agents" --sort impressions --since 1d

Options incluent :

• --sort — likes, impressions, retweets, ou recent
• --since — 1h, 3h, 12h, 1d, 7d
• --min-likes, --min-impressions — filtrage après publication du faible engagement
• --quick — limite à 10 résultats, cache automatiquement retweets et réponses

Extraction de fil de discussion

bun run x-search.ts thread 

Renvoie le fil complet avec chaque message étiqueté et formaté pour markdown ou JSON.

Profil d’utilisateur et tweets récents

bun run x-search.ts profile @username

Affiche les derniers posts publics de l’utilisateur, tout en respectant les mêmes filtres.

Tableau de bord de la liste de suivi

bun run x-search.ts watchlist add alice "Crypto analyst"
bun run x-search.ts watchlist check

Conserve un watchlist.json localement ; check parcourt chaque handle et signale la nouvelle activité.

Gestion des coûts

Le modèle de paiement à l’usage de X s’applique à chaque appel API. Les tarifs par défaut (au février 2026) sont :

• Lecture d’un tweet : $0,005
• Recherche d’utilisateur : $0,010
• Page de recherche (100 tweets) : ~$0,50 (mode rapide), $1,50 pour 3 pages.
• Requêtes répétées en cache sont gratuites.
• La déduplication sur 24 heures protège contre la double facturation du même tweet.

La CLI affiche un résumé concis des coûts à chaque exécution, vous permettant de connaître exactement vos dépenses. Si vous dépassez un seuil, il suffit de recharger vos crédits prépayés depuis la console développeur.

Sécurité et gestion des tokens

Ne jamais exposer votre token dans les logs :

• Le script lit X_BEARER_TOKEN depuis l’environnement ou ~/.config/env/global.env.
• Ne pas inclure le token dans les lignes de commande ou les scripts accessibles par d’autres.
• Utiliser uniquement des tokens en lecture seule pour le moindre privilège.
• Rota le token immédiatement si vous suspectez une exposition.

Limitations et feuille de route future

• Seul le point de terminaison « recent » est utilisé ; la recherche d’archive complète est disponible mais n’est pas encore intégrée.
• Aucun droit d’écriture – l’outil est en lecture seule.
• Les futures versions visent à supporter les requêtes d’archive complète, un filtrage avancé et des visualisations graphiques optionnelles pour les structures de fils.

Réflexions finales

Que vous soyez un data‑scientist créant des chatbots d’IA, un chercheur agrémentant des insights de réseaux sociaux, ou un passionné automatisant l’ingestion de tweets, x‑research‑skill vous offre une interface puissante et sans friction vers l’API X. Sa mise en cache intégrée, ses rapports de coûts et son mode rapide maintiennent votre budget sous contrôle pendant que vous développez vos flux de recherche.

Clonez le dépôt, configurez votre token bearer, puis commencez à expérimenter. Bonnes recherches !