Hermes Tweet

Hermes Tweet ajoute une suite d'outils X/Twitter à Hermes Agent. Elle est utile pour l'écoute sociale, la recherche de comptes, le suivi de lancement, le triage du support, l'audit de cadeaux et les flux de publication contrôlés où les actions restent explicites.

Quand utiliser cette skill

Utilisez cette skill quand l'utilisateur souhaite :

• Installer Hermes Tweet dans un runtime Hermes Agent
• Découvrir les routes de lecture et d'action X/Twitter disponibles
• Lire des données de compte X/Twitter, tweet, tendance, monitor ou recherche
• Résumer les signaux publics avant de rédiger des réponses ou des campagnes
• Bloquer les actions modifiant le compte derrière une intention d'opérateur explicite

Configuration

Installez le paquet dans l'environnement Python de Hermes, puis activez le plugin :

~/.hermes/hermes-agent/venv/bin/python -m pip install hermes-tweet
hermes plugins enable hermes-tweet

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

export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Gardez HERMES_TWEET_ENABLE_ACTIONS à false pour les sessions de lecture d'abord. Passez-le à true uniquement pour les sessions qui ont intentionnellement besoin de poster, répondre, DM, suivre, webhooks, monitors, modifications de médias ou autres routes modifiant le compte.

Entrées

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

• Objectif : recherche, monitoring, triage de support, audit de cadeaux ou préparation d'action
• Cible : handle de compte, URL de tweet, mot-clé, liste, monitor ou tendance
• Fenêtre de temps et besoins en fraîcheur
• Si une action modifiant le compte est en portée
• Confirmation que le runtime Hermes dispose de XQUIK_API_KEY

Workflow

1. Recherchez le catalogue d'endpoints intégré avec tweet_explore pour trouver les routes correspondantes.
2. Lisez les données X/Twitter via tweet_read après avoir sélectionné une route du catalogue.
3. Exécutez les routes modifiant le compte avec tweet_action uniquement après approbation explicite.
4. Conservez les clés API dans des variables d'environnement ou le fichier env du runtime Hermes.
5. Ne collez jamais les identifiants dans les prompts, issues, commentaires PR ou entrées d'outils.
6. Chargez les patterns de workflow quand l'utilisateur demande une campagne, un monitor, un support ou un workflow de cadeaux au lieu d'une simple lecture.

Modèle d'outils

Format de sortie

Retournez une sortie opérationnelle concise :

Summary:
- What was checked and why

Read routes:
- Catalog path, input, and result summary

Action plan:
- Proposed account-changing actions, each awaiting explicit approval

Next check:
- Follow-up route or monitoring cadence when useful

Exemples d'utilisation

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

Use Hermes Tweet to inspect recent public context for @example before drafting a reply.
Keep actions disabled.

Suivez un mot-clé de lancement :

Track X/Twitter mentions for "Example Launch" today.
Summarize themes and notable accounts. Do not post.

Préparez un post sécurisé :

Draft a launch tweet and list the exact tweet_action call you would use.
Wait for approval before any action route.

Capturez 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, continuez la lecture ou définissez HERMES_TWEET_ENABLE_ACTIONS=true uniquement pour une session d'action approuvée.
• Si une route ne correspond pas, utilisez tweet_explore à nouveau et choisissez une route du catalogue au lieu de deviner les endpoints.

Bonnes pratiques

• Traitez Hermes Tweet comme la couche X/Twitter native de Hermes, pas un wrapper API générique.
• Gardez les workflows de recherche et monitoring en lecture seule par défaut.
• Utilisez la révision Desktop ou gateway avant les appels modifiant le compte.
• Validez le chemin exact du catalogue avant d'appeler tweet_read ou tweet_action.
• Redémarrez gateway, cron ou les sessions Hermes longue durée après des modifications env.

Voir aussi

Le plugin social-publishing complète Hermes Tweet pour la publication multi-plateforme étendue. Hermes Tweet est centré sur la suite d'outils X/Twitter de Hermes Agent et son modèle opérationnel de lecture d'abord avec contrôle d'approbation.

Consultez le guide officiel à https://github.com/Xquik-dev/hermes-tweet#readme.