Skip to main content
plugin CX Codex

hermes-tweet · hashgraph-online — Claude Code plugin: X search and setup

hermes-tweet adds X/Twitter search, data reads, and monitoring to Hermes through Xquik. It suits research workflows where write actions need approval.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install hermes-tweet@awesome-codex-plugins
Open on GitHub

What hermes-tweet does

hermes-tweet adds X/Twitter search, read access, and monitoring to Hermes Agent through Xquik. The workflow starts with tweet_explore, which searches the bundled catalog without an API call. Hermes then sends a catalog path such as /api/v1/... to either tweet_read or tweet_action. The plugin includes a Hermes Skill and two slash commands.

Reads and mutating actions use separate tools. tweet_action is disabled by default and can handle follower or following exports, account monitoring, posts, and replies. A Xquik API key must be available as XQUIK_API_KEY. The plugin does not add a Python package when Hermes provides its built-in httpx dependency.

Install it through the Claude Code marketplace, then restart Hermes after changing environment variables. Requests to Xquik will fail without XQUIK_API_KEY. The plugin is also listed for Codex.

What it helps with

  • search X posts by a query
  • read a user’s recent timeline
  • export followers through Xquik
  • create account monitoring
  • draft a post or reply before approval

Example prompts for the agent

  • Search X for posts about MCP servers. Start with tweet_explore, then read the returned results.
  • Show the latest posts from this user and send the catalog path to tweet_read.
  • Set up account monitoring with tweet_action, but ask for my approval before performing the action.

How to install hermes-tweet

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install hermes-tweet@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about hermes-tweet

How do I install hermes-tweet in Claude Code?

First add the marketplace with /plugin marketplace add hashgraph-online/awesome-codex-plugins, then install the plugin with /plugin install hermes-tweet@awesome-codex-plugins.

What does hermes-tweet do?

It gives Hermes Agent X/Twitter search, read access, and monitoring through Xquik. Write and other mutating operations are kept in the separate tweet_action tool.

What is required for hermes-tweet to work?

Create an API key in Xquik and expose it as XQUIK_API_KEY. Actions through tweet_action start disabled.

Source text

hermes-tweet · MIT
# Hermes Tweet, the Hermes Agent plugin for Twitter search & X actions

[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13725/badge)](https://www.bestpractices.dev/projects/13725)
[![PyPI](https://img.shields.io/pypi/v/hermes-tweet.svg)](https://pypi.org/project/hermes-tweet/)

Add Twitter API search, monitoring, and approved X actions to
[Hermes Agent](https://github.com/NousResearch/hermes-agent).

Xquik is the world's fastest and cheapest X Twitter scraper service with the most complete X data.
Xquik charges only for delivered, unique, filter-matching results and never pads rows.

Explore 102 OpenAPI-generated endpoints, including 33 prepaid reads and 7 direct MPP routes.
Reads and actions use separate tools. Actions stay disabled by default.
The plugin bundles a Hermes Skill and 2 slash commands.

<!-- trust:start -->

## Trust & usage

[![Twitter API package downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fdownloads.json)](https://xquik.com/trust#downloads)
[![Twitter scraper users on Apify](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fapify-users.json)](https://apify.com/xquik)
[![Twitter scraper runs on Apify](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fapify-runs.json)](https://apify.com/xquik)
[![Tweet scraper rating on Apify](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fapify-rating.json)](https://apify.com/xquik/x-tweet-scraper/reviews)
[![Xquik Twitter API accounts](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Faccounts.json)](https://xquik.com/trust#accounts)
[![Twitter Skill installs](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fskill-installs.json)](https://xquik.com/trust#skill-installs)
[![Xquik verified revenue on TrustMRR](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Frevenue.json)](https://trustmrr.com/startup/xquik)
[![Twitter API median response time](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Frest-p50.json)](https://xquik.com/trust#speed)
[![Xquik GitHub stars](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fgithub-stars.json)](https://github.com/Xquik-dev)
[![hermes-tweet downloads on PyPI](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fpypi-hermes-tweet.json)](https://pypistats.org/packages/hermes-tweet)
[![hermes-tweet downloads on ClawHub](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fclawhub-hermes-tweet.json)](https://clawhub.ai/xquik/skills/hermes-tweet)
[![hermes-tweet Skill installs on skills.sh](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fskills-hermes-tweet.json)](https://skills.sh/xquik-dev/hermes-tweet)
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13725/badge)](https://www.bestpractices.dev/projects/13725)

- 51,000+ downloads of Xquik's Twitter API packages on npm, PyPI, RubyGems, NuGet, Packagist & Terraform ([source](https://xquik.com/trust#downloads)) <!-- trust:downloads 51020 -->
- 7,800+ users of Xquik's Twitter scraper Actors on Apify ([source](https://apify.com/xquik)) <!-- trust:apify-users 7800 -->
- 5,700,000+ runs of Xquik's Twitter scraper Actors on Apify ([source](https://apify.com/xquik)) <!-- trust:apify-runs 5704701 -->
- 4.66 of 5 for the X Tweet Scraper from 16 Apify reviews ([source](https://apify.com/xquik/x-tweet-scraper/reviews)) <!-- trust:apify-rating 4.66 16 -->
- 3,900+ accounts on xquik.com ([source](https://xquik.com/trust#accounts)) <!-- trust:accounts 3924 -->
- 1,600+ installs of Xquik's Twitter Skills on skills.sh ([source](https://xquik.com/trust#skill-installs)) <!-- trust:skill-installs 1612 -->
- $38,000+ in revenue verified by TrustMRR ([source](https://trustmrr.com/startup/xquik)) <!-- trust:revenue 38115 -->
- 501 ms median REST API read time over the last 7 days ([source](https://xquik.com/trust#speed)) <!-- trust:rest-p50 501 -->
- 370+ GitHub stars across Xquik's repos ([source](https://github.com/Xquik-dev)) <!-- trust:github-stars 374 -->
- 2,800+ downloads of hermes-tweet on PyPI ([source](https://pypistats.org/packages/hermes-tweet)) <!-- trust:pypi-hermes-tweet 2876 -->
- 1,100+ downloads of hermes-tweet on ClawHub ([source](https://clawhub.ai/xquik/skills/hermes-tweet)) <!-- trust:clawhub-hermes-tweet 1162 -->
- 7 installs of this repo's Skills on skills.sh ([source](https://skills.sh/xquik-dev/hermes-tweet)) <!-- trust:skills-hermes-tweet 7 -->
- This repo meets the OpenSSF Best Practices passing criteria ([source](https://www.bestpractices.dev/projects/13725)) <!-- trust:openssf-hermes-tweet 1 -->

Checked on 2026-10-15. See each number with its date & source on [xquik.com/trust](https://xquik.com/trust) or as [JSON](https://xquik.com/trust.json).

<!-- trust:end -->

## When to use Hermes Tweet

Use this plugin for X/Twitter search, reads, or monitoring in Hermes.
Choose an SDK for application code.

## Install

Install and enable the plugin.

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

Hermes scans plugins during install and update. Review any warning before
continuing. 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.

If you manage the Hermes Python environment yourself, add the `hermes-tweet`
PyPI package to it. Then enable the plugin.

```bash
hermes plugins enable hermes-tweet
```

Install a local checkout with this command.

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

## Configure

Create an API key in Xquik. Then set it in your environment.

```bash
export XQUIK_API_KEY="xq_..."
```

These settings are optional.

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

Restart Hermes after changing environment variables.

## Tools

| 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. Disabled 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.

## Common Twitter API tasks

Start with `tweet_explore`. Invoke only the path returned by the catalog.

| Task | Catalog query | Tool |
| --- | --- | --- |
| Search X 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.

## 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`.

## Slash commands

| Command | Purpose |
| --- | --- |
| `/xstatus` | Show Xquik account and usage status. |
| `/xtrends` | Show current X trends. |

## Development

Regenerate the catalog from the canonical OpenAPI schema.

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

Run all checks.

```bash
uv run --python 3.12 --group dev ruff format --check .
uv run --python 3.12 --group dev ruff check --ignore-noqa .
uv run --python 3.12 --group dev basedpyright
uv run --python 3.12 --group dev mypy
uv run --python 3.12 --group dev pytest --cov=hermes_tweet --cov=tests --cov-report=term-missing --cov-fail-under=100
uv run --python 3.12 --group dev bandit -c pyproject.toml -r hermes_tweet scripts fuzz
uv run --python 3.12 --group dev pip-audit
uv run --python 3.12 --group dev bash scripts/check_reproducible.sh
uv run --python 3.12 --group dev python -m build
uv run --python 3.12 --group dev twine check dist/*
```

## Links

- [Xquik API reference](https://docs.xquik.com/api-reference/overview)
- [Xquik authentication](https://xquik.com/auth.md)
- [Context7 guide](https://context7.com/xquik-dev/hermes-tweet)
- [Integration patterns](docs/INTEGRATION_PATTERNS.md)
- [Hermes runtime hosts](docs/HERMES_SURFACES.md)
- [Organization support policy](https://github.com/Xquik-dev/.github/blob/main/SUPPORT.md)
- [Security policy](SECURITY.md)
- [Contribution guide](https://github.com/Xquik-dev/.github/blob/main/CONTRIBUTING.md)

## More Xquik tools

- [X (Twitter) scraper API & Twitter MCP server](https://github.com/Xquik-dev/x-twitter-scraper) with REST, MCP & Skill setup.
- Twitter API SDKs for [TypeScript](https://github.com/Xquik-dev/x-twitter-scraper-typescript), [Python](https://github.com/Xquik-dev/x-twitter-scraper-python), [Go](https://github.com/Xquik-dev/x-twitter-scraper-go), [Ruby](https://github.com/Xquik-dev/x-twitter-scraper-ruby), [Java](https://github.com/Xquik-dev/x-twitter-scraper-java), [Kotlin](https://github.com/Xquik-dev/x-twitter-scraper-kotlin), [C#](https://github.com/Xquik-dev/x-twitter-scraper-csharp) & [PHP](https://github.com/Xquik-dev/x-twitter-scraper-php).
- [Twitter CLI & X CLI](https://github.com/Xquik-dev/x-twitter-scraper-cli) for terminal workflows.
- [Twitter advanced search operators](https://github.com/Xquik-dev/x-twitter-advanced-search) with tested examples.
- [Xquik X API & Twitter scraper](https://xquik.com) and the [Twitter API documentation](https://docs.xquik.com/api-reference/overview).

## License

[MIT](LICENSE)

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

© Xquik · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

hermes-tweet by other authors comes first.

hermes-tweet Xquik hermes-tweet adds Hermes Agent tools for public X/Twitter research and for private or state-changing operations that need explicit approval. CX Codex ★ 42,780repo stars tweetclaw Xquik-dev tweetclaw is a Claude Code skill for X/Twitter via Xquik and OpenClaw. It searches tweets, monitors accounts, exports followers, and requires approval for consequential actions. CX Codex +1 ★ 97repo stars fetch-tweet OpusGameLabs fetch-tweet extracts post text, media files, and engagement metrics from X without JavaScript rendering. It retrieves structured JSON directly through the fxtwitter API. CX Codex +1 901installs tweet-writer sanky369 tweet-writer — a skill for X/Twitter that generates tweets and threads by researching what works in your niche right now, then offering multiple hook variants and a full thread with alternates to test. CX Codex +1 325installs command-viral-tweet softaworks command-viral-tweet — a Claude Code plugin that transforms a rough tweet draft into three optimized versions for X. Analyzes engagement drivers and outputs posting strategy for each variant. ★ 2,707repo stars x-growth social-media-skills x-growth is a Claude Code skill for planning content and engagement to grow on X. It activates for requests about reach, posting strategy, Premium, or how the X algorithm works. CX Codex +1 1,200installs viral-tweet softaworks viral-tweet converts rough draft thoughts into high-engagement posts tailored to the recommendation system of X. CX Codex +1 ★ 2,707repo stars

From the same set391

The whole set →
jimeng-skills jimeng-skills runs a production storyboard pipeline for short dramas using six dedicated role subagents. It coordinates the process from raw script intake to verified scene prompts and exports. CX Codex ★ 1,596repo stars jev-social jev-social is a Claude Code plugin that researches Instagram, TikTok, and LinkedIn in Chrome and builds reports with source citations. The agent selects searches, profile or post views, and comment reads. CX Codex ★ 1,596repo stars jetformat Points the agent at the local jetformat CLI instead of hand-rolling PDF bytes or unzipping Office files. Useful when a task ends in a converted, merged or rendered document. CX Codex ★ 1,596repo stars jk jk jenkins controller workflows styled after GitHub CLI: trigger runs, tail console logs, download build artifacts, and inspect jobs in Claude Code. CX Codex ★ 1,596repo stars gh-project-plugin The gh-project-plugin plugin creates GitHub repositories from Codex using native menus, infers sensible defaults, and clones the project locally after you confirm. CX Codex ★ 1,596repo stars fxmacrodata fxmacrodata connects Claude to official macroeconomic statistics, central bank interest rates, and release calendars via hosted MCP. CX Codex ★ 1,596repo stars foundry The foundry plugin for Claude Code and Codex audits ad accounts, prepares English and Arabic client reports, and calculates ROAS. Live campaign changes require terminal approval. CX Codex ★ 1,596repo stars firecrawl Skills to search, scrape, crawl, and map websites directly using the Firecrawl CLI inside agent sessions. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open