agente-cliente-twitter-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con Twitter mediante el paquete agent-twitter-client , lo que permite que los modelos de IA interactúen con Twitter sin acceso directo a la API.

Características

• Opciones de autenticación :

  • Autenticación basada en cookies (recomendada)

  • Autenticación de nombre de usuario/contraseña

  • Credenciales de la API de Twitter v2

• Operaciones de Tweet :

  • Obtener tweets de los usuarios

  • Obtener tweets específicos por ID

  • Buscar tweets

  • Envía tweets con texto y multimedia

  • Crear encuestas

  • Dar me gusta, retuitear y citar tuits

• Operaciones de usuario :

  • Obtener perfiles de usuario

  • Seguir a los usuarios

  • Consigue seguidores y listas de seguidores

• Integración de Grok :

  • Chatea con Grok a través de la interfaz de Twitter

  • Continuar conversaciones con identificadores de conversación

  • Obtener resultados de búsqueda web y citas

  • Accede a los datos en tiempo real de Twitter a través de Grok

  • Nota : La funcionalidad de Grok requiere agent-twitter-client v0.0.19 o superior

Related MCP server: Twitter MCP Server

Documentación

• Guía para desarrolladores : guía completa para desarrolladores

• Guía de pruebas : instrucciones para probar el MCP

• Guía del agente : Guía para agentes de IA sobre cómo usar el MCP de Twitter

• Guía de contribución : Pautas para contribuir a este proyecto

• Registro de cambios : historial de cambios en este proyecto

• README de demostración : Guía para ejecutar los scripts de demostración

• Ejemplos de Grok : documentación para los ejemplos de integración de Grok AI

Inicio rápido

Instalación

Uso básico

1. Crea un archivo .env con tus credenciales de Twitter (ver Métodos de autenticación )

2. Ejecute el servidor MCP:

Scripts de demostración

El paquete incluye un directorio demo con scripts de ejemplo que demuestran varias funciones:

Consulte el archivo README de demostración para obtener más detalles.

Configuración del puerto

De forma predeterminada, el servidor MCP se ejecuta en el puerto 3000. Si necesita cambiar esto (por ejemplo, si ya tiene una aplicación ejecutándose en el puerto 3000), tiene varias opciones:

Opción 1: Uso de variables de entorno

Establezca la variable de entorno PORT :

Opción 2: Usar Docker Compose

Si usa Docker Compose, puede configurar los puertos del host y del contenedor en su archivo .env :

Luego ejecuta:

Esto asignará el puerto 3001 de su host al puerto 3000 del contenedor, lo que le permitirá acceder al MCP en http://localhost:3001 mientras su otra aplicación continúa usando el puerto 3000.

Configuración con Claude Desktop

1. Configure Claude Desktop para usar este MCP agregando a su archivo de configuración:

Windows : %APPDATA%\Claude\claude_desktop_config.json macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

2. Reiniciar Claude Desktop

Métodos de autenticación

Autenticación mediante cookies (recomendada)

Para obtener cookies:

1. Inicie sesión en Twitter en su navegador

2. Abrir herramientas para desarrolladores (F12)

3. Vaya a la pestaña Aplicación > Cookies

4. Copiar los valores de las cookies auth_token , ct0 y twid

5. Asegúrese de incluir la parte Domain=.twitter.com para cada cookie

Autenticación de nombre de usuario/contraseña

Autenticación de la API de Twitter

Herramientas disponibles

• get_user_tweets : recupera tweets de un usuario específico

• get_tweet_by_id : Obtener un tweet específico por ID

• search_tweets : Buscar tweets

• send_tweet : Publicar un nuevo tweet

• send_tweet_with_poll : Publica un tweet con una encuesta

• like_tweet : Me gusta un tweet

• retweet : retuitear un tuit

• quote_tweet : Citar un tweet

• get_user_profile : Obtener el perfil de un usuario

• follow_user : Seguir a un usuario

• get_followers : Obtener los seguidores de un usuario

• get_following : Obtener los usuarios que un usuario está siguiendo

• grok_chat : Chatea con Grok a través de Twitter

• health_check : Comprueba el estado del servidor MCP de Twitter

Interfaz de prueba

El MCP incluye una interfaz de línea de comandos interactiva para probar:

Esto inicia un REPL donde puedes probar varias funciones MCP:

Comandos de prueba de ejemplo

Ejemplo de uso

Pídele a Claude que:

• Busca tuits sobre IA en Twitter.

• Publica un tweet que diga '¡Hola de Claude!'

• Recibe los últimos tweets de @OpenAI

• Charla con Grok sobre computación cuántica

Uso avanzado

Trabajar con los medios de comunicación

Para publicar un tweet con una imagen:

Para publicar un tweet con un vídeo:

Creación de encuestas

Para crear una encuesta:

Interactuando con Grok

Para tener una conversación con Grok:

Para continuar una conversación con Grok:

Las capacidades únicas de Grok

Grok en Twitter tiene acceso a datos de Twitter en tiempo real que ni siquiera la API independiente de Grok tiene. Esto significa que puedes preguntarle a Grok sobre:

• Temas de tendencia actuales en Twitter

• Análisis de tuits recientes sobre temas específicos

• Información sobre los usuarios de Twitter y su contenido

• Eventos en tiempo real que se discuten en la plataforma

Consultas de ejemplo:

• "¿Cuáles son los temas de tendencia en Twitter en este momento?"

• Analizar el sentimiento en torno a la IA en Twitter.

• "¿Qué dice la gente sobre el último evento de Apple?"

• Muéstrame información sobre las memecoins populares que se están discutiendo hoy.

Requisitos de autenticación de Grok

La funcionalidad de Grok requiere una autenticación adecuada. El MCP admite dos métodos:

1. Autenticación de cookies (recomendado):

   • Las cookies deben estar en formato de matriz JSON

   • Ejemplo: TWITTER_COOKIES=["auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com", "ct0=YOUR_CT0_VALUE; Domain=.twitter.com", "twid=u%3DYOUR_USER_ID; Domain=.twitter.com"]

   • Las cookies esenciales son auth_token , ct0 y twid

2. Autenticación de nombre de usuario/contraseña :

   • Establezca TWITTER_USERNAME y TWITTER_PASSWORD en su entorno

   • Es posible que encuentre protección de Cloudflare en algunos casos

Límites de velocidad de Grok

Grok tiene límites de velocidad que pueden afectar el uso:

• Cuentas no premium: 25 mensajes cada 2 horas

• Cuentas Premium: Límites más altos

El MCP devolverá información sobre el límite de velocidad en la respuesta cuando se alcancen los límites.

Para obtener más detalles sobre el uso de Grok, consulte la documentación de Ejemplos de Grok .

Solución de problemas

Problemas de autenticación

Problemas de autenticación de cookies

Si tiene problemas con la autenticación de cookies:

1. Caducidad de las cookies : Las cookies de Twitter suelen caducar después de un tiempo determinado. Intenta actualizar tus cookies cerrando sesión y volviendo a iniciar sesión en Twitter.

2. Formato de las cookies : asegúrese de que sus cookies tengan el formato correcto como una matriz JSON de cadenas con el dominio correcto.

3. Cookies necesarias : asegúrese de haber incluido las cookies esenciales: auth_token , ct0 y twid .

Ejemplo de cookies con formato correcto:

Problemas de autenticación de credenciales

Si tiene problemas con la autenticación de nombre de usuario y contraseña:

1. Autenticación de dos factores : si su cuenta tiene habilitada la 2FA, deberá proporcionar TWITTER_2FA_SECRET .

2. Bloqueos de cuenta : Si intentas iniciar sesión repetidamente, tu cuenta podría bloquearse. Revisa tu correo electrónico para ver si hay solicitudes de verificación.

3. Desafíos de Captcha : Twitter puede presentar desafíos de captcha que el cliente no puede manejar automáticamente.

Problemas de autenticación de API

Para problemas de autenticación de API:

1. Permisos de clave API : asegúrese de que sus claves API tengan los permisos necesarios para las acciones que intenta realizar.

2. Limitación de velocidad : la API de Twitter tiene límites de velocidad que pueden provocar fallas si se exceden.

3. Cambios de API : Twitter ocasionalmente cambia su API, lo que puede causar problemas de compatibilidad.

Errores de operación

Errores en la publicación de tweets

Si no puedes publicar tweets:

1. Restricciones de contenido : Twitter puede bloquear tweets que violen sus políticas de contenido.

2. Problemas de formato de medios : asegúrese de que los medios estén correctamente formateados y codificados.

3. Limitación de velocidad : Twitter limita la frecuencia con la que puedes publicar.

Problemas de búsqueda

Si la búsqueda no funciona:

1. Sintaxis de consulta : asegúrese de que su consulta de búsqueda siga la sintaxis de búsqueda de Twitter.

2. Limitaciones de búsqueda : algunos modos de búsqueda pueden tener restricciones o requerir permisos específicos.

Problemas de Grok

Si la funcionalidad de Grok no funciona:

1. Requisitos de versión :

   • Grok requiere agent-twitter-client v0.0.19 o superior

   • El paquete actual utiliza v0.0.18 para la funcionalidad básica

   • Para los scripts de demostración, use el indicador --use-local-agent-twitter-client para instalar temporalmente la versión v0.0.19

2. Problemas de autenticación :

   • Formato de las cookies: asegúrese de que las cookies tengan el formato de matriz JSON correcto

   • Validez de las cookies: Las cookies de Twitter caducan después de un período determinado

   • Protección de Cloudflare: Cloudflare puede bloquear la autenticación de nombre de usuario y contraseña

   • Requisito Premium: El acceso a Grok requiere una suscripción a Twitter Premium

3. Límites de velocidad :

   • Cuentas no premium: 25 mensajes cada 2 horas

   • Mensaje de error: "Tarifa limitada: has alcanzado el límite..."

   • Solución: Espere hasta que se restablezca el límite de velocidad o actualice a una cuenta premium

4. Ubicación del archivo de entorno :

   • Para los scripts de demostración, asegúrese de que sus credenciales estén en demo/.env , no en el archivo raíz .env

   • Utilice el indicador --debug-env para comprobar qué variables de entorno se están cargando

Para obtener una solución detallada de problemas de Grok, consulte la documentación de Ejemplos de Grok .

Problemas con el servidor

Chequeo de salud

Utilice la herramienta health_check para diagnosticar problemas del servidor:

El control de salud informará sobre:

• Estado de autenticación

• Conectividad API

• Uso de memoria

Explotación florestal

El servidor registra tanto en la consola como en los archivos:

• error.log : contiene mensajes de nivel de error

• combined.log : contiene todos los mensajes de registro

Consulte estos registros para obtener información detallada sobre los errores.

Desarrollo

Prerrequisitos

• Node.js 18+

• npm

Configuración

1. Clonar el repositorio

2. Instalar dependencias

3. Cree un archivo .env con la configuración:

4. Construir el proyecto

5. Iniciar el servidor

Variables de entorno

Además de las variables de autenticación, puede configurar:

• LOG_LEVEL : establece el nivel de registro (error, advertencia, información, depuración)

• NODE_ENV : Establecer entorno (desarrollo, producción)

Estibador

También puedes ejecutar el servidor usando Docker:

Usando Docker directamente

Uso de Docker Compose

1. Crea un archivo .env con tus credenciales de Twitter

2. Ejecutar con docker-compose:

Variables de entorno en Docker

Puede pasar variables de entorno al contenedor Docker de varias maneras:

1. En el archivo docker-compose.yml (ya configurado)

2. A través de un archivo .env (recomendado para docker-compose)

3. Directamente en el comando docker run (como se muestra arriba)

Registros persistentes

La configuración de docker-compose incluye un montaje de volumen para registros:

Esto almacenará registros en un directorio de logs en la carpeta de su proyecto.

Consideraciones de seguridad

• Almacenamiento de credenciales : almacene las credenciales de forma segura, preferiblemente utilizando variables de entorno o una bóveda segura.

• Limitación de velocidad : implemente una limitación de velocidad para evitar el abuso de la API de Twitter.

• Validación de contenido : valide todo el contenido antes de publicarlo para evitar usos maliciosos.

Licencia

Instituto Tecnológico de Massachusetts (MIT)