X Tools for Claude MCP

Herramientas X para Claude MCP

Un conjunto de herramientas ligero y de código abierto que permite a Claude buscar en Twitter eficientemente con lenguaje natural y mostrar resultados según la intención del usuario. Diseñado tanto para la visualización de datos sin procesar como para el análisis opcional.

Características

• Búsqueda en lenguaje natural : Pídele a Claude que busque en Twitter en inglés sencillo
• Búsqueda de Twitter : busca tweets usando lenguaje natural o sintaxis avanzada de Twitter
• Formato profesional : visualización de tweets limpia y con formato Markdown
• Salida flexible : muestra tweets sin procesar o agrega análisis según lo que solicites
• Filtrado avanzado : encuentre tweets por palabras clave, usuarios, fechas, métricas de participación y más
• Soporte de paginación : recupera más de los 20 tweets predeterminados por búsqueda cuando sea necesario

Instalación

Prerrequisitos

• Node.js v16+
• Claude para escritorio
• Clave RapidAPI gratuita con acceso al punto final "The Old Bird API" (Twitter154)

Configuración de la clave RapidAPI

1. Visita la API de Old Bird en RapidAPI
2. Regístrese para obtener una cuenta RapidAPI si no tiene una
3. Suscríbete a la API (hay un nivel gratuito disponible)
4. Una vez suscrito, copie su clave RapidAPI desde su panel de control

Pasos de configuración

1. Clonar este repositorio :
   git clone https://github.com/0xGval/twitter-X-mcp-server cd twitter-X-mcp-tools
2. Instalar dependencias :
   npm install
3. Crea tu configuración :
   • Copie mcp.json.example a mcp.json en su directorio de Claude Desktop
   • Edite mcp.json para incluir su clave RapidAPI y las rutas de archivo correctas
   { "mcpServers": { "x-tools": { "command": "node", "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"], "env": { "RAPIDAPI_KEY": "your_rapidapi_key" } } } }
4. Configurar Claude para escritorio :
   • En Windows: Coloque su archivo mcp.json en %APPDATA%\Claude\
   • En macOS: Coloque su archivo mcp.json en ~/Library/Application Support/Claude/
   • Copie claude-rules.md y knowledge/TwitterSearchSyntaxGuide.txt en su directorio de la base de conocimientos de Claude
   • Reinicie Claude Desktop para que los cambios surtan efecto.

Herramientas disponibles

Búsqueda en Twitter

La herramienta está diseñada principalmente para usarse con lenguaje natural. Simplemente pídele a Claude que busque algo en Twitter y la herramienta interpretará tu solicitud.

Busca en Twitter usando lenguaje natural o sintaxis avanzada:

• query : consulta de búsqueda (admite los operadores de búsqueda avanzada de Twitter)
• section : resultados "más recientes" o "principales" (predeterminado: "más recientes")
• limit : Número de tweets a devolver (predeterminado: 20)

Ejemplos de lenguaje natural

Consulta simple

Pregúntale a Claude:

Consulta centrada en el usuario

Pregúntale a Claude:

Consulta natural compleja

Pregúntale a Claude:

Solicitud de análisis

Pregúntale a Claude:

Ejemplos de sintaxis directa

Para aquellos que prefieren la sintaxis directa:

Archivos necesarios

Esta herramienta incluye varios archivos importantes que deben configurarse correctamente:

• main.js : El archivo principal de la aplicación
• tools/twitter.js : La implementación de búsqueda de Twitter
• claude-rules.md : Instrucciones para que Claude muestre los resultados de búsqueda correctamente
• knowledge/TwitterSearchSyntaxGuide.txt : Guía de referencia para la sintaxis de búsqueda de Twitter

Asegúrese de que todos estos archivos estén ubicados en las ubicaciones correctas en su configuración de Claude.

Sintaxis de búsqueda

La herramienta admite todos los operadores de búsqueda estándar de Twitter, que Claude puede aplicar desde su lenguaje natural:

Usuarios

• from:username - Tweets enviados por una cuenta específica
• to:username - Responde a una cuenta específica
• @username - Tweets que mencionan la cuenta

Medios y enlaces

• filter:media - Tweets con cualquier medio
• filter:images - Tweets con imágenes
• filter:native_video - Tweets con vídeos
• filter:links - Tweets con enlaces

Fechas

• since:YYYY-MM-DD - Tweets posteriores a esta fecha
• until:YYYY-MM-DD - Tweets anteriores a esta fecha

Compromiso

• min_retweets:n - Tweets con al menos n retuits
• min_faves:n - Tweets con al menos n me gusta
• min_replies:n - Tweets con al menos n respuestas

Solución de problemas

Problemas comunes:

• Clave API no encontrada : asegúrese de que su clave RapidAPI esté configurada correctamente en mcp.json
• Errores de ruta : asegúrese de utilizar rutas absolutas completas con el escape adecuado en Windows ( \\ )
• Sin resultados : Verifique que su consulta de búsqueda sea válida y no demasiado restrictiva
• Problemas de comportamiento de Claude : asegúrese de tener la última versión de claude-rules.md que incluye las instrucciones de salida flexibles
• Archivos faltantes : Verifique que claude-rules.md y TwitterSearchSyntaxGuide.txt se hayan agregado correctamente a sus reglas y base de conocimientos de Claude

Desarrollo

Para modificar la herramienta:

1. Editar los archivos en el directorio tools/
2. Actualice el formato en la función formatTwitterResults() si es necesario
3. Reinicie Claude for Desktop para ver los cambios

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Expresiones de gratitud

• Protocolo de Contexto Modelo (MCP) de Anthropic
• API de Twitter154 de RapidAPI
• Axios
• Zod

Nota : Esta herramienta está diseñada para funcionar con el asistente de inteligencia artificial Claude y proporcionar resultados de búsqueda de Twitter con opciones de visualización flexibles según la intención del usuario.