← Back to Skills Marketplace
hundevmode

Dievio Lead Search API

by hundevmode · GitHub ↗ · v1.0.3
cross-platform ⚠ suspicious
438
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install dievio-lead-search-api
Description
Run Dievio lead search and LinkedIn lookup workflows through the public API with correct authentication, filters, pagination, and credit-aware handling. Use...
README (SKILL.md)

Dievio Lead Search Api

Overview

Use this skill for end-to-end Dievio API execution: authenticate requests, submit lead searches, enrich LinkedIn profiles, and paginate results. Prefer the bundled script for deterministic request formatting and response handling.

Core Endpoints

  • Public lead search: POST https://dievio.com/api/public/search
  • LinkedIn lookup: POST https://dievio.com/api/linkedin/lookup

Authentication headers (use one):

  • Authorization: Bearer YOUR_API_KEY
  • X-API-Key: YOUR_API_KEY

Workflow

  1. Validate credentials:
  • Require DIEVIO_API_KEY for API-key flows.
  • Never print raw secrets.
  1. Build request body:
  • Search endpoint uses pagination keys (_page, _per_page, max_results) plus filters.
  • LinkedIn lookup requires linkedinUrls and optional output flags.
  1. Execute request and parse response:
  • Validate success, count, has_more, next_page, data arrays.
  • Respect credit behavior: low credits can return fewer rows than requested.
  1. Handle errors:
  • 401: missing/invalid credentials
  • 402: insufficient credits
  • 502: upstream lead service issue
  • 500: server error

Commands

Show help:

python3 scripts/dievio_api.py --help

Search with JSON body:

export DIEVIO_API_KEY="your_api_key"
python3 scripts/dievio_api.py search \
  --body-file ./search_body.json \
  --auto-paginate

By default the CLI prints a safe summary. Use --raw-output only when you explicitly need full rows (which may contain emails/phones).

LinkedIn lookup from URLs:

python3 scripts/dievio_api.py linkedin-lookup \
  --linkedin-url "https://www.linkedin.com/in/example-1" \
  --linkedin-url "https://www.linkedin.com/in/example-2" \
  --include-work-emails \
  --include-personal-emails \
  --only-with-emails

Decision Rules

  • Use search when query is filter-based lead discovery.
  • Use linkedin-lookup when input is explicit LinkedIn profile URLs.
  • For large pulls, enable pagination and stop on has_more=false.
  • Keep outputs structured and include paging fields for traceability.
  • If user asks for exact filter values, read references/filters-cheatsheet.md.

References

Usage Guidance
This skill appears to do what it claims: it calls Dievio endpoints and needs only DIEVIO_API_KEY. Before installing: (1) verify the publisher/repo (SKILL.md references a GitHub repo but registry metadata lacks a homepage/source), (2) only provide an API key you trust and, if possible, a limited-scope or test key, (3) avoid using --raw-output unless you need full rows (it can include emails/phones/PII and could be logged), and (4) be aware the skill will perform network requests to dievio.com and will consume your Dievio credits. If you need stronger safety, restrict autonomous invocation or review the referenced GitHub repository to confirm code provenance.
Capability Analysis
Type: OpenClaw Skill Name: dievio-lead-search-api Version: 1.0.3 The skill is classified as suspicious due to a Local File Inclusion (LFI) vulnerability in `scripts/dievio_api.py`. The `_load_json_file` function, used by `cmd_search` and `cmd_linkedin_lookup` via the `--body-file` argument, allows reading arbitrary JSON files from the local filesystem. While the script's core functionality is legitimate API interaction, an attacker could exploit this vulnerability through prompt injection against the OpenClaw agent to read sensitive JSON configuration or credential files, potentially exposing their contents if the agent is instructed to output the full response (especially with `--raw-output`). There is no evidence of intentional malicious behavior such as data exfiltration to unauthorized endpoints or backdoor installation.
Capability Assessment
ℹ Purpose & Capability
Name, README, SKILL.md, and the included Python CLI all consistently implement Dievio lead search and LinkedIn lookup via POST to dievio.com endpoints. The only mild inconsistency: registry metadata lists source/homepage as unknown/none while SKILL.md/README provide a GitHub URL and dievio.com homepage — worth verifying but not suspicious by itself.
✓ Instruction Scope
SKILL.md instructs the agent to authenticate with DIEVIO_API_KEY, build request payloads, paginate, and handle errors. The bundled script implements those steps and only reads local JSON body files and the DIEVIO_API_KEY environment variable; it does not attempt to read other system files or unrelated environment variables. SKILL.md warns not to print secrets and notes raw output may include emails/phones.
✓ Install Mechanism
No install spec; skill is instruction-only with a small Python script included. No downloads from arbitrary URLs or archive extraction are present. Risk from installation is low (script runs from disk if executed).
✓ Credentials
Only requires a single API key (DIEVIO_API_KEY), which is appropriate for an API-integration skill. The script allows an --api-key override and otherwise reads os.getenv('DIEVIO_API_KEY'); no other credentials or secrets are requested or accessed.
✓ Persistence & Privilege
Skill does not request persistent/always-on inclusion (always: false) and does not modify other skills or system-wide settings. It can be invoked autonomously by the agent (default behavior) but that is expected for a callable skill; no elevated privileges requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install dievio-lead-search-api
  3. After installation, invoke the skill by name or use /dievio-lead-search-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Security hardening follow-up: fixed host pinning and default-safe output.
v1.0.2
Security hardening: remove DIEVIO_BASE_URL override; summary output by default; raw payload now explicit via --raw-output.
v1.0.1
Declare required DIEVIO_API_KEY metadata (source/homepage) and unify CLI auth mode names.
v1.0.0
Initial release: Dievio lead search and LinkedIn lookup skill with filters, pagination, and CLI.
Metadata
Slug dievio-lead-search-api
Version 1.0.3
License —
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Dievio Lead Search API?

Run Dievio lead search and LinkedIn lookup workflows through the public API with correct authentication, filters, pagination, and credit-aware handling. Use... It is an AI Agent Skill for Claude Code / OpenClaw, with 438 downloads so far.

How do I install Dievio Lead Search API?

Run "/install dievio-lead-search-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Dievio Lead Search API free?

Yes, Dievio Lead Search API is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Dievio Lead Search API support?

Dievio Lead Search API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Dievio Lead Search API?

It is built and maintained by hundevmode (@hundevmode); the current version is v1.0.3.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments