wshobson/hermes-tweet

Hermes Tweet

Hermes Tweet añade un conjunto de herramientas de X/Twitter a Hermes Agent. Es útil para escucha social, investigación de cuentas, monitoreo de lanzamientos, triaje de soporte, auditorías de sorteos y flujos de trabajo controlados donde las operaciones privadas o de cambio de estado permanecen explícitas.

Cuándo Usar Esta Skill

Usa esta skill cuando el usuario quiera:

• Instalar Hermes Tweet en un runtime de Hermes Agent
• Descubrir las rutas de lectura y acción de X/Twitter disponibles
• Leer datos de cuentas, tweets, tendencias, monitores o búsquedas de X/Twitter
• Resumir señales públicas antes de redactar respuestas o campañas
• Mantener las operaciones privadas y de cambio de estado controladas por la intención explícita del operador

Configuración

Instala y habilita el plugin a través de Hermes:

hermes plugins install Xquik-dev/hermes-tweet --enable

Hermes escanea los plugins durante la instalación y las actualizaciones. Revisa cada advertencia. Un veredicto peligroso bloquea la instalación o deshabilita una actualización.

Establece la clave de API en el host del runtime de Hermes:

export XQUIK_API_KEY="<tu-clave>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Mantén HERMES_TWEET_ENABLE_ACTIONS en false para sesiones de solo lectura. Establécelo en true solo para una operación aprobada de lectura privada, escritura, monitoreo, webhook, extracción, dibujo o medios.

Entradas

Solicita estas entradas antes de seleccionar rutas:

• Objetivo: investigación, monitoreo, triaje de soporte, auditoría de sorteos o preparación de acciones
• Objetivo: handle de cuenta, URL de tweet, palabra clave, lista, monitor o tendencia
• Ventana de tiempo y necesidades de actualidad
• Si alguna operación privada o de cambio de estado está en el alcance
• Confirmación de que el runtime de Hermes tiene XQUIK_API_KEY

Flujo de Trabajo

1. Busca en el catálogo de endpoints incluido con tweet_explore para encontrar rutas que coincidan.
2. Lee datos públicos de X/Twitter a través de tweet_read después de seleccionar una ruta del catálogo.
3. Usa tweet_action para rutas privadas o de cambio de estado solo después de aprobación explícita.
4. Mantén las claves de API en variables de entorno o en el archivo de entorno del runtime de Hermes.
5. No pegues credenciales en prompts, issues, comentarios de PR o entradas de herramientas.
6. Carga patrones de flujo de trabajo cuando el usuario solicite un flujo de trabajo de campaña, monitoreo, soporte o sorteo en lugar de una lectura única.

Modelo de Herramientas

Herramienta	Propósito
tweet_explore	Buscar en el catálogo de endpoints incluido sin usar la clave de API.
tweet_read	Llamar a endpoints públicos de solo lectura listados en el catálogo cuando XQUIK_API_KEY está configurada.
tweet_action	Llamar a operaciones privadas de lectura, escritura, monitoreo, webhook, extracción, dibujo y medios solo cuando el control de acciones está habilitado.

Formato de Salida

Devuelve una salida operativa concisa:

Resumen:
- Qué se verificó y por qué

Rutas de lectura:
- Ruta del catálogo, entrada y resumen del resultado

Plan de acción:
- Operaciones privadas o de cambio de estado propuestas, cada una esperando aprobación explícita

Próxima verificación:
- Ruta de seguimiento o cadencia de monitoreo cuando sea útil

Ejemplos de Uso

Investigar una cuenta antes de redactar una respuesta:

Usa Hermes Tweet para inspeccionar el contexto público reciente de @example antes de redactar una respuesta. Mantén las acciones deshabilitadas.

Monitorear una palabra clave de lanzamiento:

Rastrea las menciones de X/Twitter para "Example Launch" hoy. Resume temas y cuentas notables. No publiques.

Preparar una publicación controlada:

Redacta un tweet de lanzamiento y lista la llamada exacta a tweet_action que usarías. Espera aprobación antes de cualquier ruta de acción.

Capturar notas de ruta estructuradas:

{
  "objective": "support-triage",
  "route": "/api/v1/x/search",
  "action_gate": "disabled",
  "approval_required": true
}

Solución de Problemas

• Si solo aparece tweet_explore, configura XQUIK_API_KEY en el host del runtime de Hermes y recarga o reinicia la sesión activa de Hermes.
• Si las rutas de acción no están disponibles, mantén las lecturas públicas separadas. Establece HERMES_TWEET_ENABLE_ACTIONS=true solo para una operación privada o de cambio de estado aprobada.
• Si una ruta no coincide, usa tweet_explore nuevamente y elige una ruta listada en el catálogo en lugar de adivinar endpoints.

Mejores Prácticas

• Trata Hermes Tweet como la capa nativa de X/Twitter para Hermes, no como un envoltorio genérico de API.
• Mantén la investigación como solo lectura por defecto. Requiere aprobación antes de crear o cambiar monitores.
• Usa revisión por parte del operador de escritorio o gateway antes de llamadas privadas o de cambio de estado.
• Valida la ruta exacta del catálogo antes de llamar a tweet_read o tweet_action.
• Reinicia las sesiones de gateway, cron o de larga duración de Hermes después de cambios en el entorno.

Ver También

El plugin de publicación social complementa a Hermes Tweet para publicación multiplataforma amplia. Hermes Tweet se centra en el conjunto de herramientas de X/Twitter de Hermes Agent y su modelo operativo de solo lectura con control de aprobación.

Consulta el contrato de endpoint y aprobación cuando un límite de ruta no esté claro. Consulta la guía oficial en https://github.com/Xquik-dev/hermes-tweet#readme.