← 返回 Skills 市场
Native HubSpot
作者
codeninja23
· GitHub ↗
· v1.0.1
742
总下载
18
收藏
2
当前安装
2
版本数
在 OpenClaw 中安装
/install native-hubspot
功能描述
Query and manage HubSpot CRM data via the HubSpot API. Use when you need to search or manage contacts, companies, deals, tickets, or pipelines. Supports crea...
使用说明 (SKILL.md)
HubSpot
Interact with HubSpot CRM directly via the HubSpot API (api.hubapi.com).
Setup (one-time)
- In HubSpot: Settings → Integrations → Private Apps → Create a private app
- Give it scopes:
crm.objects.contacts.read,crm.objects.contacts.write,crm.objects.companies.read,crm.objects.companies.write,crm.objects.deals.read,crm.objects.deals.write,tickets - Copy the access token
- Set environment variable:
HUBSPOT_TOKEN=pat-na1-...
Queries
Search contacts
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --query "john"
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --email "[email protected]"
List contacts
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list contacts --limit 20
Get a specific object
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get contacts 12345
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get companies 67890
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get deals 11111
List companies
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list companies --limit 20
Search companies
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search companies --query "Acme"
List deals
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list deals --limit 20
Search deals
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search deals --query "enterprise"
List tickets
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list tickets --limit 20
Create a contact
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create contacts --email "[email protected]" --firstname "Jane" --lastname "Doe"
Create a company
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create companies --name "Acme Corp" --domain "acme.com"
Create a deal
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create deals --dealname "Enterprise Plan" --amount 50000 --pipeline default --dealstage appointmentscheduled
Update an object
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py update contacts 12345 --email "[email protected]" --phone "+1234567890"
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py update deals 11111 --dealstage closedwon --amount 75000
Associate objects
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py associate contacts 12345 companies 67890
List pipelines
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines deals
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines tickets
List owners
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py owners
安全使用建议
This skill is coherent: it needs your HubSpot private-app token and uses python3 to call api.hubapi.com. Before installing, ensure you: (1) create a HubSpot private app with only the minimum scopes you need, (2) treat the HUBSPOT_TOKEN as a sensitive secret and only supply it to skills you trust, (3) review the full script locally (the provided listing was truncated in the prompt) to confirm there are no unexpected network calls or data exfiltration, and (4) consider using a token with limited write scopes or a token you can rotate if you're concerned.
功能分析
Type: OpenClaw Skill
Name: native-hubspot
Version: 1.0.1
The skill bundle is benign. It provides a direct interface to the HubSpot CRM API, as clearly stated in `SKILL.md` and `README.md`. The `scripts/hubspot_query.py` script uses standard Python libraries (`urllib.request`, `json`, `os`) to interact solely with `https://api.hubapi.com`, authenticating via the `HUBSPOT_TOKEN` environment variable. There is no evidence of data exfiltration to unauthorized endpoints, malicious command execution (e.g., `curl|bash`, `eval`), persistence mechanisms, or prompt injection attempts against the AI agent. The broad read/write permissions requested are necessary for the skill's stated purpose of managing CRM data.
能力评估
Purpose & Capability
Name and description state direct HubSpot API access and the package requires python3 plus a HUBSPOT_TOKEN — both are expected for a simple CLI tool that calls api.hubapi.com.
Instruction Scope
SKILL.md instructs creating a HubSpot private app, setting HUBSPOT_TOKEN, and running the included Python script. The instructions do not ask the agent to read unrelated files or transmit data to other endpoints; they target only api.hubapi.com.
Install Mechanism
No install spec (instruction-only) and the code uses only Python standard library; nothing is downloaded or written to disk outside the included script.
Credentials
Only HUBSPOT_TOKEN is required and declared as the primary credential. That token is necessary for all described operations (read/write on CRM objects) and the scope list in the README matches the operations.
Persistence & Privilege
The skill does not request always:true or any system-wide changes. It's user-invocable and does not claim persistent elevated privileges.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install native-hubspot - 安装完成后，直接呼叫该 Skill 的名称或使用
/native-hubspot触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
Update display name to Native HubSpot
v0.1.0
Initial release of native-hubspot skill.
- Enables direct querying and management of HubSpot CRM (contacts, companies, deals, tickets, pipelines) via the official API.
- Supports searching, listing, retrieving, creating, updating, and associating CRM objects.
- No third-party proxy; connects directly to api.hubapi.com.
- Requires setup with a HubSpot private app and access token.
- Provides a set of Python CLI command examples for all supported operations.
元数据
常见问题
Native HubSpot 是什么？
Query and manage HubSpot CRM data via the HubSpot API. Use when you need to search or manage contacts, companies, deals, tickets, or pipelines. Supports crea... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 742 次。
如何安装 Native HubSpot？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install native-hubspot」即可一键安装，无需额外配置。
Native HubSpot 是免费的吗？
是的，Native HubSpot 完全免费（开源免费），可自由下载、安装和使用。
Native HubSpot 支持哪些平台？
Native HubSpot 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Native HubSpot？
由 codeninja23（@codeninja23）开发并维护，当前版本 v1.0.1。
推荐 Skills