CLI

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.

Installation

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

Authentification

Obtenez votre clé API depuis le tableau de bord TwexAPI.

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

# 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 :

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

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

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 :

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 :

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

Ou installez depuis ClawHub :

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
• Authentification
• Serveur MCP
• Transfert MCP pour agents
• Advanced Twitter Search
• Dépôt source