mcpField
C
custom-object-management

custom-object-management

github.com/hubspotデータ・データベース281.7k 回インストール今日更新
リポジトリ

custom-object-management について

HubSpotのカスタムオブジェクトスキーマを検出、確認、作成し、メタデータを更新または削除するスキルです。独自のレコードタイプを定義し、標準のオブジェクトコマンドで扱うHubSpot運用者向けです。

主な機能

  1. 01カスタムスキーマの一覧表示と確認
  2. 02プロパティとラベルを含むスキーマ作成
  3. 03スキーマのラベルと説明の更新
  4. 04保護手順によるスキーマ削除
  5. 05オブジェクトコマンドでのカスタム型の利用

活用シーン

  1. 01カスタムオブジェクト型の登録状況確認
  2. 02新しいレコード型のスキーマ定義
  3. 03プロパティを変えずにラベルや説明を修正
  4. 04保護手順によるスキーマとレコードの削除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hubspot/agent-cli-skills --skill custom-object-management

インストール後、Claude Code で/custom-object-managementを入力して読み込まれたか確認します。

詳細

信頼できる情報源

hubspot schemas --help が正式な情報源です。サブコマンド: list、get、create、update（メタデータのみ）、delete（破壊的）。schemas list/get/create/update は OAuth ログインまたはサービスキーで動作します。schemas delete はサービスキー専用（AppTokenOnly）です — HUBSPOT_ACCESS_TOKEN を設定してください。まず bulk-operations/SKILL.md を読んでください — ここにあるすべてのコマンドはその JSONL 規約を使用しており、schemas delete はそのドライラン / ダイジェスト / 確認のフローを使用します。

既存のスキーマを検出する

hubspot schemas list                                       # JSONL: name, label, singular, objectTypeId, source
hubspot schemas list | jq 'select(.source=="custom")'      # custom only
hubspot objects types | jq -c 'select(.source=="custom")'  # same set, also shown to confirm `--type` resolves

name は他のすべてのコマンドが受け取る値です。objectTypeId（例: 2-12345678）はワークフローの PLATFORM_FLOW ターゲットにのみ必要です。

1 つのスキーマを検査する

hubspot schemas get --type pets

完全な定義を返します — プロパティ、関連付け、ラベル、requiredProperties、primaryDisplayProperty、fullyQualifiedName。必要に応じて jq で整形してください（bulk-operations/resources/json-patterns.md を参照）。

スキーマを作成する

JSON ボディを構築してパイプします（または --file を渡します）。最小限の有効なボディ:

{
  "name": "equipment",
  "labels": {"singular": "Equipment", "plural": "Equipment"},
  "primaryDisplayProperty": "equipment_name",
  "requiredProperties": ["equipment_name"],
  "properties": [
    {"name": "equipment_name", "label": "Name", "type": "string", "fieldType": "text"}
  ],
  "associatedObjects": ["contacts"]
}

cat equipment-schema.json | hubspot schemas create --dry-run   # preview
hubspot schemas create --file equipment-schema.json            # execute

後から hubspot properties create --type <name> ... でプロパティを追加してください。

スキーマのメタデータを更新する

update はラベル / 説明のみをパッチします。プロパティの編集は hubspot properties を通じて行います。

echo '{"labels":{"singular":"Device","plural":"Devices"}}' | hubspot schemas update --type equipment

update は --dry-run → ダイジェスト → --digest --confirm <name> を付けて再実行、という流れもサポートします（パターンについては bulk-operations/SKILL.md を参照）。

スキーマを削除する（破壊的）

スキーマの削除は破壊的で取り消し不可能です — スキーマおよびその型のすべてのレコードを完全に削除します。これは MetadataDestroy としてゲートされています: すべての削除には最初に --dry-run が必要で、その後 5 分以内に --digest <hash> --confirm <name> を付けて再実行します。

bulk-operations/SKILL.md に記載されている 3 ステップのフロー（「安全な破壊的ワークフロー」）に従ってください。スキーマの場合、確認値はスキーマ名です:

hubspot schemas delete --type equipment --dry-run
# → digest=blast-... ; apply_command_hint shows: --digest <hash> --confirm 'equipment'
hubspot schemas delete --type equipment --digest <hash> --confirm equipment

最近のスキーマ削除を監査するには hubspot history --since 24h --kind MetadataDestroy を確認してください。

作成後のスキーマの使用

スキーマが存在すれば、すべての hubspot objects ... コマンドがその name を --type として受け付けます（例: --type pets）。レコードの CRUD、検索、関連付け、一括アップサート — すべて標準オブジェクトと同一です。これらのフローをここで再実装しないでください。bulk-operations/SKILL.md と crm-lookup を参照してください。

コメント

Markdown 対応