关于 hyper-cli
hyper-cli 是通过 Hyper 在终端运行营销技能所用工具的命令行界面。它适用于已配置 Hyper MCP、连接所需集成并完成 CLI 认证的用户,支持查找工具、查看参数架构及使用 JSON 参数调用工具。
主要功能
- 01检查 CLI 认证和工作区
- 02搜索可用工具
- 03查看工具参数架构
- 04使用 JSON 参数调用工具
- 05列出并切换已连接账户
适用场景
- 01查找营销技能需要的工具
- 02调用工具前确认所需参数
- 03从终端运行营销工具
MCP 相关
需要为工作区配置 Hyper MCP。CLI 通过 Hyper 调用工具;MCP 客户端的设置需另行参考 Hyper MCP 页面。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hyperfx-ai/ marketing-skills --skill hyper-cli安装后在 Claude Code 中输入/hyper-cli确认已加载。
详细介绍
Hyper CLI
使用 hyperai 从终端运行任意营销技能。技能会为每个工具指定一个名称,即其规范名称,例如 gmail_messages_send。CLI 会直接运行该名称。
要求
- 已为工作区配置 Hyper MCP。 https://app.hyperfx.ai/mcp
- 已连接所需集成,请访问 https://app.hyperfx.ai/apps。配套的营销技能会列出所需的集成。
- 已安装并完成身份验证的 Hyper CLI。 使用
hyperai info验证。
如果 hyperai info 失败,请停止操作,并告知用户先对 CLI 进行身份验证,再调用工具。
四个命令
| 需求 | 命令 |
|---|---|
| 确认身份验证和工作区 | hyperai info |
| 查找工具 | hyperai search "<what you want to do>" |
| 查看工具的输入架构 | hyperai describe <name> --parameters |
| 运行工具 | hyperai call <name> --json '{...}' |
<name> 是技能中的规范工具名称,例如 meta_ads_adaccount_list。CLI 也接受将同一名称拆分为多个单词的形式(meta-ads adaccount list);技能不会使用这种形式。
如果你的 CLI 版本不接受规范名称,请运行 hyperai search "<name>":搜索结果会显示要使用的确切 hyperai call ... 命令行。使用 hyperai update 更新 CLI。
已连接的账户
| 需求 | 命令 |
|---|---|
| 列出某个工具包已连接的账户 | hyperai call connections_list --json '{"toolkit_id": "gmail"}' |
| 为当前 shell 切换活动账户 | hyperai call connections_use --json '{"toolkit_id": "gmail", "auth_id": "<auth_id>"}' |
活动账户按 shell 会话保存,就像 MCP 按会话保存活动账户一样。
参数
- 使用
--json将参数作为一个 JSON 对象传入。CLI 会在调用前根据工具的架构验证参数。 - 如果调用因参数错误而失败,请运行
hyperai describe <name> --parameters并查看架构。不要使用相同参数重试。 - 对于大型结果,添加
--raw以获取未格式化的 JSON。
示例
hyperai info
hyperai search "send an email"
hyperai describe gmail_messages_send --parameters
hyperai call gmail_messages_send --json '{"to": "[email protected]", "subject": "Hello", "body": "Hi Jane"}'
不在此范围内
| 需求 | 技能 |
|---|---|
| 要发送什么、发送给谁以及按什么顺序发送 | 负责该任务的营销技能,例如 cold-email-outreach |
| MCP 客户端设置 | Hyper MCP 页面:https://app.hyperfx.ai/mcp |
评论
支持 Markdown