---
title: "CLI"
description: "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.

| Tarea en CLI | Comando | Guardar |
| -------- | ------------------------ | ------------ |
| Buscar tweets | `x-api-scraper search tweets` | cursor |
| Leer perfil | `x-api-scraper about` | `screen_name` |
| Listar seguidores | `x-api-scraper followers` | cursor |

## Instalación

```bash
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](https://github.com/twexapi-dev/x-api-scraper-cli)

## Autenticación

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

## Ejemplo básico

```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
```

## Flujo de trabajo: publicar un tweet con dry-run

Previsualiza acciones de escritura antes de enviarlas:

```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"
```

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

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

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

## Solicitudes API en bruto

Llama cualquier ruta de TwexAPI directamente:

```bash
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:

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

O instala desde ClawHub:

```bash
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](/sdks)
* [Autenticación](/authentication)
* [Servidor MCP](/mcp/overview)
* [Agent MCP Handoff](/mcp/agent-handoff)
* [Advanced Twitter Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)
* [Repositorio fuente](https://github.com/twexapi-dev/x-api-scraper-cli)