hubspot-search-companies

Search HubSpot CRM companies by name or domain via Python scripts.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-search-companies-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-search-companies
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-search-companies
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-search-companies-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding company records in HubSpot CRM manually requires navigating the web interface and filtering lists, which slows down sales and CRM workflows that need quick lookups by name or domain. ## Core Features & Use Cases - Name-Based Search: Find companies using partial name matching with the CONTAINS_TOKEN operator. - Domain-Based Search: Locate company records by website domain for deduplication or enrichment checks. - Structured JSON Output: Returns company IDs, properties, and HubSpot URLs ready for downstream automation. - Use Case: Before creating a new company record, search for "acme.com" to verify it does not already exist, then use the returned company ID to fetch associated contacts. ## Quick Start Ask the AI to search HubSpot for companies matching a name like "Acme" or a domain like "acme.com" and display the matching records.

Frequently Asked Questions about hubspot-search-companies

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search companies in HubSpot by domain?

Run the search_companies.py script with the --domain flag followed by the domain, such as acme.com. The search uses the CONTAINS_TOKEN operator for partial matching and returns matching company records as JSON.

How to find a company in HubSpot CRM by name?

Use the search_companies.py script with the --name flag and a partial or full company name. Results are sorted by relevance and include the company ID, domain, industry, and city properties.

What HubSpot API scope is needed to search companies?

Searching companies requires the crm.objects.companies.read scope on your HubSpot private app token. A 403 error indicates this scope is missing and must be added in your HubSpot app settings.

Why does HubSpot company search return a 401 error?

A 401 error means the API token is invalid or expired. Re-run the HubSpot setup flow to generate a new token, then verify configuration with the check_hubspot_config.py pre-flight script.

Can I limit the number of HubSpot search results?

Yes, pass the --limit flag with a number, such as --limit 20, to cap the results returned. This is useful when searching common name fragments that match many records.