Search HubSpot Companies

Specialized skill for searching companies in HubSpot CRM.

Pre-Flight Check

Before running, execute config check:

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

If ai_action is not proceed_with_operation , follow hubspot-connect setup guide.

Usage

Search by Name

python 00-system/skills/hubspot/hubspot-master/scripts/search_companies.py
--name "Acme"
--json

Search by Domain

python 00-system/skills/hubspot/hubspot-master/scripts/search_companies.py
--domain "acme.com"
--json

With Limit

python 00-system/skills/hubspot/hubspot-master/scripts/search_companies.py
--name "Tech"
--limit 20
--json

Output Format

{ "total": 3, "results": [ { "id": "6493611979", "properties": { "name": "Acme Corp", "domain": "acme.com", "industry": "Technology", "city": "San Francisco" }, "url": "https://app.hubspot.com/..." } ] }

Display Format

Found 3 companies matching "Acme":

1. Acme Corp Domain: acme.com Industry: Technology City: San Francisco ID: 6493611979

2. Acme Industries Domain: acmeindustries.com ...

Search Behavior

• Name search uses CONTAINS_TOKEN operator (partial match)

• Domain search uses CONTAINS_TOKEN operator (partial match)

• Results sorted by relevance

Error Handling

Error Solution

401 Invalid token - re-run setup

403 Missing crm.objects.companies.read scope

429 Rate limited - wait and retry

Related Skills

• hubspot-list-companies

• List all companies

• hubspot-create-company

• Create if not found

• hubspot-get-associations

• Get company contacts