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 を認証するようユーザーに伝えてください。

4 つのコマンド

目的	コマンド
認証とワークスペースを確認する	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"}'
このシェルで使用するアクティブなアカウントを切り替える	hyperai call connections_use --json '{"toolkit_id": "gmail", "auth_id": "<auth_id>"}'

アクティブなアカウントは、MCP がセッションごとに保持するのと同じように、シェルセッションごとに保持されます。

引数

• 引数は --json を使って 1 つの 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 クライアントのセットアップ	https://app.hyperfx.ai/mcp の Hyper MCP ページ