← 返回 Skills 市场
144
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install fr3k-hubspot-crm
功能描述
Full HubSpot CRM automation — contacts, deals, companies, activities, and pipeline reports via the HubSpot API.
使用说明 (SKILL.md)
HubSpot CRM
Automate your entire HubSpot CRM from the command line. Create and manage contacts, deals, and companies; log activities (calls, emails, meetings, notes); and pull pipeline reports with conversion rates — all via the official HubSpot API with a single Bearer token.
Setup
Set your HubSpot Private App token as an environment variable:
export HUBSPOT_API_KEY="pat-na1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Get your token: HubSpot → Settings → Integrations → Private Apps → Create a private app.
Required scopes: crm.objects.contacts, crm.objects.deals, crm.objects.companies, crm.schemas.contacts, sales-email-read.
Commands / Usage
# ── CONTACTS ────────────────────────────────────────────
# List contacts (default 20, up to 100)
python3 scripts/hubspot_crm.py contacts-list
python3 scripts/hubspot_crm.py contacts-list --limit 50
# Search contacts by email or name
python3 scripts/hubspot_crm.py contacts-search --query "[email protected]"
python3 scripts/hubspot_crm.py contacts-search --query "John Smith"
# Create a contact
python3 scripts/hubspot_crm.py contacts-create --email "[email protected]" --firstname "Jane" --lastname "Doe" --phone "+1-555-0100" --company "Acme"
# Update a contact
python3 scripts/hubspot_crm.py contacts-update --id 12345 --phone "+1-555-9999" --jobtitle "CTO"
# Delete a contact
python3 scripts/hubspot_crm.py contacts-delete --id 12345
# ── DEALS ───────────────────────────────────────────────
# List all deals
python3 scripts/hubspot_crm.py deals-list
python3 scripts/hubspot_crm.py deals-list --limit 50
# Create a deal
python3 scripts/hubspot_crm.py deals-create --name "Acme Enterprise License" --stage "appointmentscheduled" --amount 12000 --contact-id 12345
# Update a deal
python3 scripts/hubspot_crm.py deals-update --id 67890 --stage "closedwon" --amount 15000
# Move deal stage
python3 scripts/hubspot_crm.py deals-move-stage --id 67890 --stage "contractsent"
# List pipeline stages
python3 scripts/hubspot_crm.py pipeline-list
# ── COMPANIES ───────────────────────────────────────────
# Create a company
python3 scripts/hubspot_crm.py companies-create --name "Acme Corp" --domain "acme.com" --industry "TECHNOLOGY"
# Search companies
python3 scripts/hubspot_crm.py companies-search --query "Acme"
# Associate contact with company
python3 scripts/hubspot_crm.py companies-associate --company-id 11111 --contact-id 22222
# ── ACTIVITIES ──────────────────────────────────────────
# Log an email activity
python3 scripts/hubspot_crm.py log-email --contact-id 12345 --subject "Follow-up" --body "Hi Jane, just checking in..."
# Log a call
python3 scripts/hubspot_crm.py log-call --contact-id 12345 --duration 300 --notes "Discussed pricing, very interested"
# Log a meeting
python3 scripts/hubspot_crm.py log-meeting --contact-id 12345 --title "Demo call" --notes "Showed product, positive feedback"
# Log a note
python3 scripts/hubspot_crm.py log-note --contact-id 12345 --body "Called and left voicemail"
# ── REPORTS ─────────────────────────────────────────────
# Get deal pipeline summary
python3 scripts/hubspot_crm.py report-pipeline
# Get conversion rates per stage
python3 scripts/hubspot_crm.py report-conversions
Requirements
- Python 3.8+
requests(standard:pip install requests)HUBSPOT_API_KEYenvironment variable
安全使用建议
This skill appears to do what it says: a simple CLI that uses a HubSpot private-app Bearer token to manage CRM data. Before installing or running it, verify these points: (1) the registry metadata omitted the required HUBSPOT_API_KEY — you must set that env var; (2) only provide a HubSpot token with the minimal scopes needed (avoid broad admin tokens); (3) review the included scripts/hubspot_crm.py yourself to confirm there are no modifications you dislike; (4) run it from a safe or disposable environment (or with a test HubSpot account) until you trust it; and (5) because the skill source/homepage is unknown, prefer obtaining code from an official or verified source when possible and rotate/revoke tokens after testing.
功能分析
Type: OpenClaw Skill
Name: fr3k-hubspot-crm
Version: 1.0.0
The HubSpot CRM skill is a legitimate tool for managing contacts, deals, and activities via the official HubSpot API. The Python script `scripts/hubspot_crm.py` implements standard CRM operations using the `requests` library and follows the functionality described in `SKILL.md` without any evidence of malicious intent, data exfiltration, or unauthorized execution.
能力评估
Purpose & Capability
The name/description, SKILL.md, and the included Python CLI implement HubSpot CRM operations (contacts, deals, companies, activities, reports) against api.hubapi.com. The requested functionality aligns with the stated purpose.
Instruction Scope
SKILL.md instructs only to set a HUBSPOT_API_KEY and run the provided Python script. The script only calls HubSpot API endpoints and prints results; it does not reference other system files, other environment variables, or external endpoints beyond api.hubapi.com.
Install Mechanism
No install spec is provided (instruction-only plus an included Python script). It requires Python and the requests library, which is proportionate for a CLI script. Nothing is downloaded or extracted by the skill itself.
Credentials
The SKILL.md and script require a HUBSPOT_API_KEY (a private-app Bearer token) and list required HubSpot scopes, which is appropriate. However, the registry metadata incorrectly lists 'Required env vars: none' and 'Primary credential: none' — an incoherence that could lead users to miss the need to provide the token. The skill only needs that one token; no unrelated credentials are requested.
Persistence & Privilege
The skill is not marked always:true and does not persist or modify other skills or system-wide settings. It runs as a one-off CLI tool using the environment token.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install fr3k-hubspot-crm - 安装完成后，直接呼叫该 Skill 的名称或使用
/fr3k-hubspot-crm触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of HubSpot CRM automation skill.
- Manage contacts, deals, companies, and activities from the command line using the HubSpot API.
- Includes support for searching, creating, updating, deleting, and associating records.
- Log activities such as calls, emails, meetings, and notes.
- Generate deal pipeline and conversion reports.
- Setup requires only a HubSpot Private App token (single Bearer token).
元数据
常见问题
Hubspot Crm 是什么？
Full HubSpot CRM automation — contacts, deals, companies, activities, and pipeline reports via the HubSpot API. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 144 次。
如何安装 Hubspot Crm？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install fr3k-hubspot-crm」即可一键安装，无需额外配置。
Hubspot Crm 是免费的吗？
是的，Hubspot Crm 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Hubspot Crm 支持哪些平台？
Hubspot Crm 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Hubspot Crm？
由 fr3kstyle（@fr3kstyle）开发并维护，当前版本 v1.0.0。
推荐 Skills