/setup-x-api.es

description: "Lesson command"
duration: "~15 min"
prerequisites: ["Tener una cuenta de X", "Navegador disponible"]
level: "beginner"
tags: ["setup", "x", "twitter", "api"]
nonInteractiveMode: deferred

Configuración de X (Twitter) API

Step 0: Verificar progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-x-api` para mostrar el progreso 2. Detectar automáticamente la clave API existente:

• Ejecutar `uv run python tools/credential_manager.py status`
• Si X_BEARER_TOKEN ya está configurado, solo ejecutar Step 4 (prueba de API) y marcar como completado
• Si existe en texto plano en `.env`, sugerir migración al almacén de credenciales

**Mostrar advertencia importante al usuario:**

ADVERTENCIA: La API de X (Twitter) requiere un plan de pago

- Nivel gratuito: La API de Recent Search NO está disponible
- Plan Basic: Se requiere $100/mes
- Esta configuración es opcional. Puede omitirla si no va a usar el skill x-research

Las demás lecciones de la capacitación (creación de banners, generación de gráficos,
análisis de datos, etc.) funcionan perfectamente sin la API de X.

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Obtener un Bearer Token del X Developer Portal, guardarlo en el Credential Store y habilitar las funciones de búsqueda en tiempo real y análisis de tendencias de X | | Duración | ~15 minutos | | Requisitos previos | Tener una cuenta de X, navegador disponible | | Nivel de operación | Sin entrada de comandos CLI (todo lo ejecuta la IA automáticamente + solo operaciones GUI) | | Precio | **Se requiere plan Basic ($100/mes) o superior**. El nivel gratuito no admite la API de Recent Search | | Caso de uso | Búsqueda en tiempo real y análisis de tendencias de X (Twitter). Usado por el skill x-research |

**Flujo de la sesión:** 1. Abrir X Developer Portal en el navegador (la IA abre el navegador automáticamente) 2. Solicitar una cuenta de desarrollador, crear un proyecto y una app 3. Obtener el Bearer Token 4. Guardarlo de forma segura con credential_manager.py en un terminal separado 5. Prueba de operación (la IA la ejecuta automáticamente)

> **Consejo**: Si la IA deja de responder a mitad del proceso, escriba "por favor continúa" o "se detuvo" para reanudar.

---

Verificación de preparación

**Configuración de AskQuestion:**

{
  "title": "Confirmación previa a la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "La configuración de la API de X requiere el plan Basic ($100/mes). ¿Está listo?",
    "options": [
      {"id": "ready", "label": "Tengo un plan de pago / planeo suscribirme. Comencemos"},
      {"id": "chrome", "label": "Automatizar operaciones del navegador con /chrome"},
      {"id": "check_cost", "label": "Quiero saber más sobre los precios"},
      {"id": "skip", "label": "Omitir (no usaré la API de X)"},
      {"id": "different_lesson", "label": "Ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (chrome -> Después de abrir el navegador en Step 1, seguir la sección "Automatización con integración Chrome") (check_cost -> Indicar: "Precios de la API de X: El nivel gratuito es solo para publicar (sin API de búsqueda). El plan Basic ($100/mes) habilita la API de Recent Search. El plan Pro ($5,000/mes) habilita Full-Archive Search, pero Basic es suficiente para la capacitación. Si el costo no lo justifica, recomendamos omitirlo") (skip -> Indicar: "Configuración de la API de X omitida. Sin impacto en otras lecciones. Puede reiniciar con /setup-x-api más tarde" e ir a la finalización) (different_lesson -> Mostrar lista de módulos)

---

Step 1: Abrir X Developer Portal en el navegador

**Lo que hace la IA:** 1. Detectar automáticamente el sistema operativo (Mac / Windows / Linux) 2. Ejecutar el siguiente comando para abrir el navegador automáticamente:

# Mac:
open https://developer.x.com/en/portal/dashboard
# Windows:
start https://developer.x.com/en/portal/dashboard
# Linux:
xdg-open https://developer.x.com/en/portal/dashboard

**Una vez que se abra el navegador, mostrar el siguiente AskQuestion:**

{
  "title": "Step 1: Acceder al X Developer Portal",
  "questions": [{
    "id": "portal_status",
    "prompt": "¿Se abrió el navegador? Siga estos pasos para solicitar una cuenta de desarrollador:\n\n1. Inicie sesión con su cuenta de X\n2. Seleccione 'Sign up for Free Account' o 'Subscribe to Basic'\n   (Se requiere el plan Basic para usar la API de Recent Search)\n3. Complete el caso de uso (ej: 'Academic research and AI agent training')\n4. Acepte el acuerdo de desarrollador\n\n¿Apareció el panel del Developer Portal?",
    "options": [
      {"id": "dashboard_ready", "label": "¡El panel apareció!"},
      {"id": "browser_not_open", "label": "El navegador no se abrió"},
      {"id": "signup_issue", "label": "Tengo problemas con la solicitud de cuenta de desarrollador"},
      {"id": "already_have_account", "label": "Ya tengo una cuenta de desarrollador"}
    ]
  }]
}

(dashboard_ready -> Ir al Step 2) (browser_not_open -> Indicar: "Abra esta URL directamente en su navegador: https://developer.x.com/en/portal/dashboard") (signup_issue -> Indicar: "Las solicitudes del Developer Portal pueden requerir revisión. Complete el caso de uso de forma específica (ej: 'Building an AI-powered social media research tool for corporate training'). La revisión puede tomar algunos días. Vuelva a ejecutar esta configuración después de recibir el correo de aprobación") (already_have_account -> Ir al Step 2)

---

Automatización con integración Chrome (modo `/chrome`)

**Requisitos previos:** La extensión "Claude in Chrome" (v1.0.36+) está instalada en Chrome, y se inició con `claude --chrome` o se ejecutó `/chrome` dentro de la sesión.

**Lo que la IA ejecuta automáticamente con la integración Chrome:** 1. Abrir https://developer.x.com/en/portal/dashboard en el