Dados do Twitter/X no Hermes Agent

#O Hermes Agent consegue ler o Twitter sozinho?

Sim, por duas rotas que já vêm com ele, e as duas cobram nas tarifas do próprio X. O Hermes Agent, o agente de código aberto da Nous Research, tem uma ferramenta x_search e uma skill embutida chamada xurl; elas precisam de chaves diferentes e devolvem coisas diferentes.

• x_search envia a sua pergunta aos servidores da xAI, onde o Grok pesquisa no X e escreve uma resposta com links para os posts que usou. Você a liga em hermes tools, ela precisa de uma XAI_API_KEY ou de um login SuperGrok ou X Premium+, e só lê. Os documentos do x_search (abre em uma nova aba) do Hermes avisam que o login da assinatura responde "with no citations", então posts reais exigem a chave paga.
• xurl é a ferramenta de linha de comando oficial do X, empacotada como uma skill. Ela devolve JSON bruto de posts e perfis da API oficial do X e também pode postar, responder, curtir e enviar DMs como a sua conta. Antes da primeira chamada você cria um app em developer.x.com e entra com OAuth fora do agente, como detalha a página da skill xurl (abre em uma nova aba).

As duas rotas cobram os dados do X por item. O preço da X Search (abre em uma nova aba) da xAI conta cada post que ela busca, inclusive posts pai e citados, e soma os tokens do modelo por cima. A API oficial do X cobra pela tabela dela (abre em uma nova aba) e para em 3 milhões de leituras de posts por mês, antes de um contrato Enterprise.

• x_search

  Precisa de

  Chave de API da xAI, ou um login SuperGrok ou X Premium+

  Devolve

  Resposta escrita pelo Grok com links para os posts

  Preço por 1.000 posts

  US$ 5,00, mais tokens; perfis US$ 10,00

• Skill xurl

  Precisa de

  App de desenvolvedor do X, login OAuth, créditos pré-pagos

  Devolve

  JSON bruto de posts e perfis; também pode postar

  Preço por 1.000 posts

  US$ 5,00; perfis US$ 10,00

A partir de 22 de novembro de 2026, a API oficial do X também cobra o autor que volta com cada post, a US$ 0,010 por usuário (aviso do X (abre em uma nova aba)), então uma página de 20 posts de 20 pessoas diferentes passa de US$ 0,10 para US$ 0,30. Qualquer outra fonte de dados do X entra no Hermes como toda ferramenta externa: como um servidor MCP no config.yaml ou como uma skill.

#Adicione dados do X ao Hermes Agent com uma entrada de configuração

Para ler o X no Hermes Agent por uma fração dessas tarifas, adicione a Sorsa API, uma API e scraper do Twitter (X), como servidor MCP. Um único bloco sorsa em ~/.hermes/config.yaml entrega ao agente 40 ferramentas que só leem, todas com uma chave; tweets custam a partir de US$ 0,014 por 1.000, e cada plano, inclusive o início gratuito, roda a 20 requisições por segundo. Não há conta de desenvolvedor do X para pedir, e sua própria conta do X fica de fora.

A Sorsa API cobra a chamada, não o item: uma chamada de busca retorna cerca de 20 posts, uma chamada de perfil retorna até 100 perfis, e cada post traz o perfil completo do autor sem custo extra. O servidor vem do npm e o Hermes o inicia com o npx: confira se node -v informa a versão 18 ou mais recente.

1. Obtenha uma chave. Cadastre-se na Sorsa API; a chave espera na página de chaves de API do seu painel. Toda conta nova tem 100 requisições sem custo, não pede cartão e as mantém até você usá-las.

2. Guarde-a como segredo. hermes config set grava qualquer nome em letras maiúsculas em ~/.hermes/.env, o arquivo onde o Hermes guarda chaves:

   hermes config set SORSA_API_KEY YOUR_API_KEY
   

3. Adicione o servidor. Cole isto em mcp_servers, em ~/.hermes/config.yaml (no Windows nativo, a pasta é %LOCALAPPDATA%\hermes). O Hermes preenche ${SORSA_API_KEY} a partir do .env quando inicia o servidor.

   mcp_servers:
     sorsa:
       command: "npx"
       args: ["-y", "sorsa-mcp"]
       env:
         SORSA_API_KEY: "${SORSA_API_KEY}"
       supports_parallel_tool_calls: true
   

4. Teste. hermes mcp test sorsa conecta e lista as 40 ferramentas. Em uma sessão que já está aberta, digite /reload-mcp; um gateway de mensagens em execução pega a nova entrada sozinho em cerca de um minuto.

5. Faça uma primeira pergunta. "How many Sorsa API requests do I have left?" faz o Hermes chamar mcp_sorsa_get_key_usage_info, que lê GET /key-usage-info (abre em uma nova aba) e não custa nada. Um número de volta prova a cadeia; uma chave digitada errado responde 401 "invalid api key".

   Bom saber

   Mantenha o bloco env mesmo quando a chave já está no .env. O Hermes passa a um servidor MCP local apenas uma base segura de variáveis do sistema mais as que você lista em env, como explicam os documentos de MCP (abre em uma nova aba) dele. Deixe o bloco de fora e o sorsa-mcp inicia sem chave: nós o iniciamos assim em 2 de novembro e ele parou na hora com "Missing SORSA_API_KEY environment variable", então nenhuma ferramenta chega ao agente.

supports_parallel_tool_calls: true deixa o Hermes rodar várias chamadas da Sorsa API ao mesmo tempo, o que os documentos do Hermes recomendam apenas para servidores cujas ferramentas não gravam nada. Toda ferramenta da Sorsa API lê, e uma chave aguenta 20 requisições por segundo, então um lote de consultas roda de uma vez em vez de uma após a outra.

#Decida quais ferramentas do X o Hermes vê e quanto ele pode gastar

O Hermes deixa cada servidor MCP carregar seus próprios limites, e três deles servem para dados do X: quais ferramentas carregam, até onde uma conversa pode ir e se as chamadas precisam da sua aprovação.

• Ferramentas. tools.include carrega apenas as ferramentas que você nomeia. As descrições das 40 ferramentas ocupam cerca de 23 mil caracteres, então um agente de pesquisa que precisa de busca e perfis carrega seis delas.
• Orçamento. tool_costs dá um preço a cada ferramenta e spend_limit define um teto por conversa. Defina a unidade como requisições, e o Hermes conta as chamadas da Sorsa API: passado o limite, ele pergunta antes de cada chamada em uma conversa e, em um cron job, onde ninguém pode responder, recusa a chamada. Cada execução do cron começa do zero.
• Confiança. Mantenha o padrão, trust: full. Com untrusted, o Hermes pergunta antes de toda ferramenta que não esteja marcada como somente leitura, e as ferramentas do sorsa-mcp ainda não trazem essa marca, então você aprovaria cada busca. As ferramentas só leem, então o máximo que uma execução confusa pode custar são requisições, e o orçamento limita isso.

Escolha uma tarefa e um orçamento e copie a entrada:

mcp_servers:
  sorsa:
    command: "npx"
    args: ["-y", "sorsa-mcp"]
    env:
      SORSA_API_KEY: "${SORSA_API_KEY}"
    supports_parallel_tool_calls: true
    tools:
      include:
        - search_tweets
        - search_users
        - get_user_info
        - get_user_info_batch
        - get_tweet_comments
        - get_key_usage_info
    tool_costs:
      search_tweets: 1
      search_users: 1
      get_user_info: 1
      get_user_info_batch: 1
      get_tweet_comments: 1
    spend_limit: 50
    cost_unit: requests

Um limite de gasto conta o que o Hermes aprovou naquela conversa, não a sua fatura da Sorsa API: reiniciar o Hermes zera todos os totais. A conta tem um teto próprio: as requisições extras do pay as you go param no limite do período que você escolhe no painel, que começa em US$ 100.

#Adicione a skill de agente quando o Hermes deve escrever código

Recorra à skill de agente da Sorsa API quando quiser um programa que possa rodar de novo sem o Hermes: uma exportação mensal, um arquivo de menções, um feed para o seu banco de dados. As ferramentas MCP entregam resultados ao chat; a skill entrega ao Hermes um guia escrito da API, com qual endpoint serve a qual tarefa, como next_cursor pagina e por que os IDs vão em lotes de 100, mais um pequeno cliente em Python, e os scripts que o Hermes escreve saem construídos sobre ele.

npx skills add Sorsa-io/sorsa-x-api-skill -g -a hermes-agent -y

Rodamos esta linha em 2 de novembro: ela copia a skill sorsa-x-api, com sua referência, o script de cliente e os exemplos, para ~/.hermes/skills/, onde o Hermes encontra skills. O nome do agente é hermes-agent; -a hermes para com "Invalid agents: hermes". Até um pedido combinar com a skill, o Hermes mantém à vista apenas o resumo de um parágrafo dela e abre o SKILL.md só quando necessário, então uma skill sem uso ocupa quase nada de contexto (documentos de skills (abre em uma nova aba)).

Os scripts da skill leem a chave de SORSA_API_KEY. O Hermes mantém variáveis com "KEY" no nome longe do Python que ele roda por execute_code, então libere esta no config.yaml:

terminal:
  env_passthrough:
    - SORSA_API_KEY

Depois peça um programa em vez de uma resposta, por exemplo: "Build a Python script that collects every X post about [your product] from the past month into product_posts.csv". O Hermes percorre POST /search-tweets (abre em uma nova aba) até next_cursor voltar vazio, roda o script uma vez e o deixa no lugar para a próxima execução.

#Três prompts prontos e quanto custa uma execução

Cada prompt abaixo fixa três coisas: o que ler, quanto ler e o que devolver. Isso mantém previsíveis as chamadas de ferramenta e a fatura, e os prompts rodam sem mudança no terminal, no Hermes Desktop ou em um chat do Telegram com o seu gateway.

Faça um resumo de um tema para mim

Search X for posts about [your topic] from the last 7 days
with at least 20 likes. Read the top 100, sort them into 3
to 5 themes, and send me a short brief with the 2 best
posts per theme, linked.

Para chegar a 100 posts, o Hermes chama mcp_sorsa_search_tweets cinco vezes e repassa next_cursor; cada página tem cerca de 20. Na Sorsa API, esse resumo custa a partir de US$ 0,007. O x_search cobraria US$ 0,50 pelos mesmos posts antes dos tokens, e a API oficial do X também US$ 0,50.

Leia a reação a um post

Read the first 200 replies to [post link], newest first.
Tell me what people praise, what they complain about and
what they ask, with 2 example replies for each.

O Hermes chama mcp_sorsa_get_tweet_comments dez vezes em POST /comments (abre em uma nova aba), 20 respostas por página, cada uma com o perfil do autor. Essa execução custa a partir de US$ 0,014; a API oficial do X cobra as mesmas 200 respostas a US$ 1,00, e até US$ 3,00 quando passar a cobrar pelo autor de cada resposta.

Avalie uma lista de contas

Here are up to 100 X handles: [paste]. Get all the profiles
in one batch and make a table of followers, following,
posts, join date and bio, sorted by followers. Flag accounts
younger than one year and save it as accounts.csv.

Uma chamada a mcp_sorsa_get_user_info_batch cobre a lista inteira: ela corresponde a GET /info-batch (abre em uma nova aba), que aceita até 100 usuários por requisição, então a tarefa custa a partir de US$ 0,0014. A API oficial do X cobra US$ 0,010 por perfil, US$ 1,00 pela lista, e o x_search cobra US$ 10 por 1.000 perfis, também US$ 1,00.

Uma passada pelos três prompts usa 16 requisições, o que significa que as 100 grátis pagam seis passadas completas. A diferença cresce com o volume: um resumo diário, ou um sobre um tema concorrido, logo lê posts às centenas de milhares.

#Receba um resumo diário do X com o cron do Hermes

O Hermes tem seu próprio agendador, então um resumo diário do X é um comando e não precisa de servidor seu. Este job lê o último dia de posts sobre a sua marca toda manhã:

hermes cron create "every 1d at 08:00" \
  "Search X for posts about [your brand] from the last 24
  hours. Sort them into praise, complaints and questions,
  link the 3 most-liked posts in each, under 15 lines." \
  --name "X brand digest"

A partir do terminal, o Hermes salva o resultado de cada execução em ~/.hermes/cron/output/. Para recebê-lo no celular, peça o mesmo job em um chat do Telegram com o seu gateway ("every morning at 8, send me...") e o resumo volta para esse chat, como descrevem os documentos de cron (abre em uma nova aba).

Com cerca de 100 posts por dia, o resumo lê 3.000 posts por mês: a partir de US$ 0,21 por mês na Sorsa API, contra US$ 15,00 na API oficial do X antes da cobrança pelo autor, ou US$ 15,00 pelo x_search mais tokens. Com spend_limit na entrada sorsa, cada execução para no número de requisições que você permitir, então um dia de notícias intenso não pode inflar a fatura. A configuração de monitoramento do widget acima serve a esta tarefa.

Bom saber

Posts são dados para o Hermes ler, e nada neles deve contar como um comando. O Hermes já remove caracteres invisíveis de tag Unicode dos resultados MCP, mas o texto visível de um post ainda pode ser escrito para desviar um agente. Como toda ferramenta da Sorsa API só lê, um post assim desperdiça no máximo uma requisição; não dê a tarefas que leem o X ferramentas de mensagens ou de shell de que elas não precisam.

#Conecte o Hermes Agent ao X hoje

As rotas do X embutidas no Hermes Agent cobram nos preços do X: US$ 5,00 por 1.000 posts pelo x_search ou pelo xurl. Para ler o X no Hermes, use o servidor MCP da Sorsa API: uma entrada no config.yaml, 40 ferramentas somente leitura, tweets a partir de US$ 0,014 por 1.000, um orçamento de requisições que o Hermes faz valer e nenhum app de desenvolvedor; a Sorsa API nunca pede o seu login do X. As 100 requisições grátis rodam os três prompts acima seis vezes, e crie com IA tem mais prompts prontos para colar. Vai configurar outro agente também? A página do servidor MCP da Sorsa tem a linha para cada cliente, e o guia do servidor MCP do Twitter compara os tipos de servidor do X.

#Perguntas frequentes