---
title: "CLI"
description: "Utilisez la CLI TwexAPI pour la recherche de tweets, l'export d'abonnés, les DM, les X Articles et l'automatisation terminal de l'API X."
---

Utilisez la CLI lorsque vous voulez des commandes terminal déterministes, une sortie JSON, des aperçus dry-run et des profils d'identifiants enregistrés pour les workflows REST TwexAPI sans écrire de code applicatif.

| Tâche CLI | Commande | Conserver |
| -------- | ------------------------ | ------------ |
| Rechercher des tweets | `x-api-scraper search tweets` | curseur |
| Lire un profil | `x-api-scraper about` | `screen_name` |
| Lister les abonnés | `x-api-scraper followers` | curseur |

## Installation

```bash
npm install -g @twexapi-dev/x-api-scraper-cli
x-api-scraper --help
```

Nécessite Node.js 18 ou plus récent.

Source : [twexapi-dev/x-api-scraper-cli](https://github.com/twexapi-dev/x-api-scraper-cli)

## Authentification

Obtenez votre clé API depuis le [tableau de bord TwexAPI](https://twexapi.io/dashboard).

```bash
export X_API_SCRAPER_KEY="YOUR_API_KEY"

x-api-scraper auth apps add --name prod --api-key "YOUR_API_KEY"
x-api-scraper auth apps use prod
x-api-scraper --app prod about elonmusk
```

## Exemple de base

```bash
# Lookup users
x-api-scraper --app prod users elonmusk sama

# Search tweets
x-api-scraper --app prod search tweets "founder" "ai" --sort Latest

# List followers (v3)
x-api-scraper --app prod followers elonmusk

# Global trending tweets
x-api-scraper --app prod trending tweets --country "United States" --topic "Sports" --count 50
```

## Workflow : publier un tweet avec dry-run

Prévisualisez les actions d'écriture avant l'envoi :

```bash
x-api-scraper --app prod --profile founder --dry-run tweet create --text "hello from cli"
x-api-scraper --app prod --profile founder tweet create --text "hello from cli"
x-api-scraper --app prod --profile founder tweet create --text "hello with image" --media-url "https://example.com/a.jpg"
```

Le téléversement de fichier local n'est pas pris en charge. Utilisez une `--media-url` publique.

## Workflow : envoyer un DM

```bash
x-api-scraper --app prod --profile founder --dry-run dm send elonmusk --text "hello from cli"
x-api-scraper --app prod --profile founder dm send elonmusk --text "hello from cli"
x-api-scraper --app prod --profile founder dm send elonmusk --text "see this" --media-url "https://example.com/a.jpg"
```

## Workflow : publier du Markdown comme X Article

```bash
x-api-scraper --app prod --profile founder --dry-run article publish-md ./article.md --title "Launch Notes"
x-api-scraper --app prod --profile founder article publish-md ./article.md --title "Launch Notes" --cover-image "https://example.com/cover.jpg" --visibility Public
```

## Requêtes API brutes

Appelez n'importe quel chemin TwexAPI directement :

```bash
x-api-scraper --app prod /twitter/elonmusk/about
x-api-scraper --app prod -X POST -d '["elonmusk","sama"]' /twitter/users
```

## Utiliser comme skill

Installez depuis un installateur de skill GitHub :

```bash
npx skills add twexapi-dev/x-api-scraper-cli
```

Ou installez depuis ClawHub :

```bash
npx clawhub@latest install x-api-scraper-cli
```

## Notes de sécurité

- La CLI lit `X_API_SCRAPER_KEY`, `X_API_SCRAPER_BASE_URL` et `X_API_SCRAPER_CONFIG_DIR` depuis l'environnement.
- Les configurations d'application et profils enregistrés sont stockés en JSON en clair dans `~/.x-api-scraper/config.json` par défaut.
- Utilisez `--dry-run` avant toute action d'écriture dans les workflows d'agents.

## Références

* [Vue d'ensemble des SDK](/sdks)
* [Authentification](/authentication)
* [Serveur MCP](/mcp/overview)
* [Transfert MCP pour agents](/mcp/agent-handoff)
* [Advanced Twitter Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)
* [Dépôt source](https://github.com/twexapi-dev/x-api-scraper-cli)