Hermes Tweet, the Hermes X (Twitter) Agent Plugin for Search & Actions
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
- 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.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
