Zum Hauptinhalt springen
Dieser Inhalt ist noch nicht in Ihrer Sprache verfügbar und wird auf Englisch angezeigt.

Backfill Geo Data

Skill Aktiv

Enrich missing geographic data (country, state, city) on contacts and companies using HubSpot workflows, external data providers, or IP-based geolocation.

Zweck

To automatically populate missing geographic information on contacts and companies in HubSpot, enabling better segmentation, regional reporting, and compliance.

Funktionen

  • Enriches missing country, state, and city data
  • Supports HubSpot workflows for automated enrichment
  • Provides API-based enrichment using company domain lookups
  • Integrates with third-party data providers
  • Includes detailed step-by-step instructions and rollback procedures

Anwendungsfälle

  • Use when contacts or companies lack essential geographic data for reporting or targeting.
  • Use to comply with regional privacy laws (e.g., GDPR) by accurately assigning location data.
  • Use to improve lead routing and territory assignment based on location.
  • Use to standardize geographic data across your HubSpot database.

Nicht-Ziele

  • Overwriting manually entered geographic data
  • Performing operations outside of HubSpot CRM data enrichment
  • Replacing HubSpot's core CRM functionality

Documentation

  • info:Configuration & parameter referenceThe SKILL.md mentions prerequisites like an API token and Python installation but does not detail specific configuration parameters or their defaults for the enrichment methods.

Maintenance

  • warning:Dependency ManagementThe skill requires Python with 'hubspot-api-client' installed via 'uv', but there is no explicit mention of vulnerability checks or an automated update mechanism for dependencies.

Security

  • warning:Secret ManagementThe SKILL.md requires a HubSpot API token in '.env', but does not detail measures to prevent its echo or secure handling beyond a generic mention.

Code Execution

  • info:ValidationThe skill mentions validating against standardized geo formats but does not specify the use of a schema library for input or output validation within the provided description.
  • info:Error HandlingThe SKILL.md outlines a rollback procedure but does not detail specific error handling for API calls or script execution, nor does it specify structured error fields.

Compliance

  • info:GDPRThe skill operates on contact and company data which may include personal data, but it does not explicitly describe sanitization steps before sending data to HubSpot or other providers beyond the implied data quality focus.

Install

  • warning:Installation instructionThe README provides installation instructions for the plugin marketplace but does not include a direct copy-paste invocation example for this specific skill, nor does it detail HubSpot API authentication setup beyond mentioning a token in .env.

Errors

  • info:Actionable error messagesThe SKILL.md mentions a rollback procedure and the need to validate against standardized geo formats but does not explicitly detail actionable error messages for user-facing failure paths.

Execution

  • warning:Pinned dependenciesThe skill requires 'hubspot-api-client' installed via 'uv' but does not specify pinned versions or a lockfile, potentially leading to compatibility issues.

Protocol

  • info:Idempotent retry & timeoutsWhile HubSpot API interactions might have inherent idempotency and timeouts, the skill description does not explicitly detail how these are managed or exposed to the user for retry guidance.

Practical Utility

  • warning:Usage examplesThe SKILL.md describes methods and provides a Python code snippet but lacks end-to-end, ready-to-use examples demonstrating input, invocation, and observable outcome for each enrichment method.
  • info:Edge casesThe SKILL.md mentions a rollback procedure and the need to validate against standardized geo formats, but doesn't explicitly detail failure modes with symptoms and recovery steps for each enrichment method.

Safety

  • info:Halt on unexpected stateWhile a rollback procedure is mentioned, the SKILL.md does not explicitly state that the workflow will halt and report on unexpected pre-states like a dirty working tree or drifted schema.

Installation

Zuerst Marketplace hinzufügen

/plugin marketplace add TomGranot/hubspot-admin-skills
/plugin install hubspot-admin-skills@hubspot-admin-skills

Qualitätspunktzahl

75 /100
Analysiert 1 day ago

Vertrauenssignale

Letzter Commitabout 2 months ago
Sterne21
LizenzMIT
Status
Quellcode ansehen