Datos de Twitter/X en Hermes Agent

#¿Puede Hermes Agent leer Twitter por sí solo?

Sí, mediante dos rutas que vienen incluidas, y ambas cobran a las tarifas propias de X. Hermes Agent, el agente de código abierto de Nous Research, tiene una herramienta x_search y una skill incluida llamada xurl; necesitan claves distintas y devuelven cosas distintas.

• x_search envía tu pregunta a los servidores de xAI, donde Grok busca en X y redacta una respuesta con enlaces a los posts que usó. Se activa en hermes tools, necesita una XAI_API_KEY o un inicio de sesión de SuperGrok o X Premium+, y solo lee. La documentación de x_search (se abre en una pestaña nueva) de Hermes advierte que el inicio de sesión con suscripción responde "with no citations", así que para obtener posts reales hace falta la clave de pago.
• xurl es la herramienta de línea de comandos oficial de X, envuelta como skill. Devuelve JSON sin procesar de posts y perfiles de la API oficial de X y también puede publicar, responder, dar like y enviar mensajes directos como tu cuenta. Antes de la primera llamada creas una app en developer.x.com e inicias sesión con OAuth fuera del agente, como detalla la página de la skill xurl (se abre en una pestaña nueva).

Ambas rutas cobran los datos de X por elemento. Los precios de X Search (se abre en una pestaña nueva) de xAI cuentan cada post que obtiene, incluidos los posts padre y citados, y suman los tokens del modelo encima. La API oficial de X cobra según su tarifario (se abre en una pestaña nueva) y se detiene en 3 millones de lecturas de posts al mes antes de un contrato Enterprise.

• x_search

  Necesita

  Clave API de xAI, o un inicio de sesión de SuperGrok o X Premium+

  Devuelve

  La respuesta redactada por Grok con enlaces a los posts

  Precio por cada 1,000 posts

  $5.00, más tokens; perfiles $10.00

• Skill xurl

  Necesita

  App de desarrollador de X, inicio de sesión OAuth, créditos prepagados

  Devuelve

  JSON sin procesar de posts y perfiles; también puede publicar

  Precio por cada 1,000 posts

  $5.00; perfiles $10.00

A partir del 22 de noviembre de 2026, la API oficial de X también cobra el autor que llega con cada post, a $0.010 por usuario (aviso de X (se abre en una pestaña nueva)), así que una página de 20 posts de 20 personas distintas pasa de $0.10 a $0.30. Cualquier otra fuente de datos de X se une a Hermes como lo hace toda herramienta externa: como servidor MCP en config.yaml o como skill.

#Añade datos de X a Hermes Agent con una entrada de configuración

Para leer X en Hermes Agent por una fracción de esas tarifas, añade Sorsa API, una API y scraper de Twitter (X), como servidor MCP. Un solo bloque sorsa en ~/.hermes/config.yaml le da al agente 40 herramientas que solo leen, todas con una sola clave, los tweets cuestan desde $0.014 por cada 1,000 y cada plan, incluido el inicio gratuito, funciona a 20 solicitudes por segundo. No hay que solicitar ninguna cuenta de desarrollador de X, y tu propia cuenta de X queda fuera.

Sorsa API cobra la llamada, no el elemento: una llamada de búsqueda devuelve unos 20 posts, una llamada de perfiles devuelve hasta 100 perfiles, y cada post lleva el perfil completo de su autor sin costo extra. El servidor viene de npm y Hermes lo lanza con npx: comprueba que node -v informe la versión 18 o más reciente.

1. Consigue una clave. Regístrate en Sorsa API; la clave te espera en la página de claves API de tu panel. Cada cuenta nueva tiene 100 solicitudes sin cargo, no pide tarjeta y las conserva hasta que las uses.

2. Guárdala como secreto. hermes config set escribe cualquier nombre en mayúsculas en ~/.hermes/.env, el archivo que Hermes reserva para las claves:

   hermes config set SORSA_API_KEY YOUR_API_KEY
   

3. Añade el servidor. Pega esto bajo mcp_servers en ~/.hermes/config.yaml (en Windows nativo, la carpeta es %LOCALAPPDATA%\hermes). Hermes rellena ${SORSA_API_KEY} desde .env cuando inicia el servidor.

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

4. Pruébalo. hermes mcp test sorsa se conecta y lista las 40 herramientas. En una sesión que ya está abierta, escribe /reload-mcp; un gateway de mensajería en ejecución recoge la nueva entrada por sí solo en aproximadamente un minuto.

5. Haz una primera pregunta. "¿Cuántas solicitudes de Sorsa API me quedan?" hace que Hermes llame a mcp_sorsa_get_key_usage_info, que lee GET /key-usage-info (se abre en una pestaña nueva) y no cuesta nada. Un número de vuelta prueba la cadena; una clave mal escrita responde 401 "invalid api key".

   Para tener en cuenta

   Conserva el bloque env aunque la clave ya esté en .env. Hermes le pasa a un servidor MCP local solo una base segura de variables del sistema más las que listes bajo env, como explica su documentación de MCP (se abre en una pestaña nueva). Si omites el bloque, sorsa-mcp arranca sin clave: lo lanzamos así el 2 de noviembre y se detuvo al instante con "Missing SORSA_API_KEY environment variable", así que ninguna herramienta llega al agente.

supports_parallel_tool_calls: true permite que Hermes ejecute varias llamadas de Sorsa API al mismo tiempo, algo que la documentación de Hermes recomienda solo para servidores cuyas herramientas no escriben. Todas las herramientas de Sorsa API leen, y una clave admite 20 solicitudes por segundo, así que un lote de consultas se ejecuta a la vez en lugar de una tras otra.

#Decide qué herramientas de X ve Hermes y cuánto puede gastar

Hermes permite que cada servidor MCP lleve sus propios límites, y tres de ellos encajan con los datos de X: qué herramientas se cargan, hasta dónde puede llegar un chat y si las llamadas necesitan tu aprobación.

• Herramientas. tools.include carga solo las herramientas que nombras. Las 40 descripciones de herramientas ocupan unos 23K caracteres, así que un agente de investigación que necesita búsqueda y perfiles lleva seis en su lugar.
• Presupuesto. tool_costs le da un precio a cada herramienta y spend_limit fija un techo por chat. Si defines la unidad en solicitudes, Hermes cuenta las llamadas a Sorsa API: al pasar el límite pregunta antes de cada llamada en un chat y, en un trabajo de cron, donde nadie puede responder, rechaza la llamada. Cada ejecución de cron empieza desde cero.
• Confianza. Mantén el valor por defecto, trust: full. Con untrusted, Hermes pregunta antes de cada herramienta que no esté marcada como de solo lectura, y las herramientas de sorsa-mcp todavía no llevan esa marca, así que tendrías que aprobar cada búsqueda. Las herramientas solo leen, de modo que lo máximo que puede costar una ejecución confundida son solicitudes, y el presupuesto lo limita.

Elige una tarea y un presupuesto, y copia la 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

Un límite de gasto cuenta lo que Hermes aprobó en esa conversación, no tu factura de Sorsa API: reiniciar Hermes pone a cero todos los totales. La cuenta tiene su propio techo: las solicitudes extra de pago por uso se detienen en el límite del periodo que elijas en el panel, que empieza en $100.

#Añade la skill de agente cuando Hermes deba escribir código

Recurre a la skill de agente de Sorsa API cuando quieras un programa que puedas volver a ejecutar sin Hermes: una exportación mensual, un archivo de menciones, un flujo hacia tu base de datos. Las herramientas MCP entregan los resultados al chat; la skill le entrega a Hermes una guía escrita de la API, con qué endpoint encaja con cada tarea, cómo pagina next_cursor y por qué los ID van en lotes de 100, más un pequeño cliente de Python, y los scripts que escribe Hermes salen construidos sobre ella.

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

Ejecutamos esta línea el 2 de noviembre: copia la skill sorsa-x-api, con su referencia, su script cliente y sus ejemplos, en ~/.hermes/skills/, donde Hermes encuentra las skills. El nombre del agente es hermes-agent; -a hermes se detiene con "Invalid agents: hermes". Hasta que una petición encaja con la skill, Hermes mantiene a la vista solo su resumen de un párrafo y abre SKILL.md únicamente cuando hace falta, así que una skill sin usar ocupa casi nada de contexto (documentación de skills (se abre en una pestaña nueva)).

Los scripts de la skill leen la clave de SORSA_API_KEY. Hermes mantiene las variables con "KEY" en su nombre lejos del Python que ejecuta mediante execute_code, así que deja pasar esta en config.yaml:

terminal:
  env_passthrough:
    - SORSA_API_KEY

Luego pide un programa en lugar de una respuesta, por ejemplo: "Construye un script de Python que reúna en product_posts.csv todos los posts de X sobre [tu producto] del último mes". Hermes recorre POST /search-tweets (se abre en una pestaña nueva) hasta que next_cursor vuelve vacío, ejecuta el script una vez y lo deja en su lugar para la siguiente ejecución.

#Tres prompts listos y lo que cuesta una ejecución

Cada prompt de abajo fija tres cosas: qué leer, cuánto y qué entregar. Eso mantiene predecibles las llamadas a herramientas y la factura, y los prompts se ejecutan sin cambios en la terminal, en Hermes Desktop o desde un chat de Telegram con tu gateway.

Hazme un resumen de un tema

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 llegar a 100 posts, Hermes llama a mcp_sorsa_search_tweets cinco veces y pasa next_cursor; cada página contiene unos 20. En Sorsa API ese resumen cuesta desde $0.007. x_search cobraría $0.50 por los mismos posts antes de tokens, y la API oficial de X también $0.50.

Lee la reacción a un 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.

Hermes llama a mcp_sorsa_get_tweet_comments diez veces en POST /comments (se abre en una pestaña nueva), 20 respuestas por página, cada una con el perfil de su autor. Esa ejecución cuesta desde $0.014; la API oficial de X cobra esas mismas 200 respuestas a $1.00, y hasta $3.00 cuando empiece a cobrar el autor de cada respuesta.

Revisa una lista de cuentas

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.

Una llamada a mcp_sorsa_get_user_info_batch cubre toda la lista: corresponde a GET /info-batch (se abre en una pestaña nueva), que acepta hasta 100 nombres de usuario por solicitud, así que la tarea cuesta desde $0.0014. La API oficial de X cobra $0.010 por perfil, $1.00 por la lista, y x_search cobra $10 por cada 1,000 perfiles, también $1.00.

Una pasada por los tres prompts toma 16 solicitudes, lo que significa que las 100 gratis pagan seis pasadas completas. La diferencia se amplía con el volumen: un resumen diario, o uno sobre un tema concurrido, pronto lee posts por centenares de miles.

#Recibe un resumen diario de X con el cron de Hermes

Hermes tiene su propio planificador, así que un resumen diario de X es un solo comando y no necesita ningún servidor tuyo. Este trabajo lee cada mañana el último día de posts sobre tu marca:

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"

Desde la terminal, Hermes guarda el resultado de cada ejecución en ~/.hermes/cron/output/. Para recibirlo en el celular, pide el mismo trabajo en un chat de Telegram con tu gateway ("todas las mañanas a las 8, envíame...") y el resumen vuelve a ese chat, como describe la documentación de cron (se abre en una pestaña nueva).

Con unos 100 posts al día, el resumen lee 3,000 posts al mes: desde $0.21 al mes en Sorsa API, frente a $15.00 en la API oficial de X antes de sus cargos por autor, o $15.00 con x_search más tokens. Con spend_limit en la entrada sorsa, cada ejecución se detiene en el número de solicitudes que permitas, así que un día de noticias intenso no puede disparar la factura. La configuración de monitoreo del widget de arriba encaja con esta tarea.

Para tener en cuenta

Los posts son datos que Hermes lee, y nada en ellos debe contar como un comando. Hermes ya elimina de los resultados MCP los caracteres de etiqueta Unicode ocultos, pero el texto visible de un post aún puede estar escrito para desviar a un agente. Como todas las herramientas de Sorsa API solo leen, un post así puede desperdiciar una solicitud como máximo; no des a las tareas que leen X herramientas de mensajería ni de shell que no necesiten.

#Conecta hoy Hermes Agent a X

Las rutas propias de Hermes Agent hacia X cobran a los precios de X: $5.00 por cada 1,000 posts con x_search o xurl. Para leer X en Hermes, usa el servidor MCP de Sorsa API: una entrada en config.yaml, 40 herramientas de solo lectura, tweets desde $0.014 por cada 1,000, un presupuesto de solicitudes que Hermes hace cumplir y ninguna app de desarrollador; Sorsa API nunca pide tu inicio de sesión de X. Las 100 solicitudes gratis cubren seis veces los tres prompts de arriba, y build with AI tiene más prompts listos para pegar. ¿Configuras también otro agente? La página del servidor MCP de Sorsa tiene la línea para cada cliente, y la guía del servidor MCP de Twitter compara los tipos de servidores de X.

#Preguntas frecuentes