signalhire-skill_skill

Overview

This skill provides prospecting and contact enrichment via the SignalHire API. It exposes actions to check remaining credits, search profiles, and run batch person enrichments with callback-based delivery. The skill enforces SignalHire rate, concurrency, and callback requirements to keep operations reliable and compliant.

How this skill works

The skill wraps SignalHire endpoints so agents call high-level actions instead of the API directly. It queries credits, performs candidate search (with scroll support), and submits Person enrichment jobs that deliver results via a callback URL. Built-in throttling, concurrency controls, and callback handling ensure requests respect SignalHire limits and complete reliably.

When to use it

• Validate account credits before large enrichment jobs
• Find candidate profiles by title, location, industry, or keywords without consuming contact credits
• Enrich lists of identifiers (LinkedIn URLs, emails, phones, or profile UIDs) to retrieve contact details
• Run large batch enrichments while respecting per-minute element quotas and callback flow
• Archive or persist enriched results after the connector signals job completion

Best practices

• Always call the check-credits action before starting bulk enrichments and split jobs if credits are insufficient
• Limit concurrent searchByQuery requests to three or fewer and page using scrollId within 15 seconds
• Batch up to 100 items per Person API request but ensure total processed elements do not exceed 600 per minute
• Provide and maintain a reachable callback URL that returns HTTP 200 within 10 seconds; implement retries and idempotency for callback processing
• Implement exponential backoff on HTTP 429 responses and log all non-success callback statuses (failed, credits_are_over, timeout_exceeded, duplicate_query)

Example use cases

• Recruiting workflow: search for candidates by title and location, then enrich selected profiles for contact details
• Sales prospecting: upload lists of LinkedIn URLs or emails to batch-enrich contact information and social profiles
• Data hygiene: verify remaining credits and run incremental enrichments while throttling to avoid rate-limit rejections
• Compliance review: collect and log callback status values and respect opt-out or GDPR requests when storing contact data