hermes-tweet

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Hermes Tweet

Hermes Tweet adds an X/Twitter toolset to Hermes Agent. It is useful for social listening, account research, launch monitoring, support triage, giveaway audits, and controlled publishing workflows where actions stay explicit.

Hermes Tweet为Hermes Agent添加了一套X/Twitter工具集，适用于社交监听、账号研究、发布监控、支持分流、抽奖审核以及操作需明确管控的发布工作流。

When to Use This Skill

使用时机

Use this skill when the user wants to:

Install Hermes Tweet into a Hermes Agent runtime
Discover available X/Twitter read and action routes
Read X/Twitter account, tweet, trend, monitor, or search data
Summarize public signal before drafting responses or campaigns
Keep account-changing actions gated behind explicit operator intent

当用户需要以下操作时，可使用此技能：

将Hermes Tweet安装到Hermes Agent运行环境中
探索可用的X/Twitter读取及操作路由
读取X/Twitter账号、推文、趋势、监控或搜索数据
在起草回复或营销活动前汇总公开信号
让会改变账号状态的操作需经操作员明确授权后方可执行

Setup

设置步骤

Install the package into the Hermes Python environment, then enable the plugin:

bash

~/.hermes/hermes-agent/venv/bin/python -m pip install hermes-tweet
hermes plugins enable hermes-tweet

Set the API key on the Hermes runtime host:

bash

export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Keep

HERMES_TWEET_ENABLE_ACTIONS

false for read-first sessions. Set it to

true

only for sessions that intentionally need posting, replies, DMs, follows, webhooks, monitors, media changes, or other account-changing routes.

将软件包安装到Hermes Python环境中，然后启用插件：

bash

~/.hermes/hermes-agent/venv/bin/python -m pip install hermes-tweet
hermes plugins enable hermes-tweet

在Hermes运行主机上设置API密钥：

bash

export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

对于以读取为主的会话，保持

HERMES_TWEET_ENABLE_ACTIONS

为false。仅当会话明确需要发布、回复、私信、关注、Webhook、监控、媒体变更或其他会改变账号状态的路由时，才将其设置为

true

。

Inputs

输入信息

Ask for these inputs before selecting routes:

Objective: research, monitoring, support triage, giveaway audit, or action prep
Target: account handle, tweet URL, keyword, list, monitor, or trend
Time window and freshness needs
Whether any account-changing action is in scope
Confirmation that the Hermes runtime has
```
XQUIK_API_KEY
```

选择路由前需确认以下输入：

目标：研究、监控、支持分流、抽奖审核或操作准备
对象：账号 handle、推文URL、关键词、列表、监控项或趋势
时间范围及实时性需求
是否包含会改变账号状态的操作
确认Hermes运行环境已配置
```
XQUIK_API_KEY
```

Workflow

工作流

Search the bundled endpoint catalog with
```
tweet_explore
```
to find matching routes.
Read X/Twitter data through
```
tweet_read
```
after selecting a catalog route.
Execute account-changing routes with
```
tweet_action
```
only after explicit approval.
Keep API keys in environment variables or the Hermes runtime env file.
Do not paste credentials into prompts, issues, PR comments, or tool inputs.
Load workflow patterns when the user asks for a campaign, monitor, support, or giveaway workflow instead of a single read.

使用
```
tweet_explore
```
搜索内置的端点目录，找到匹配的路由。
选择目录路由后，通过
```
tweet_read
```
读取X/Twitter数据。
仅在获得明确批准后，使用
```
tweet_action
```
执行会改变账号状态的路由。
将API密钥存储在环境变量或Hermes运行环境配置文件中。
请勿在提示语、问题、PR评论或工具输入中粘贴凭据。
当用户需要营销活动、监控、支持或抽奖工作流而非单次读取操作时，加载工作流模式。

Tool Model

工具模型

Tool	Purpose
`tweet_explore`	Search the bundled endpoint catalog without using the API key.
`tweet_read`	Call catalog-listed read-only endpoints when `XQUIK_API_KEY` is set.
`tweet_action`	Call action routes only when action gating is enabled.

工具	用途
`tweet_explore`	无需使用API密钥即可搜索内置的端点目录。
`tweet_read`	当设置好 `XQUIK_API_KEY` 后，调用目录中列出的只读端点。
`tweet_action`	仅在启用操作管控时调用操作路由。

Output Format

输出格式

Return concise operational output:

text

Summary:
- What was checked and why

Read routes:
- Catalog path, input, and result summary

Action plan:
- Proposed account-changing actions, each awaiting explicit approval

Next check:
- Follow-up route or monitoring cadence when useful

返回简洁的操作输出：

text

摘要:
- 检查内容及原因

读取路由:
- 目录路径、输入及结果摘要

行动计划:
- 拟执行的账号变更操作，每项均需等待明确批准

后续检查:
- 必要时的后续路由或监控频率

Usage Examples

使用示例

Research an account before drafting a reply:

text

Use Hermes Tweet to inspect recent public context for @example before drafting a reply.
Keep actions disabled.

Monitor a launch keyword:

text

Track X/Twitter mentions for "Example Launch" today.
Summarize themes and notable accounts. Do not post.

Prepare a guarded post:

text

Draft a launch tweet and list the exact tweet_action call you would use.
Wait for approval before any action route.

Capture structured route notes:

json

{
  "objective": "support-triage",
  "route": "/api/v1/x/search",
  "action_gate": "disabled",
  "approval_required": true
}

起草回复前研究账号：

text

使用Hermes Tweet查看@example的最新公开内容，为起草回复做准备。
禁用操作功能。

监控发布关键词：

text

今日追踪X/Twitter上关于"Example Launch"的提及内容。
汇总主题及知名账号。请勿发布内容。

准备受管控的发布内容：

text

起草一条发布推文，并列出你将使用的`tweet_action`调用详情。
在执行任何操作路由前等待批准。

捕获结构化路由记录：

json

{
  "objective": "support-triage",
  "route": "/api/v1/x/search",
  "action_gate": "disabled",
  "approval_required": true
}

Troubleshooting

故障排除

If only
```
tweet_explore
```
appears, configure
```
XQUIK_API_KEY
```
on the Hermes runtime host and reload or restart the active Hermes session.
If action routes are unavailable, keep reading or set
```
HERMES_TWEET_ENABLE_ACTIONS=true
```
only for an approved action session.
If a route does not match, use
```
tweet_explore
```
again and choose a catalog-listed path instead of guessing endpoints.

如果仅能使用
```
tweet_explore
```
，请在Hermes运行主机上配置
```
XQUIK_API_KEY
```
，并重新加载或重启当前Hermes会话。
如果无法使用操作路由，请继续读取操作，或仅在获得批准的操作会话中设置
```
HERMES_TWEET_ENABLE_ACTIONS=true
```
。
如果路由不匹配，请再次使用
```
tweet_explore
```
，选择目录中列出的路径，而非自行猜测端点。

Best Practices

最佳实践

Treat Hermes Tweet as the Hermes-native X/Twitter layer, not a generic API wrapper.
Keep research and monitoring workflows read-only by default.
Use Desktop or gateway operator review before account-changing calls.
Validate the exact catalog path before calling
```
tweet_read
```
or
```
tweet_action
```
.
Restart gateway, cron, or long-running Hermes sessions after env changes.

将Hermes Tweet视为Hermes原生的X/Twitter层，而非通用API包装器。
默认将研究和监控工作流设置为只读模式。
在执行账号变更操作前，需经桌面或网关操作员审核。
调用
```
tweet_read
```
或
```
tweet_action
```
前，确认目录路径的准确性。
修改环境变量后，重启网关、定时任务或长期运行的Hermes会话。

hermes-tweet

Original

Translation

Hermes Tweet

Hermes Tweet

When to Use This Skill

使用时机

Setup

设置步骤

Inputs

输入信息

Workflow

工作流

Tool Model

工具模型

Output Format

输出格式

Usage Examples

使用示例

Troubleshooting

故障排除

Best Practices

最佳实践

See Also

相关链接