hubspot-master（HubSpot master 搜索） Skills下载安装命令和教程

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：hubspot-master（HubSpot master 搜索）
来源仓库：https://github.com/abdullahbeam/nexus-design-abdullah
仓库路径：skills/hubspot-master
安装命令：
npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill hubspot-master
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。不同来源提供的安装方式可能略有差异；本站展示可直接复制的安装命令，安装前请核对来源页面。

skills.shnpx skills

npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill hubspot-master

简介

作为 HubSpot 核心操作集合，提供联系人、公司、交易等对象的增删改查能力。

适合在 Codex、Claude、Cursor、Gemini CLI 中构建完整 CRM 自动化流水线时使用。
安装后通过 npx 命令添加技能，需确认 API 密钥权限覆盖所有操作类型。
建议分模块调用以避免权限冲突，并在关键操作前做幂等性校验。
使用前请检查仓库维护状态，确保技能与当前 HubSpot API 版本兼容。

SKILL.md

HubSpot Master

This is NOT a user-facing skill. It's a shared resource library referenced by HubSpot integration skills.

Purpose

Provides shared resources to eliminate duplication across:

hubspot-connect - Meta-skill for HubSpot CRM operations
hubspot-list-contacts - List contacts
hubspot-create-contact - Create contact
hubspot-update-contact - Update contact
hubspot-search-contacts - Search contacts
hubspot-list-companies - List companies
hubspot-create-company - Create company
hubspot-search-companies - Search companies
hubspot-list-deals - List deals
hubspot-create-deal - Create deal
hubspot-update-deal - Update deal
hubspot-search-deals - Search deals
hubspot-get-associations - Get CRM associations
hubspot-list-emails - List email engagements
hubspot-log-email - Log email engagement
hubspot-list-calls - List call engagements
hubspot-log-call - Log call engagement
hubspot-list-notes - List notes
hubspot-create-note - Create note
hubspot-list-meetings - List meetings
hubspot-create-meeting - Create meeting

Instead of loading this skill, users directly invoke the specific skill they need above.

Architecture: DRY Principle

Problem solved: HubSpot skills would have duplicated content (setup instructions, API docs, auth flow, error handling).

Solution: Extract shared content into hubspot-master/references/ and hubspot-master/scripts/, then reference from each skill.

Result: Single source of truth, reduced context per skill.

Shared Resources

All HubSpot skills reference these resources (progressive disclosure).

references/

setup-guide.md - Complete setup wizard

Creating Private App in HubSpot
Configuring required scopes
Getting access token
Environment configuration

api-reference.md - HubSpot API patterns

Base URL and authentication
All CRM endpoints documented
Request/response examples
Common property names

error-handling.md - Troubleshooting

Common errors and solutions
HTTP error codes
Validation error handling
Rate limiting

authentication.md - Token management

Private App setup
Token format and usage
Security best practices

scripts/

Authentication & Configuration

check_hubspot_config.py - Pre-flight validation

python check_hubspot_config.py [--json]

Argument	Required	Default	Description
`--json`	No	False	Output structured JSON for AI consumption

Exit codes: 0=configured, 1=partial, 2=not configured

When to Use: Run this FIRST before any HubSpot operation. Use to validate access token is configured, diagnose authentication issues, or check if setup is needed.

setup_hubspot.py - Interactive setup wizard

python setup_hubspot.py

No arguments - runs interactively. Guides through Private App setup, tests connection, saves to .env.

When to Use: Use when HubSpot integration needs initial setup, when check_hubspot_config.py returns exit code 2, or when user needs to reconfigure credentials.

CRM Operations - Contacts

list_contacts.py - List contacts (GET /crm/v3/objects/contacts)

python list_contacts.py [--limit N] [--properties PROPS] [--after CURSOR] [--json]

Argument	Required	Default	Description
`--limit`	No	10	Number of results (max 100)
`--properties`	No	email,firstname,lastname	Comma-separated properties
`--after`	No	-	Pagination cursor
`--json`	No	False	Output as JSON

When to Use: Use when user says "list contacts", "get contacts", "show contacts".

create_contact.py - Create contact (POST /crm/v3/objects/contacts)

python create_contact.py --email EMAIL [--firstname NAME] [--lastname NAME] [--phone PHONE] [--company COMPANY] [--json]

Argument	Required	Default	Description
`--email`	Yes	-	Contact email address
`--firstname`	No	-	First name
`--lastname`	No	-	Last name
`--phone`	No	-	Phone number
`--company`	No	-	Company name
`--json`	No	False	Output as JSON

When to Use: Use when user says "create contact", "add contact", "new contact".

update_contact.py - Update contact (PATCH /crm/v3/objects/contacts/{id})

python update_contact.py --id CONTACT_ID [--email EMAIL] [--firstname NAME] [--lastname NAME] [--phone PHONE] [--json]

Argument	Required	Default	Description
`--id`	Yes	-	Contact ID to update
`--email`	No	-	New email
`--firstname`	No	-	New first name
`--lastname`	No	-	New last name
`--phone`	No	-	New phone
`--json`	No	False	Output as JSON

When to Use: Use when user says "update contact", "edit contact", "modify contact".

search_contacts.py - Search contacts (POST /crm/v3/objects/contacts/search)

python search_contacts.py [--email EMAIL] [--name NAME] [--company COMPANY] [--limit N] [--json]

Argument	Required	Default	Description
`--email`	No	-	Search by email
`--name`	No	-	Search by name (first or last)
`--company`	No	-	Search by company
`--limit`	No	10	Max results
`--json`	No	False	Output as JSON

When to Use: Use when user says "search contacts", "find contact", "lookup contact".

CRM Operations - Companies

list_companies.py - List companies (GET /crm/v3/objects/companies)

python list_companies.py [--limit N] [--properties PROPS] [--after CURSOR] [--json]

When to Use: Use when user says "list companies", "get companies", "show companies".

create_company.py - Create company (POST /crm/v3/objects/companies)

python create_company.py --name NAME [--domain DOMAIN] [--industry INDUSTRY] [--json]

When to Use: Use when user says "create company", "add company", "new company".

search_companies.py - Search companies (POST /crm/v3/objects/companies/search)

python search_companies.py [--name NAME] [--domain DOMAIN] [--industry INDUSTRY] [--limit N] [--json]

When to Use: Use when user says "search companies", "find company", "lookup company".

CRM Operations - Deals

list_deals.py - List deals (GET /crm/v3/objects/deals)

python list_deals.py [--limit N] [--properties PROPS] [--after CURSOR] [--json]

When to Use: Use when user says "list deals", "get deals", "show deals", "show pipeline".

create_deal.py - Create deal (POST /crm/v3/objects/deals)

python create_deal.py --name NAME [--amount AMOUNT] [--stage STAGE] [--pipeline PIPELINE] [--json]

When to Use: Use when user says "create deal", "add deal", "new deal", "new opportunity".

update_deal.py - Update deal (PATCH /crm/v3/objects/deals/{id})

python update_deal.py --id DEAL_ID [--name NAME] [--amount AMOUNT] [--stage STAGE] [--json]

When to Use: Use when user says "update deal", "edit deal", "change deal stage".

search_deals.py - Search deals (POST /crm/v3/objects/deals/search)

python search_deals.py [--name NAME] [--stage STAGE] [--min-amount N] [--max-amount N] [--limit N] [--json]

When to Use: Use when user says "search deals", "find deal", "lookup deal".

Associations

get_associations.py - Get associations (GET /crm/v4/objects/{type}/{id}/associations/{toType})

python get_associations.py --object-type TYPE --object-id ID --to-type TO_TYPE [--json]

When to Use: Use when user says "get associations", "linked records", "related contacts".

Engagements

list_emails.py - List email engagements log_email.py - Log email engagement list_calls.py - List call engagements log_call.py - Log call engagement list_notes.py - List notes create_note.py - Create note list_meetings.py - List meetings create_meeting.py - Create meeting

Intelligent Error Detection Flow

When a HubSpot skill fails due to missing configuration, the AI should:

Step 1: Run Config Check with JSON Output

python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json

Step 2: Parse the `ai_action` Field

ai_action	What to Do
`proceed_with_operation`	Config OK, continue with the original operation
`prompt_for_access_token`	Ask user: "I need your HubSpot access token. Create a Private App to get one."
`create_env_file`	Create `.env` file and ask user for credentials
`add_missing_scopes`	Guide user to add scopes in HubSpot Private App settings
`verify_token`	Token exists but connection failed - verify it's correct

Step 3: Help User Fix Issues

If ai_action is prompt_for_access_token:

Tell user: "HubSpot integration needs setup. I need your Private App access token."
Show them: "Create one in HubSpot: Settings → Integrations → Private Apps"
Ask: "Paste your HubSpot access token here (starts with 'pat-'):"
Once they provide it, write directly to .env: HUBSPOT_ACCESS_TOKEN=pat-na1-their-token-here
Re-run config check to verify

Environment Variables

Required in .env:

HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxxxxxxxxxx

API Base URL

All API requests go to: https://api.hubapi.com

Version: 1.0 Created: 2025-12-13 Status: Production Ready

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

04

需要参考平台分布和安装热度时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

补充不同宿主或平台的使用分布数据

能力 5

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

Claude Code

30.21%

按下载量换算31

Antigravity

21.28%

按下载量换算22

windsurf

16.39%

按下载量换算17

Codex

11.26%

按下载量换算12

OpenCode

6.8%

按下载量换算7

Gemini CLI

3.49%

按下载量换算4

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

未通过

权限和风险

敏感数据

该 Skill 可能接触密钥、Token、环境变量或敏感配置，应进入高风险复核队列，默认不自动发布。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果，不能写成本站确认安全。

来源信息

GitHub 仓库

github.com

/abdullahbeam/nexus-design-abdullah

SKILL.md 来源

github.com

/abdullahbeam/nexus-design-abdullah/tree/main/skills/hubspot-master

skills-sh

skills.sh

/abdullahbeam/nexus-design-abdullah/hubspot-master

agentskills-to

agentskills.to