hermes atlas
318·repos hermes·v0.23.1 ★ star this repo

Xquik-dev/hermes-tweet

Hermes X (Twitter) plugin that gives Hermes Agent monitors, automation & tweet search. Not affiliated with X Corp.

★ 40 langPython licenseMIT updated2026-11-16

Hermes Tweet connects Hermes agents to the Xquik API for searching posts, reading profile timelines, and monitoring accounts. It also supports actions such as posting, replying, and exporting followers, with actions disabled by default and approval required for `tweet_action`.

  • Includes separate tools for catalog search, reads, and actions.
  • Bundles a Hermes Skill and two slash commands.
  • Requires an Xquik API key for API access.
full readme from github

Hermes Tweet, the Hermes X (Twitter) Agent Plugin for Search & Actions

Framer builds a tweet ticker with Xquik
Watch Framer build a tweet ticker with Xquik, from 6:07. Hermes Tweet brings the Xquik API to Hermes agents.

Use this Hermes Twitter plugin by Xquik to search tweets & monitor accounts. Explore 102 OpenAPI-generated endpoints, including 33 prepaid reads and 7 direct MPP routes.

Xquik is the world's fastest and cheapest X (Twitter) scraper service with the most complete X (Twitter) data. Most other Apify Actors charge before filtering or deduplication. Xquik charges only for delivered, unique, filter-matching results and never pads rows. Xquik is independent and not affiliated with X Corp.

The Xquik REST API read 45 tweets per second on 2026-10-15. That cost $0.15 per 1,000. The fastest of 4 rival Actors read 12.5 per second. The cheapest cost $0.173 per 1,000. Compare each run.

Install the Hermes Twitter plugin

Install and enable the plugin in Hermes Agent.

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

Create an API key in Xquik. Set it in your environment, then restart Hermes.

export XQUIK_API_KEY="xq_..."

Common X (Twitter) API tasks

Ask Hermes in plain words. It calls tweet_explore, then the tool the catalog names.

Search tweets about "AI agents" from the last day.
Task Catalog query Tool
Search X (Twitter) posts search tweets by query tweet_read
Read profile timelines list recent tweets posted by a user tweet_read
Export followers run extraction tweet_action
Export following accounts run extraction tweet_action
Monitor an account create monitor tweet_action
Post or reply create tweet tweet_action

Set include_actions for extraction, monitoring, and writing searches. tweet_action always follows the approval rules below.

Next, read the Hermes Tweet guide or the integration patterns.

Benchmarks & usage

hermes-tweet downloads on PyPI hermes-tweet downloads on ClawHub hermes-tweet Skill installs on skills.sh OpenSSF Best Practices

  • 3,000+ downloads of hermes-tweet on PyPI (source)
  • 1,200+ downloads of hermes-tweet on ClawHub (source)
  • 7 installs of this repo's Skills on skills.sh (source)
  • This repo meets the OpenSSF Best Practices passing criteria (source)

Checked on 2026-11-08. See each number with its date & source on xquik.com/benchmarks or as JSON.

Monitor an X (Twitter) account from Hermes

Turn on actions, restart Hermes, then ask for a monitor. Hermes calls tweet_explore for create monitor, then tweet_action after your approval.

export HERMES_TWEET_ENABLE_ACTIONS="true"
Monitor @NASA for new posts and show me each one.

Run a Twitter bot & X (Twitter) automation with approval

Posts, replies and follower exports run through tweet_action. The bundled skill asks for your approval before each action. Actions stay off until you enable them.

Post "Launch day" from my connected X account.
Export the followers of @NASA.

Tools

Reads and actions use separate tools. The plugin bundles a Hermes Skill and 2 slash commands.

Tool Purpose
tweet_explore Search the bundled catalog. Makes no API call.
tweet_read Call catalog-listed read endpoints.
tweet_action Call private or mutating endpoints. Off by default.

Use tweet_explore first. Then pass a listed /api/v1/... path to the matching tool. Copied Xquik URLs work when their paths match the catalog.

Slash commands

Command Purpose
/xstatus Show Xquik account and usage status.
/xtrends Show current X (Twitter) trends.

Other install paths

Hermes scans plugins during install and update. Review any warning before you continue. A dangerous verdict blocks installation or disables an update.

Hermes installs no extra Python package for this plugin. Hermes core already ships httpx, its only dependency.

Do you manage the Hermes Python environment yourself? Add the hermes-tweet PyPI package to it, then enable the plugin.

hermes plugins enable hermes-tweet

Install a local checkout with this command.

hermes plugins install file:///absolute/path/to/hermes-tweet --force --enable

Configure

These settings are optional.

export XQUIK_BASE_URL="https://xquik.com"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Restart Hermes after you change environment variables.

Safety

  • Tools never accept credentials as arguments.
  • The plugin injects XQUIK_API_KEY at request time.
  • Admin, billing, credit, support, guest-wallet, and API-key routes stay hidden.
  • Account re-authentication routes stay hidden.
  • Binary downloads stay outside the agent catalog. Use REST for those files.
  • Private reads and mutations use tweet_action.
  • tweet_action requires HERMES_TWEET_ENABLE_ACTIONS=true.

Without an API key, Hermes exposes only tweet_explore.

Development

Regenerate the catalog from the canonical OpenAPI schema.

python scripts/build_catalog.py ../xquik/openapi.yaml

Run every check before you open a pull request.

bin/check-local

Questions

Do I need an X (Twitter) developer account?

No. Public reads need only an Xquik API key. Private reads & X (Twitter) account actions need a connected account.

Is Hermes Tweet the official X API?

No. Xquik runs its own REST API. Hermes Tweet calls that API, not the official X API.

Links

More Xquik tools

License

MIT

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.