wshobson/hermes-tweet

Hermes Tweet

Hermes Tweet ajoute un ensemble d'outils X/Twitter à Hermes Agent. Il est utile pour l'écoute sociale, la recherche de comptes, la surveillance de lancements, le tri de support, les audits de giveaways et les workflows contrôlés où les opérations privées ou modifiant l'état restent explicites.

Quand utiliser ce skill

Utilisez ce skill lorsque l'utilisateur souhaite :

• Installer Hermes Tweet dans un runtime Hermes Agent
• Découvrir les routes de lecture et d'action X/Twitter disponibles
• Lire les données de comptes, tweets, tendances, surveillances ou recherches X/Twitter
• Résumer un signal public avant de rédiger des réponses ou des campagnes
• Garder les opérations privées et modifiant l'état derrière une validation explicite de l'opérateur

Configuration

Installez et activez le plugin via Hermes :

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

Hermes analyse les plugins lors de l'installation et des mises à jour. Examinez chaque avertissement. Un verdict dangereux bloque l'installation ou désactive une mise à jour.

Définissez la clé API sur l'hôte du runtime Hermes :

export XQUIK_API_KEY="<votre-clé>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Conservez HERMES_TWEET_ENABLE_ACTIONS sur false pour les sessions en lecture seule. Passez-le à true uniquement pour une opération approuvée de lecture privée, d'écriture, de surveillance, de webhook, d'extraction, de dessin ou de média.

Entrées

Demandez ces entrées avant de sélectionner des routes :

• Objectif : recherche, surveillance, tri de support, audit de giveaway ou préparation d'action
• Cible : handle de compte, URL de tweet, mot-clé, liste, surveillance ou tendance
• Fenêtre de temps et besoins de fraîcheur
• Si une opération privée ou modifiant l'état est dans le périmètre
• Confirmation que le runtime Hermes dispose de XQUIK_API_KEY

Workflow

1. Parcourez le catalogue d'endpoints fourni avec tweet_explore pour trouver les routes correspondantes.
2. Lisez les données publiques X/Twitter via tweet_read après avoir sélectionné une route du catalogue.
3. Utilisez tweet_action pour les routes privées ou modifiant l'état uniquement après approbation explicite.
4. Conservez les clés API dans les variables d'environnement ou le fichier env du runtime Hermes.
5. Ne collez pas d'identifiants dans les invites, les issues, les commentaires de PR ou les entrées d'outils.
6. Chargez les modèles de workflow lorsque l'utilisateur demande un workflow de campagne, surveillance, support ou giveaway plutôt qu'une simple lecture.

Modèle d'outils

Outil	Objectif
tweet_explore	Rechercher dans le catalogue d'endpoints fourni sans utiliser la clé API.
tweet_read	Appeler les endpoints publics en lecture seule listés dans le catalogue lorsque XQUIK_API_KEY est défini.
tweet_action	Appeler les lectures privées, écritures, surveillances, webhooks, extractions, dessins et opérations média uniquement lorsque la validation d'action est activée.

Format de sortie

Renvoie une sortie opérationnelle concise :

Résumé :
- Ce qui a été vérifié et pourquoi

Routes de lecture :
- Chemin du catalogue, entrée et résumé du résultat

Plan d'action :
- Opérations privées ou modifiant l'état proposées, chacune en attente d'approbation explicite

Prochaine vérification :
- Route de suivi ou cadence de surveillance si utile

Exemples d'utilisation

Rechercher un compte avant de rédiger une réponse :

Utilise Hermes Tweet pour inspecter le contexte public récent de @example avant de rédiger une réponse.
Conserve les actions désactivées.

Surveiller un mot-clé de lancement :

Suis les mentions X/Twitter pour "Example Launch" aujourd'hui.
Résume les thèmes et les comptes notables. Ne publie pas.

Préparer un message contrôlé :

Rédige un tweet de lancement et liste l'appel tweet_action exact que tu utiliserais.
Attends l'approbation avant toute route d'action.

Capturer des notes de route structurées :

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

Dépannage

• Si seul tweet_explore apparaît, configurez XQUIK_API_KEY sur l'hôte du runtime Hermes et rechargez ou redémarrez la session Hermes active.
• Si les routes d'action ne sont pas disponibles, gardez les lectures publiques séparées. Passez HERMES_TWEET_ENABLE_ACTIONS=true uniquement pour une opération privée ou modifiant l'état approuvée.
• Si une route ne correspond pas, utilisez à nouveau tweet_explore et choisissez un chemin listé dans le catalogue au lieu de deviner les endpoints.

Bonnes pratiques

• Traitez Hermes Tweet comme la couche X/Twitter native d'Hermes, pas comme un wrapper API générique.
• Gardez la recherche en lecture seule par défaut. Exigez une approbation avant de créer ou modifier des surveillances.
• Utilisez l'opérateur Desktop ou de passerelle pour les appels privés ou modifiant l'état.
• Validez le chemin exact du catalogue avant d'appeler tweet_read ou tweet_action.
• Redémarrez la passerelle, cron ou les sessions Hermes de longue durée après des changements d'environnement.

Voir aussi

Le plugin social-publishing complète Hermes Tweet pour une publication multi-plateforme large. Hermes Tweet est concentré sur l'ensemble d'outils X/Twitter d'Hermes Agent et son modèle de fonctionnement 'lecture d'abord' avec validation.

Consultez le contrat d'endpoint et d'approbation lorsqu'une limite de route n'est pas claire. Voir le guide officiel sur https://github.com/Xquik-dev/hermes-tweet#readme.