スキル hubspot-integration
📦

hubspot-integration

安全

HubSpot CRM を Claude Code と統合

認証、CRUD 操作、および Webhook に関する専門的なパターンを使用して、HubSpot CRM 統合を迅速に構築します。Node.js および Python SDK 向けの実証済み実装パターンで API の複雑さを解消します。

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

スキルZIPをダウンロード

2

Claudeでアップロード

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

3

オンにして利用開始

テストする

「hubspot-integration」を使用しています。 プライベートアプリトークンを使用して Python で HubSpot 連絡先を作成

期待される結果:

hubspot-api-client を使用した Python コードを生成。ContactObject 作成、4xx レスポンスのエラー処理、HUBSPOT_API_KEY の環境変数設定を含む

「hubspot-integration」を使用しています。 Node.js 向けに OAuth 認証を設定

期待される結果:

OAuth 認証フロー、アクセストークン保存、リフレッシュトークンロジック、保護された API 呼び出しのためのミドルウェアを実装する Node.js コードを生成

「hubspot-integration」を使用しています。 取引更新のための Webhook ハンドラを作成

期待される結果:

HubSpot 署名検証、イベント解析ロジック、取引プロパティ変更のための非同期処理パイプラインを含む Express ルートハンドラを返す

セキュリティ監査

安全
v1 • 2/25/2026

Static analysis flagged 2 false positives for 'weak cryptographic algorithm' at lines 3 and 46. These flags were triggered by documentation text mentioning 'authentication' and are not actual security issues. The file contains only legitimate HubSpot CRM integration patterns documentation with no malicious code, prompt injection attempts, or security vulnerabilities.

1
スキャンされたファイル
47
解析された行数
1
検出結果
1
総監査数
低リスクの問題 (1)
False Positive - Cryptographic Reference
Static scanner flagged 'authentication' keyword as weak cryptographic algorithm. This is documentation text only, not executable code.
監査者: claude

品質スコア

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

作れるもの

連絡先同期

アプリケーションと HubSpot CRM 連絡先間で顧客データを自動的に同期

Webhook イベント処理

連絡先作成や取引ステージ変更などの HubSpot ライフサイクルイベントを処理するハンドラを構築

カスタムオブジェクト統合

標準 CRM レコードを超えた特殊なビジネスデータ向けにカスタム HubSpot オブジェクトを作成・管理

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

基本的な連絡先作成
Node.js SDK を使用して、メール、名、姓のプロパティを持つ HubSpot 連絡先を作成
OAuth 認証セットアップ
トークン更新ロジックを含むパブリックアプリ向けの HubSpot OAuth 2.0 フローを実装
バッチインポート操作
バッチ API エンドポイントを使用して 1000 件の連絡先を HubSpot にバッチインポートするコードを記述
Webhook ハンドラ実装
署名検証付きで HubSpot 連絡先作成イベントのための Express.js Webhook ハンドラを作成

ベストプラクティス

  • 複数のレコードを作成または更新する際は、個別のリクエストではなく常にバッチ API エンドポイントを使用
  • リクエストが HubSpot から送信されていることを確認するために Webhook 署名検証を実装
  • OAuth リフレッシュトークンを安全に保存し、有効期限前に自動トークン更新を実装

回避

  • 認証に非推奨の API キーを使用しないでください
  • Webhook が利用可能な場合は HubSpot API をポーリングしないでください
  • API トークンや OAuth 認証情報をソースコードにハードコードしないでください

よくある質問

どのような HubSpot 認証方法がサポートされていますか?
このスキルは、パブリックアプリ向けの OAuth 2.0 と単一アカウント統合向けのプライベートアプリトークンをサポートしています。本番アプリケーションで複数のユーザーを扱う場合は OAuth を推奨します。
どのプログラミング言語がサポートされていますか?
このスキルは、最も一般的なバックエンド統合シナリオをカバーする Node.js および Python SDK の両方に関するパターンとコード例を提供します。
このスキルで HubSpot アカウントや API キーを作成できますか?
いいえ、このスキルは統合のためのコードパターンを生成するだけです。HubSpot 開発者ポータルを通じて、独自の HubSpot 開発者アカウント、アプリ、および API 認証情報を作成する必要があります。
HubSpot API のレート制限はどのように処理すればよいですか?
このスキルは、レート制限内で最適化するための指数バックオフとバッチ操作の実装パターンを提供します。実装では使用状況を追蹤し、大量操作のためのキューイングを実装する必要があります。
HubSpot データの取得にはポーリングより Webhook の方が優れていますか?
はい、Webhook はリアルタイム更新において大幅に効率的です。このスキルには、Webhook ハンドラ実装、署名検証、およびイベント処理のパターンが含まれています。
このスキルでカスタム HubSpot オブジェクトを作成できますか?
はい、このスキルはカスタムオブジェクトスキーマの設計と、HubSpot API を介してカスタムオブジェクトレコードの作成、読み取り、更新、削除に必要な API パターンをカバーしています。

開発者の詳細

ファイル構成

📄 SKILL.md