スキル hubspot-automation
📦

hubspot-automation

低リスク 🌐 ネットワークアクセス

AI で HubSpot CRM 運用を自動化

手動の CRM データ入力とパイプライン管理は毎週数時間を消費します。このスキルは、AI 駆動のワークフローを通じて HubSpot の連絡先、企業、取引、チケットの操作を自動化します。

対応: Claude Codex Code(CC)
🥉 72 ブロンズ
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「hubspot-automation」を使用しています。 メールドメインが @acme.com の連絡先を検索し、氏名と企業関連付けを返す

期待される結果:

条件に一致する 12 件の連絡先をFound:John Smith (Acme Corp)、Jane Doe (Acme Corp)、Bob Johnson (Acme Corp)。結果には下流操作のための連絡先 ID が含まれます。

「hubspot-automation」を使用しています。 メール、氏名、電話番号を含む 3 件の新規連絡先をバッチ作成

期待される結果:

3 件の連絡先を正常に作成しました。返された ID: 12345678, 12345679, 12345680。すべての連絡先が現在検索可能で、企業や取引と関連付けできます。

「hubspot-automation」を使用しています。 すべての取引パイプラインを一覧表示し、主要営業パイプラインのステージを表示

期待される結果:

2 つのパイプラインをFound: 'Sales Pipeline' (ID: abc123) ステージ:Prospecting, Qualification, Proposal, Closed Won, Closed Lost。'Partner Pipeline' (ID: def456) ステージ:Lead, Opportunity, Closed。

セキュリティ監査

低リスク
v1 • 2/25/2026

Static analyzer flagged 129 external_commands patterns which are FALSE POSITIVES - these are Markdown backticks for code formatting, not Ruby shell execution. One legitimate network dependency detected (rube.app/mcp server) which is the intended MCP architecture. No malicious patterns, credential exfiltration, or command injection vectors found. Skill is safe for publication with network access disclosure.

1
スキャンされたファイル
184
解析された行数
2
検出結果
1
総監査数
低リスクの問題 (1)
External MCP Server Dependency
Skill requires connection to external MCP server at rube.app/mcp for HubSpot API access. This is legitimate architecture but represents a third-party dependency.

リスク要因

🌐 ネットワークアクセス (1)
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
50
コミュニティ
88
セキュリティ
91
仕様準拠

作れるもの

営業チームの連絡先インポート

既存の連絡先を検索して重複を回避した後、バッチ作成し、関連する企業や取引に関連付けることで、展示会収集のリードをインポートして重複除外を行う。

サポートチケットのトリアージ自動化

ステータスと日付範囲でチケットを検索し、期限超過アイテムを特定し、プロパティを更新して優先ケースをチームの即時対応としてフラグ付けする。

パイプライン健全性レポート

すべての取引パイプラインとステージを取得し、ステージと担当者別に取引を検索し、パイプライン速度とコンバージョン率の要約レポートを生成する。

これらのプロンプトを試す

新規連絡先の作成
John Smith という HubSpot 連絡先を、メール john.smith@example.com、電話 555-0100、会社 Acme Corp で作成する。まず接続がアクティブか確認し、作成前にこのメールの既存連絡先を検索して重複を回避する。
企業のバッチインポート
HubSpot にインポートする企業が 250 社ある。100 件ずつにチャンキングし、ドメイン名で既存企業を検索して重複を防止し、新規のみ作成する。後で連絡先と関連付けるために、返されたすべての企業 ID を保存する。
取引パイプライン分析
すべての取引パイプラインとステージを取得する。Sarah Johnson が担当し、過去 30 日間に作成された「Qualification」ステージの取引を検索する。すべての結果をページネーションで取得し、合計数、合計取引額、平均取引サイズを要約する。
カスタムプロパティ設定
オプション:Organic Search、Paid Ads、Referral、Trade Show、Direct を持つ「Lead Source Channel」という名前の列挙型カスタムプロパティを連絡先用に作成する。まず既存プロパティを確認して既に存在しないことを確認し、「Lead Information」プロパティグループに作成する。

ベストプラクティス

  • CRM 操作を実行する前に必ず HUBSPOT_GET_ACCOUNT_INFO を呼び出して接続ステータスを確認する
  • 連絡先や企業を作成する前にメールやドメインで既存レコードを検索して重複を防止する
  • フィルタクエリを構築する前に READ_ALL_PROPERTIES_FOR_OBJECT_TYPE を使用して内部プロパティ名を発見する
  • バッチ操作を最大 100 件ずつにチャンキングし、バッチ間で返された ID を保存する
  • 完全な結果セットを取得するために paging.next.after が存在する限りページネーションカーソルを追従する

回避

  • 重複検索せずに連絡先を作成 - 断片化した連絡先レコードになる
  • フィルターで表示ラベルの代わりに内部プロパティ名を使用しない - エラーなしで結果が 0 件になる
  • バッチ制限を無視して単一呼び出しで 500 件以上のレコードを作成しようとする - API がリクエストを拒否する
  • 日付形式がエンドポイント間で一貫していると仮定 - epoch-ms と ISO 文字列の両方に防御的にパーズする

よくある質問

このスキルを使用する前に何が必要ですか?
AI クライアントで Rube MCP が構成されており、Composio を介した HubSpot 接続がアクティブである必要があります。ワークフロー開始前に HUBSPOT_GET_ACCOUNT_INFO を実行して接続ステータスを確認します。
連絡先の重複をどのように回避しますか?
作成前に常に連絡先メールで HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA を呼び出します。結果が存在する場合は、新規作成ではなく既存レコードを更新します。
なぜ「Property values were not valid」エラーが発生しますか?
これは誤ったプロパティ名または列挙値を使用している場合に発生します。HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE を使用して正確な内部プロパティ名と有効なオプション値を発見します。
100 件以上のレコードをインポートするにはどうしますか?
データを最大 100 件ずつのバッチにチャンキングします。各バッチを個別に処理し、次のバッチに進む前に返された ID を保存します。
HubSpot でカスタムフィールドを作成できますか?
はい。HUBSPOT_CREATE_PROPERTY_FOR_SPECIFIED_OBJECT_TYPE を使用してカスタムプロパティを作成できます。列挙型フィールドの場合は、options 配列で value と label オプションを事前に定義します。
特定の取引ステージのパイプライン ID をどのように見つけますか?
objectType 'deals' で HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE を呼び出し、特定のパイプライン内のステージ ID を取得するために HUBSPOT_RETRIEVE_PIPELINE_STAGES を使用します。

開発者の詳細

ファイル構成

📄 SKILL.md