CLI

Usa la CLI de TwexAPI para búsqueda de tweets, exportación de seguidores, X Articles y automatización de la API de X desde la terminal.

Usa la CLI cuando quieras comandos de terminal deterministas, salida JSON, vistas previas con dry-run y perfiles de credenciales guardados para flujos REST de TwexAPI sin escribir código de aplicación.

Instalación

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

Requiere Node.js 18 o superior.

Fuente: twexapi-dev/x-api-scraper-cli

Autenticación

Obtén tu API key en el dashboard de 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

Ejemplo básico

# 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

Flujo de trabajo: publicar un tweet con dry-run

Previsualiza acciones de escritura antes de enviarlas:

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"

La carga de archivos locales no está soportada. Usa una --media-url pública.

Flujo de trabajo: enviar 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"

Flujo de trabajo: publicar Markdown como 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

Solicitudes API en bruto

Llama cualquier ruta de TwexAPI directamente:

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

Úsala como skill

Instala desde un instalador de skills de GitHub:

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

O instala desde ClawHub:

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

Notas de seguridad

• La CLI lee X_API_SCRAPER_KEY, X_API_SCRAPER_BASE_URL y X_API_SCRAPER_CONFIG_DIR desde el entorno.
• Las configuraciones de apps y perfiles guardados se almacenan como JSON sin cifrar en ~/.x-api-scraper/config.json por defecto.
• Usa --dry-run antes de cualquier acción de escritura en flujos de agentes.

Referencias

• Resumen de SDKs
• Autenticación
• Servidor MCP
• Agent MCP Handoff
• Advanced Twitter Search
• Repositorio fuente