← Back to Skills Marketplace
ms-youssef

The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call

by ms-youssef · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2166
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install signalhire-skill
Description
Prospect and enrich contacts via the SignalHire API (Search, Person and Credits)
Usage Guidance
Do not install until you confirm a few things: 1) Fix the registry metadata: the SKILL.md requires SIGNALHIRE_API_KEY and SIGNALHIRE_CALLBACK_URL but the registry lists none — ask the publisher to correct this. 2) Verify the connector code before running: request the connector/main.py source (it exists in the package) and review it locally or in an isolated environment to see what it writes to disk and what network endpoints it uses. 3) Provide a callback URL you control and secure it (HTTPS, IP/host restrictions, auth) because SignalHire will POST contact data there; expect PII in those payloads. 4) Decide whether you want the model to be able to invoke this skill autonomously; if not, ask the author to set disableModelInvocation:true or ensure user-invocable only. 5) Confirm where CSVs are stored, retention policies, and who can access them. 6) Prefer a published source/homepage and clearer install/run instructions before trusting the skill with your SignalHire API key or account credits.
Capability Analysis
Type: OpenClaw Skill Name: signalhire-skill Version: 1.0.0 The skill bundle is designed for legitimate integration with the SignalHire API. The `SKILL.md` provides clear, responsible instructions for the AI agent, including security best practices like not leaking API keys and respecting rate limits, with no evidence of prompt injection for malicious purposes. The `connector/main.py` implements a Flask service to receive API callbacks and persist data to CSV files within a designated output directory, without attempting unauthorized file access, network exfiltration, or command execution. All components align with the stated purpose of prospecting and enriching contacts.
Capability Assessment
Purpose & Capability
The name and description align with the SignalHire API (credits, search, person/enrichment). The SKILL.md explicitly requires SIGNALHIRE_API_KEY and SIGNALHIRE_CALLBACK_URL which are appropriate for the described async enrichment workflow. However, the registry metadata lists no required env vars/primary credential while SKILL.md declares them — that mismatch is an incoherence and should be corrected. The presence of connector code (connector/main.py) is coherent with the need for a callback/connector service, but the package provides no install spec or homepage, so it's unclear how that connector is expected to be deployed.
Instruction Scope
SKILL.md stays within the stated purpose: it documents how to check credits, perform search, and run Person API jobs with a required callback. It warns not to leak the API key and specifies rate/concurrency limits and expected callback semantics. It does not instruct the agent to read unrelated files or credentials.
Install Mechanism
There is no install spec (instruction-only), which is low-risk. However, code files (connector/main.py and __init__.py) are present in the bundle but there are no instructions on how/when these files are installed or executed. This is an implementation inconsistency: either the connector is expected to be run by the platform or the user, but that is not documented in the registry metadata or SKILL.md in an explicit install section.
Credentials
Requiring SIGNALHIRE_API_KEY and SIGNALHIRE_CALLBACK_URL is proportional to the stated purpose. The concern is the mismatch between the SKILL.md's declared required env vars and the registry metadata (which lists none). Also the callback URL must be publicly reachable—users must understand that the skill will instruct SignalHire to POST potentially sensitive contact data to that endpoint, so the callback endpoint should be under the user's control and secured.
Persistence & Privilege
The skill does not set always:true (good) but does not set disableModelInvocation:true, so the model can autonomously invoke the skill. That means an agent could start enrichment jobs (consuming account credits) and cause SignalHire to POST data to the supplied callback URL without an explicit user step. The connector is described as persisting results to CSV; where those files live and their access controls are not documented. Those operational privileges warrant explicit user controls (e.g., require user invocation, audit logs, or whitelist callback URLs).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install signalhire-skill
  3. After installation, invoke the skill by name or use /signalhire-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call. The credits check invokes SignalHire’s /api/v1/credits endpoint to report how many credits you have left, while the search action uses the searchByQuery endpoint to filter candidates by title, location, industry and other fields. Access to the search API requires contacting SignalHire and is limited to three concurrent requests. The enrichment action calls the Person API (/api/v1/candidate/search) with up to 100 identifiers and a callback URL. SignalHire returns results asynchronously to your callback; your server must reply with HTTP 200 within a 10‑second window or SignalHire will retry and eventually discard the request. Each callback object includes a status (success, failed, credits_are_over, timeout_exceeded or duplicate_query) and, on success, a candidate with fields like fullName, emails, phones and locations. The skill includes a small Flask connector that listens on the callback endpoint, writes results into per‑job and consolidated CSV files, and exposes a job-status API so your agent knows when to proceed.
Metadata
Slug signalhire-skill
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call?

Prospect and enrich contacts via the SignalHire API (Search, Person and Credits). It is an AI Agent Skill for Claude Code / OpenClaw, with 2166 downloads so far.

How do I install The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call?

Run "/install signalhire-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call free?

Yes, The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call is completely free (open-source). You can download, install and use it at no cost.

Which platforms does The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call support?

The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created The SignalHire skill integrates the full SignalHire API into OpenClaw, enabling you to search for prospects and enrich their contact details without leaving your workflow. It exposes three core actions: a credits check, a search-by-query for prospecting, and an asynchronous contact enrichment call?

It is built and maintained by ms-youssef (@ms-youssef); the current version is v1.0.0.

💬 Comments