wshobson/hermes-tweet

Hermes Tweet

Hermes Tweet adiciona um conjunto de ferramentas do X/Twitter ao Hermes Agent. Ele é útil para escuta social, pesquisa de contas, monitoramento de lançamentos, triagem de suporte, auditoria de sorteios e fluxos de trabalho controlados onde operações privadas ou de alteração de estado permanecem explícitas.

Quando Usar Esta Skill

Use esta skill quando o usuário quiser:

• Instalar o Hermes Tweet em um runtime do Hermes Agent
• Descobrir rotas de leitura e ação disponíveis no X/Twitter
• Ler dados de contas, tweets, tendências, monitores ou pesquisas do X/Twitter
• Resumir sinais públicos antes de elaborar respostas ou campanhas
• Manter operações privadas e de alteração de estado protegidas por intenção explícita do operador

Configuração

Instale e habilite o plugin através do Hermes:

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

O Hermes verifica plugins durante a instalação e atualizações. Revise cada aviso. Um veredito de perigo bloqueia a instalação ou desativa uma atualização.

Defina a chave da API no host do runtime Hermes:

export XQUIK_API_KEY="<sua-chave>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Mantenha HERMES_TWEET_ENABLE_ACTIONS como false para sessões somente leitura. Defina como true apenas para uma operação aprovada de leitura privada, escrita, monitoramento, webhook, extração, desenho ou mídia.

Entradas

Solicite estas entradas antes de selecionar rotas:

• Objetivo: pesquisa, monitoramento, triagem de suporte, auditoria de sorteio ou preparação de ação
• Alvo: handle da conta, URL de tweet, palavra-chave, lista, monitor ou tendência
• Necessidades de janela de tempo e atualização
• Se alguma operação privada ou de alteração de estado está no escopo
• Confirmação de que o runtime Hermes possui XQUIK_API_KEY

Fluxo de Trabalho

1. Pesquise o catálogo de endpoints agrupado com tweet_explore para encontrar rotas correspondentes.
2. Leia dados públicos do X/Twitter através de tweet_read após selecionar uma rota do catálogo.
3. Use tweet_action para rotas privadas ou de alteração de estado apenas após aprovação explícita.
4. Mantenha as chaves de API em variáveis de ambiente ou no arquivo de ambiente do runtime Hermes.
5. Não cole credenciais em prompts, issues, comentários de PR ou entradas de ferramentas.
6. Carregue padrões de fluxo de trabalho quando o usuário pedir um fluxo de campanha, monitoramento, suporte ou sorteio em vez de uma única leitura.

Modelo de Ferramentas

Ferramenta	Propósito
tweet_explore	Pesquisar o catálogo de endpoints agrupado sem usar a chave da API.
tweet_read	Chamar endpoints públicos somente leitura listados no catálogo quando XQUIK_API_KEY está definida.
tweet_action	Chamar leituras privadas, escritas, monitores, webhooks, extrações, desenhos e operações de mídia apenas quando a proteção de ação está ativada.

Formato de Saída

Retorne saída operacional concisa:

Resumo:
- O que foi verificado e por quê

Rotas de leitura:
- Caminho do catálogo, entrada e resumo do resultado

Plano de ação:
- Operações privadas ou de alteração de estado propostas, cada uma aguardando aprovação explícita

Próxima verificação:
- Rota de acompanhamento ou cadência de monitoramento quando útil

Exemplos de Uso

Pesquisar uma conta antes de elaborar uma resposta:

Use Hermes Tweet para inspecionar o contexto público recente de @example antes de elaborar uma resposta.
Mantenha as ações desabilitadas.

Monitorar uma palavra-chave de lançamento:

Rastreie menções no X/Twitter para "Exemplo de Lançamento" hoje.
Resuma temas e contas notáveis. Não publique.

Preparar uma postagem protegida:

Esboce um tweet de lançamento e liste a chamada exata de tweet_action que você usaria.
Aguarde aprovação antes de qualquer rota de ação.

Capturar notas de rota estruturadas:

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

Solução de Problemas

• Se apenas tweet_explore aparecer, configure XQUIK_API_KEY no host do runtime Hermes e recarregue ou reinicie a sessão ativa do Hermes.
• Se as rotas de ação estiverem indisponíveis, mantenha as leituras públicas separadas. Defina HERMES_TWEET_ENABLE_ACTIONS=true apenas para uma operação privada ou de alteração de estado aprovada.
• Se uma rota não corresponder, use tweet_explore novamente e escolha um caminho listado no catálogo em vez de adivinhar endpoints.

Melhores Práticas

• Trate o Hermes Tweet como a camada X/Twitter nativa do Hermes, não um wrapper genérico de API.
• Mantenha a pesquisa somente leitura por padrão. Exija aprovação antes de criar ou alterar monitores.
• Use revisão do operador via Desktop ou gateway antes de chamadas privadas ou de alteração de estado.
• Valide o caminho exato do catálogo antes de chamar tweet_read ou tweet_action.
• Reinicie sessões do gateway, cron ou Hermes de longa duração após alterações de ambiente.

Veja Também

O plugin de publicação social complementa o Hermes Tweet para publicação ampla em múltiplas plataformas. Hermes Tweet é focado no conjunto de ferramentas X/Twitter do Hermes Agent e seu modelo operacional de leitura primeiro e protegido por aprovação.

Consulte o contrato de endpoint e aprovação quando um limite de rota não estiver claro. Veja o guia oficial em https://github.com/Xquik-dev/hermes-tweet#readme.