HubSpot Agent CLI を使用する
更新日時 2026年9月7日
以下の 製品でご利用いただけます（別途記載されている場合を除きます）。
HubSpot Agent CLIは、ChatGPTアプリ、Claudeアプリ、Claude CodeなどのAIコーディングエージェントを、HubSpotアカウントに連携させます。Agent CLIをHubSpotに接続すると、AIエージェントに、反復的なCRMタスクの処理、データの分析、要約の作成、およびアカウント全体のプロセス管理の支援を依頼できるようになります。AIエージェントにタスクを委任すると、エージェントはAgent CLIを使用して、ユーザーに代わって定型業務を自動化できるため、チームは戦略的な取り組みにより多くの時間を割くことができます。
たとえば、毎週手作業でレコードを確認する代わりに、AIエージェントに、不完全なレコードの特定、パイプラインアクティビティーの要約、あるいはHubSpotの情報を用いたアカウントレビューの作成を依頼することができます。
カスタムスクリプトを作成したり、ターミナルでHubSpot Agent CLIを手動で利用したりしたい開発者の方は、HubSpotの開発者向けドキュメントをご参照ください。
始める前に
HubSpot Agent CLI の使用を開始する前に、AIコーディングエージェントにアクセスできることを確認してください。対応しているエージェントには、ChatGPTアプリ、Claudeアプリ、Claude Code、およびその他多くの互換性のあるAIコーディングエージェントが含まれます。
ご注意： TeamまたはEnterpriseアカウントでClaude Coworkをご利用の場合、CLIのインストールや実行を行う前に、組織の管理者がapi.hubapi.comを許可リストに登録する必要がある場合があります。Claude Coworkにおける許可リスト設定について、詳しくはこちらをご覧ください。
HubSpot Agent CLI を通じて AIエージェントがアクセスできるもの
HubSpot Agent CLI は、接続された HubSpot ユーザーの権限を使用して操作を実行できます。ユーザーの権限によっては、これにはアカウント内のレコードの作成、更新、または削除が含まれる場合があります。
HubSpot Agent CLI を接続すると、AIエージェントは HubSpot アカウント全体の情報を活用できるようになります。これには以下が含まれます：
- 連絡先、会社、取引、チケット、カスタムオブジェクト、およびその他のCRMレコード。
- ワークフロー。
- パイプラインとパイプラインのステージ。
- プロパティーとカスタムプロパティー。
- 収益関連の記録（読み取り専用）：契約書、請求書、注文書、支払い、見積書、見積書テンプレート、および定期購読（ベータ版）。
ご注意：もしあなたがスーパー管理者の場合は、アカウントをHubSpot Agent CLIの収益データベータ版にアカウントを登録することができます。
- レコードの関連付け。
- アクティビティー履歴。
ご注意： CRMデータに変更を加える前に、必ずAIが生成した推奨事項や提案されたアクションを確認してください。
ベストプラクティス
HubSpotに接続されたAIエージェントを利用する際は、次の点に注意してください：
- データを変更するアクションを使用する前に、まずレポート作成、要約、分析のタスクから始めてください。
- 変更を適用する前に、生成された推奨事項や大規模な更新内容を確認してください。
- 一部の操作により、HubSpotのデータが削除されたり上書きされたりする場合があります。可能であれば、--dry-runオプションを使用して、変更を適用する前にプレビューを表示してください。
- 望ましい結果を明確に説明したプロンプトを使用してください。
- 組織のデータガバナンスおよびセキュリティポリシーに従ってください。
HubSpot Agent CLI を接続する
以下の手順に従って、エージェントにHubSpot Agent CLIのインストールを依頼してください。開発者の方は、HubSpot Agent CLI を手動でインストールする方法について詳しくご確認ください。
- AIエージェントを開いてください。
- エージェント CLI をインストールするには、以下のプロンプトをエージェントのワークスペースに貼り付けてください。
Install the HubSpot Agent CLI in this agent workspace. If this workspace uses a POSIX shell (macOS, Linux, WSL, or Bash), run `curl -fsSL https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.sh | sh`. If it uses Windows PowerShell, run `irm https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.ps1 | iex`. Then authenticate with `hubspot auth login`, install HubSpot Agent CLI Skills with `npx skills add hubspot/agent-cli-skills`, and use `hubspot --help` to explore what's available.
- プロンプトが表示されたら、HubSpotアカウントにサインインしてください。
- 要求されている権限を確認してください。
- ［Connect app（アプリを接続）］をクリックします。
認証が完了すると、AIエージェントはユーザーの権限に基づいてHubSpotのデータにアクセスできるようになります。
まずは、以下のサンプルプロンプトのいずれかを使用してください。
活用事例の例
以下の例では、さまざまなチームがHubSpot Agent CLIを介して接続されたAIエージェントをどのように活用できるかを示しています。このエージェントは、大量のCRMデータを確認する必要がある、繰り返し行われる業務において特に役立ちます。
マーケティングチーム
タスク：フォローアップやデータ整理が必要な連絡先を特定する。
AIエージェント向けのプロンプト例：毎週月曜日の午前8時に、関連付けられた取引がなく、直近の販売アクティビティーがなく、または重要な情報補完フィールドが欠落している「高適合」の連絡先を特定し、優先順位を付けた整理リストと推奨される次のアクションをRevOpsに送信してください。
その他の例としては、次のようなものがあります：
- ブランドのブランドボイスに関するガイドラインに沿っていない件名やCTAが含まれていないか、メールキャンペーンを点検してください。
- コンバージョン率の高さと相関関係がある、成果の高いランディングページに見られるメッセージングのパターンを特定する。
- ナーチャリング・シーケンスのメールを開封していない連絡先を対象とした、再エンゲージメントリストを作成します。
- ウェビナーキャンペーンを通じて獲得した商談の、現在の取引パイプライン状況を追跡します。
- 最適な顧客層について、業種、企業規模、およびリードの獲得経路の傾向を特定する。
- アクティブなシーケンスを監視し、メールの開封率に著しい低下が見られた場合はフラグを立てる。
営業およびレベニューオペレーションチーム
タスク：パイプラインの状態を監視し、対応が必要な案件を特定する。
AIエージェントへのプロンプト例：毎朝7時に、私のパイプラインの中から、今週成約予定で、過去5日間にアクティビティーのない案件を確認し、その概要を私に送信してください。
その他の例としては、次のようなものがあります：
- フォローアップや見直しが必要な、休止状態の高価値案件を特定する。
- 取引、サポート、メール、およびメモの履歴をまとめて、顧客とのミーティングの準備を整えてください。
- 成約に至らなかった案件を分析し、商談が最も長く停滞したパイプラインの取引ステージを特定する。
- 成約日が近づいているものの、最近のアクティビティー履歴がない取引の daily summary を生成してください。
営業リーダー
タスク：コール文字起こしを分析し、コーチングや製品に関するフィードバックのテーマを抽出する。
AIエージェント向けのプロンプト例：最近のコール記録を分析し、通話時間、競合他社の言及、顧客からのフィードバック、見込み客の躊躇の傾向といったテーマを抽出した上で、コール記録の抜粋や元のコールへのリンクを掲載した、コーチングおよび製品フィードバック用のダッシュボードを作成してください。
その他の例としては、次のようなものがあります：
- 通話時間が異常に長い、あるいは短い傾向にある営業担当者やチームを特定する。
- 最近の営業コールの中で、競合他社について繰り返し言及されている箇所を見つけ出してください。
- 見込み客の躊躇要因を、セグメント、取引ステージ、または製品分野ごとに要約してください。
- コーチングや製品フィードバックのテーマを裏付ける会話記録の例を抜き出してください。
- コール分析結果を元のコールレコードや通話記録に紐づけるダッシュボードを作成してください。
RevOpsおよびCRM管理者
タスク：下流のアセットに影響を与えずに、CRMのプロパティーを整理する。
AIエージェントへのプロンプト例：CRMのプロパティーのうち、重複しているものや使用されなくなったものを特定し、ワークフロー、レポート、ビューのどこで使用されているかを表示してください。その後、変更を適用する前に、クリーンアップ計画のプレビューを表示して、フィールドの置換、削除、または並べ替えを行ってください。
その他の例としては、次のようなものがあります：
- 異なるオブジェクト間で同じ情報を収集している重複するプロパティーを特定します。
- ワークフロー、レポート、ビュー、またはレコードレイアウトに依然として表示されている、非推奨のフィールドを特定します。
- 変更を行う前に、CRMのプロパティーを削除または置換した場合の影響をプレビューしてください。
- 管理者と営業担当者が最も重要な情報を最初に確認できるよう、レコードのフィールドの順序を変更してください。
- 変更点と、まだ確認が必要な箇所をまとめたクリーンアップ概要を生成します。
運用チーム
タスク：関連するサポートチケットを統合し、整理の履歴を残しておく。
AIエージェントへのプロンプト例：重複するサポートチケットを統合し、元のチケットの詳細情報を保持した上で、各親チケットを適切なパイプラインのステージに振り分け、まだ確認が必要なレコードを記載した整理結果の概要をチームに送信してください。
その他の例としては、次のようなものがあります：
- 同じ顧客または同じ問題タイプに属する、重複している、または関連するサポートチケットを検索します。
- ソースの詳細情報を保持したまま、チケットのコンテキストを親レコードに統合する。
- 現在のステータスに基づいて、統合されたチケットを適切なパイプラインのステージに振り分けます。
- 統合前に人的な確認が必要なチケットにフラグを立てる。
- 統合されたレコード、未解決の質問、およびフォローアップ担当者を記載したクリーンアップの概要を送信してください。
サポートチーム
課題：複数のレコードを手動で開くことなく、顧客履歴を確認する。
AIエージェントへのプロンプト例：この連絡先に関する直近5件のチケットを取得し、各解決内容を要約し、繰り返し発生している問題のパターンがあればマークしてください。
その他の例としては、次のようなものがあります：
- 新しいケースを開く前に、最近のチケット履歴を確認し、顧客から繰り返し寄せられている問題を特定してください。
- 応答時間の目標値を超過したチケットを優先的に処理してください。
- 請求関連のチケットを分析し、顧客がサポートに連絡する最も一般的な理由を特定する。
- 関連する取引、サブスクリプション、およびエスカレーションの履歴を基に、チケットへの回答を作成してください。
カスタマーサクセスチーム
タスク：複数のHubSpotツールから得た情報を用いて、アカウントレビューを作成する。
AIエージェントへのプロンプト例：今週のアカウントレビューに向けて、担当している顧客アカウントごとに、進行中の案件、最近のサポートアクティビティー、および直近のNPS®スコアを要約してください。
その他の例としては、次のようなものがあります：
- 解約リスクが高まっている兆候が見られる顧客アカウントを特定する。
- 製品のエンゲージメント度が低い更新対象の連絡先を特定し、先回りしたアプローチを行う。
- 直近の売上、サポート、および顧客からのフィードバックのアクティビティーをまとめ、アカウントレビューの準備を行う。
- アカウントの成長傾向と過去の取引規模を比較することで、事業拡大の機会を特定する。
スキルライブラリを常に最新の状態に保つ
HubSpot Agent CLI Skills は、AIエージェントがHubSpotのデータや一般的なHubSpotのプロセスを扱う際に役立つ、あらかじめ定義されたガイダンスを提供します。スキルライブラリには、CRM検索、一括処理、データ品質管理タスク、ワークフロー、レポート作成、およびその他の運用業務に関するガイダンスが含まれています。
公開されているGitHubリポジトリに追加されるスキルを確認できます。
AIエージェントのワークスペースにあるスキルライブラリを更新するには、次のプロンプトを実行してください：
npx skills update
ClaudeおよびChatGPTでのスキルの活用方法について、詳しくはこちらをご覧ください。
HubSpot Agent CLI へのアクセス権限を管理する
スーパー管理者は、HubSpot Agent CLI に接続できるユーザーを管理できます。ユーザーがHubSpot Agent CLIに接続する権限を持っていない場合は、接続する前にスーパー管理者から承認を得る必要があります。HubSpotアカウントでインストール可能なアプリを管理する方法について、詳しくはこちらをご覧ください。
関連記事
