ベータHubSpot Agent CLI を使用する

HubSpot Agent CLI は、（Claude Code：）、（Claude Cowork：）、（OpenAI Codex：）などの AI コーディングエージェントを、お客様の HubSpot アカウントに連携させます。Agent CLIをHubSpotに接続すると、AIエージェントに、反復的なCRMタスクの処理、データの分析、要約の作成、およびアカウント全体のプロセス管理の支援を依頼できるようになります。AIエージェントにタスクを委任すると、エージェントはAgent CLIを使用して、ユーザーに代わって日常業務を自動化できるため、チームは戦略的な取り組みにより多くの時間を割くことができます。

たとえば、毎週手作業でレコードを確認する代わりに、AIエージェントに、不完全なレコードの特定、パイプライン活動の要約、あるいはHubSpotの情報を用いたアカウントレビューの作成を依頼することができます。

カスタムスクリプトを作成したり、ターミナルでHubSpot Agent CLIを手動で使用したりしたい開発者の場合は、および開発者向けドキュメントを参照してください。

始める前に

HubSpot Agent CLI の使用を開始する前に、AI コーディングエージェントへのアクセス権があることを確認してください。対応しているエージェントには、Claude Code、Claude Cowork、OpenAI Codex、およびその他多くの互換性のあるAIコーディングエージェントが含まれます。

ご注意：チームまたはエンタープライズアカウントでClaude Coworkをご利用の場合、CLIのインストールや実行を行う前に、組織の管理者がapi.hubapi.comを許可リストに追加する必要がある場合があります。Claude Coworkにおけるの許可リスト設定について、詳しくはをご覧ください。

HubSpot Agent CLI を通じて AI エージェントがアクセスできるもの

HubSpot Agent CLI は、接続された HubSpot ユーザーの権限を使用して操作を実行できます。ユーザーの権限によっては、これにはアカウント内のレコードの作成、更新、または削除が含まれる場合があります。

HubSpot Agent CLI を接続すると、AIエージェントは HubSpot アカウント全体の情報を活用できるようになります。これには以下が含まれます：

• 連絡先、企業、取引、チケット、カスタムオブジェクト、およびその他のCRMレコード。
• ワークフロー。
• パイプラインとパイプラインの各段階。
• プロパティとカスタムプロパティ。
• レコード間の関連性。
• アクティビティ履歴。

ご注意：では、CRMデータに変更を適用する前に、AIが生成した推奨事項や提案されたアクションを必ず確認しています。

ベストプラクティス

HubSpotに接続されたAIエージェントを利用する際は、以下の点に注意してください：

• データを変更するアクションを使用する前に、まずレポート作成、要約、分析のタスクから始めましょう。
• 変更を適用する前に、生成された推奨事項や大規模な更新内容を確認してください。
• 一部の操作により、HubSpotのデータが削除されたり上書きされたりする場合があります。可能な場合は、--dry-runオプションを使用して、変更を適用する前にプレビューを行ってください。
• 望ましい結果を明確に説明した指示を使用してください。
• 組織のデータガバナンスおよびセキュリティポリシーに従ってください。

HubSpot Agent CLI を接続する

以下の手順に従って、エージェントにHubSpot Agent CLIのインストールを依頼してください。開発者の方は、について、HubSpot Agent CLIを手動でインストールする方法の詳細をこちらでご確認ください：。

1. Cowork（）やCodex（）などのAIエージェントを開いてください。
2. Agent 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.

3. プロンプトが表示されたら、HubSpotアカウントにサインインしてください。
4. 要求されている権限を確認してください。
5. ［Connect app（アプリを接続）］をクリックします。

認証が完了すると、AIエージェントは、お客様の権限に基づいてHubSpotのデータにアクセスできるようになります。

まずは、以下のサンプルプロンプトのいずれかを使用してください。

活用事例の例

以下の例では、さまざまなチームが、HubSpot Agent CLIを介して接続されたAIエージェントをどのように活用できるかを示しています。このエージェントは、大量のCRMデータを確認する必要がある、繰り返し行われる業務作業において特に役立ちます。

マーケティングチーム

タスク：フォローアップやデータ整理が必要な連絡先を特定する。

AIエージェント「」向けのプロンプト例：毎週月曜日の午前8時に、関連する取引がなく、直近の販売活動がなく、または重要な情報補完フィールドが欠落している「適合度の高い見込み客」を特定し、優先順位を付けた整理リストと推奨される次のアクションをRevOpsに送信してください。

その他の例としては、次のようなものがあります：

• ブランドのトーン・アンド・スタイルガイドラインに沿っていない件名やCTAが含まれていないか、メールキャンペーンを点検してください。
• コンバージョン率の高さと相関関係がある、成果の高いランディングページに見られるメッセージングのパターンを特定する。
• ナーチャリング・シーケンスのメールを開封していない連絡先を対象とした、再エンゲージメントリストを作成します。
• ウェビナーキャンペーンから獲得した商談の、現在のパイプライン状況を追跡します。
• 最適な顧客層について、業種、企業規模、およびリードの獲得経路の傾向を特定する。
• アクティブなシーケンスを監視し、メールの開封率に著しい低下が見られた場合はフラグを立てる。

営業および収益管理チーム

タスク：パイプラインの状態を監視し、対応が必要な案件を特定する。

AIエージェント「」向けのプロンプト例：毎朝7時に、私のパイプラインの中から、今週成約予定であり、かつ過去5日間活動がない案件を確認し、その概要を私に送信してください。

その他の例としては、次のようなものがあります：

• フォローアップや見直しが必要な、休止状態の高価値案件を見つけ出す。
• 取引、サポート、メール、およびメモの履歴をまとめて、顧客との打ち合わせの準備を整えてください。
• 成約に至らなかった案件を分析し、商談が最も長く停滞していたパイプラインの段階を特定する。
• 成約日が近づいているものの、最近の動きが見られない取引の毎日の概要を作成してください。

営業リーダー

タスク：通話記録を分析し、コーチングや製品に関するフィードバックのテーマを抽出する。

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）および（OpenAI Codex）でのスキルの活用方法について、詳しくはこちらをご覧ください。

HubSpot Agent CLI へのアクセス権限を管理する

スーパー管理者（）は、「」アプリのインストール管理（）ベータ版に参加することで、HubSpot Agent CLIへの接続を許可するユーザーを管理できます。

ユーザーがHubSpot Agent CLIに接続する権限を持っていない場合は、接続する前に管理者から承認を得る必要があります。

HubSpotアカウントで、どのアプリをインストールできるかを管理する「」の詳細については、をご覧ください。