๐Ÿ”
12917 skills
โ† All skills
Tencent SkillHub ยท Developer Tools

Nyne Enrichment

Enrich any person by email, phone, LinkedIn URL, or name using the Nyne Enrichment API. Returns contact info, social profiles, work history, education, and o...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Enrich any person by email, phone, LinkedIn URL, or name using the Nyne Enrichment API. Returns contact info, social profiles, work history, education, and o...

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 26 sections Open source page

Nyne Enrichment Skill

Enrich any person by email, phone, LinkedIn URL, or name. Returns contact info, social profiles, work history, education, and optional social media posts. Important: This API is async. You POST to submit, get a request_id, then poll GET until complete.

Agent Instructions

When presenting results to the user, show all available data. Walk through each section: Identity โ€” displayname, bio, location, gender Contact โ€” emails (work + personal + alt), phones with type Social Profiles โ€” LinkedIn, Twitter, GitHub, Instagram with follower counts Work History โ€” all organizations with title, dates, current status Education โ€” schools with degree, field, dates Newsfeed (if requested) โ€” recent posts with engagement metrics If a field is missing from the response, it means no data was found โ€” skip it silently. For lite mode responses, note that only 5 fields are returned (displayname, firstname, lastname, first organization, LinkedIn URL).

Setup

Required environment variables: NYNE_API_KEY โ€” your Nyne API key NYNE_API_SECRET โ€” your Nyne API secret Get credentials at https://api.nyne.ai. export NYNE_API_KEY="your-api-key" export NYNE_API_SECRET="your-api-secret" Verify they're set: echo "Key: ${NYNE_API_KEY:0:8}... Secret: ${NYNE_API_SECRET:0:6}..."

Important: JSON Handling

The API response can contain control characters in JSON string values that break jq. All examples use a nyne_parse helper that cleans and re-encodes JSON via python3. Define it once per session: nyne_parse() { python3 -c " import sys, json, re raw = sys.stdin.read() clean = re.sub(r'[\x00-\x1f]+', ' ', raw) data = json.loads(clean) json.dump(data, sys.stdout) " }

Quick Start

Submit an enrichment request by email and poll until complete: nyne_parse() { python3 -c " import sys, json, re raw = sys.stdin.read() clean = re.sub(r'[\x00-\x1f]+', ' ', raw) data = json.loads(clean) json.dump(data, sys.stdout) " } # Submit enrichment request curl -s -X POST "https://api.nyne.ai/person/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" \ -d '{"email": "someone@example.com"}' | nyne_parse > /tmp/nyne_enrich.json REQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json) echo "Request submitted: $REQUEST_ID" # Poll until complete (checks every 3s, times out after 6 min) SECONDS_WAITED=0 while [ $SECONDS_WAITED -lt 360 ]; do curl -s "https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" | nyne_parse > /tmp/nyne_enrich.json STATUS=$(jq -r '.data.status' /tmp/nyne_enrich.json) echo "Status: $STATUS ($SECONDS_WAITED seconds elapsed)" if [ "$STATUS" = "completed" ]; then jq '.data.result' /tmp/nyne_enrich.json break elif [ "$STATUS" = "failed" ]; then echo "Enrichment failed." jq . /tmp/nyne_enrich.json break fi sleep 3 SECONDS_WAITED=$((SECONDS_WAITED + 3)) done if [ $SECONDS_WAITED -ge 360 ]; then echo "Timed out after 6 minutes. Resume polling with request_id: $REQUEST_ID" fi

Submit Enrichment (POST)

Endpoint: POST https://api.nyne.ai/person/enrichment Headers: Content-Type: application/json X-API-Key: $NYNE_API_KEY X-API-Secret: $NYNE_API_SECRET

Input Parameters

At least one identifier is required. ParameterTypeDescriptionemailstringEmail address (work email preferred)phonestringPhone number (e.g., "+14155551234")social_media_urlstringLinkedIn, Twitter, or GitHub URLnamestringFull name (use with company or city to disambiguate)companystringCompany name (helps disambiguate name lookups)citystringCity (accepts abbreviations: SF, NYC, LA) Input priority ranking: LinkedIn URL (best) > Email (work > personal) > Phone (lowest match rate). LinkedIn + email together yields best results.

Feature Parameters

ParameterTypeDefaultDescriptionai_enhanced_searchbooleanfalseAI-powered deep search for additional social profiles. Longer processing time.lite_enrichbooleanfalseMinimal enrichment: only 5 fields, 3 credits instead of 6newsfeedarrayomitSocial posts to fetch: ["linkedin", "twitter", "instagram", "github", "facebook"] or ["all"]. Cannot mix "all" with specific sources. +6 credits when data found.strict_email_checkbooleanfalseStrict email validation (may return no results)callback_urlstringomitWebhook URL for async delivery

Examples

By email: curl -s -X POST "https://api.nyne.ai/person/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" \ -d '{"email": "someone@example.com"}' | nyne_parse > /tmp/nyne_enrich.json REQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json) echo "Request ID: $REQUEST_ID" By LinkedIn URL: curl -s -X POST "https://api.nyne.ai/person/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" \ -d '{"social_media_url": "https://linkedin.com/in/johndoe"}' | nyne_parse > /tmp/nyne_enrich.json REQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json) By name + company: curl -s -X POST "https://api.nyne.ai/person/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" \ -d '{"name": "Jane Smith", "company": "Acme Corp", "city": "SF"}' | nyne_parse > /tmp/nyne_enrich.json REQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json) With newsfeed: curl -s -X POST "https://api.nyne.ai/person/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" \ -d '{"email": "someone@example.com", "newsfeed": ["linkedin", "twitter"]}' | nyne_parse > /tmp/nyne_enrich.json REQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json) Lite mode (3 credits): curl -s -X POST "https://api.nyne.ai/person/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" \ -d '{"email": "someone@example.com", "lite_enrich": true}' | nyne_parse > /tmp/nyne_enrich.json REQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json) With AI-enhanced search: curl -s -X POST "https://api.nyne.ai/person/enrichment" \ -H "Content-Type: application/json" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" \ -d '{"email": "someone@example.com", "ai_enhanced_search": true}' | nyne_parse > /tmp/nyne_enrich.json REQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json) Submit response: { "success": true, "data": { "request_id": "abc123-...", "status": "queued", "message": "Enrichment request queued. Use GET /person/enrichment?request_id=... to check status." } }

Poll for Results (GET)

Endpoint: GET https://api.nyne.ai/person/enrichment?request_id={id} Headers: Same X-API-Key and X-API-Secret as above.

Check status once

curl -s "https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" | nyne_parse > /tmp/nyne_enrich.json jq '{status: .data.status, completed: .data.completed}' /tmp/nyne_enrich.json

Full polling loop

SECONDS_WAITED=0 TIMEOUT=360 # 6 minutes while [ $SECONDS_WAITED -lt $TIMEOUT ]; do curl -s "https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID" \ -H "X-API-Key: $NYNE_API_KEY" \ -H "X-API-Secret: $NYNE_API_SECRET" | nyne_parse > /tmp/nyne_enrich.json STATUS=$(jq -r '.data.status' /tmp/nyne_enrich.json) echo "[$(date +%H:%M:%S)] Status: $STATUS ($SECONDS_WAITED s)" case "$STATUS" in completed) jq '.data.result' /tmp/nyne_enrich.json break ;; failed) echo "Enrichment failed:" jq '.data' /tmp/nyne_enrich.json break ;; *) sleep 3 SECONDS_WAITED=$((SECONDS_WAITED + 3)) ;; esac done if [ "$STATUS" != "completed" ] && [ "$STATUS" != "failed" ]; then echo "Timed out. Resume polling with request_id: $REQUEST_ID" fi

Response Structure

When status is completed: { "success": true, "timestamp": "2025-09-05T21:45:25Z", "data": { "request_id": "abc123-...", "status": "completed", "completed": true, "created_on": "2025-09-05T21:45:06", "completed_on": "2025-09-05T21:45:12", "result": { "displayname": "...", "firstname": "...", "lastname": "...", "bio": "...", "location": "...", "gender": "...", "fullphone": [...], "altemails": [...], "best_work_email": "...", "best_personal_email": "...", "social_profiles": {...}, "organizations": [...], "schools_info": [...], "newsfeed": [...], "probability": "high" } } } All fields are optional โ€” only included when data is found. No charges if person cannot be located.

Result Fields

FieldTypeDescriptiondisplaynamestringFull display namefirstnamestringFirst namelastnamestringLast namebiostringBio/headlinelocationstringLocationgenderstringGenderfullphonearrayPhone numbers, each: {fullphone, type}altemailsarrayAlternative email addressesbest_work_emailstringMost probable work emailbest_personal_emailstringMost probable personal emailsocial_profilesobjectLinkedIn, Twitter, GitHub, Instagram with URLs, usernames, follower countsorganizationsarrayWork history: {name, title, startDate, endDate, is_current}schools_infoarrayEducation: {name, degree, title, startDate, endDate}newsfeedarraySocial posts (if requested): {source, type, content, date_posted, url, engagement}probabilitystringMatch confidence: "high", "medium", "low" (only if probability_score: true)

Social Profiles Object

{ "linkedin": {"url": "...", "username": "...", "followers": 542, "connections": 1243}, "twitter": {"url": "...", "username": "...", "followers": 1234, "following": 567, "posts": 892}, "github": {"url": "...", "username": "...", "followers": 89, "following": 45}, "instagram": {"url": "...", "username": "...", "followers": 500} }

Newsfeed Item

{ "source": "linkedin", "type": "post", "content": "...", "date_posted": "2025-09-01T14:30:00Z", "url": "...", "author": {"display_name": "...", "username": "...", "profile_url": "..."}, "engagement": {"likes": 42, "comments": 5, "shares": 3, "total_reactions": 50} }

Lite Mode Response

When lite_enrich: true, only these fields are returned: displayname, firstname, lastname First organization (name + title) LinkedIn URL

Useful jq Filters

After polling completes, the clean response is at /tmp/nyne_enrich.json: # Full result jq '.data.result' /tmp/nyne_enrich.json # Identity summary jq '.data.result | {displayname, bio, location, gender}' /tmp/nyne_enrich.json # All emails jq '.data.result | {best_work_email, best_personal_email, altemails}' /tmp/nyne_enrich.json # Social profiles jq '.data.result.social_profiles' /tmp/nyne_enrich.json # Work history jq '.data.result.organizations' /tmp/nyne_enrich.json # Education jq '.data.result.schools_info' /tmp/nyne_enrich.json # Phone numbers jq '.data.result.fullphone' /tmp/nyne_enrich.json # Newsfeed posts (if requested) jq '.data.result.newsfeed[] | {source, date_posted, content, engagement}' /tmp/nyne_enrich.json # LinkedIn info specifically jq '.data.result.social_profiles.linkedin' /tmp/nyne_enrich.json # Current job jq '[.data.result.organizations[] | select(.endDate_formatted.is_current == true)]' /tmp/nyne_enrich.json

Error Handling

HTTP CodeErrorDescription400missing_parametersNo identifier provided400invalid_newsfeedBad newsfeed param (can't mix "all" with specific sources)401invalid_credentialsInvalid API key/secret403subscription_requiredPlan lacks access404request_not_foundInvalid request_id for status check429rate_limit_exceededToo many requests500internal_errorServer error

Standard Enrichment (6 credits)

The default. Returns full contact info, social profiles, work history, and education. Use this for most lookups. {"email": "someone@example.com"}

Lite Enrichment (3 credits)

lite_enrich: true โ€” Performs a minimal enrichment workflow. Returns only 5 essential fields: displayname, firstname, lastname, first organization in the organizations array, and LinkedIn URL in social_profiles.linkedin.url. When enabled, all advanced features are disabled โ€” ai_enhanced_search, newsfeed, and strict_email_check parameters are ignored (emails are not returned in lite mode). Use when you only need basic profile identification at reduced cost. {"email": "someone@example.com", "lite_enrich": true}

AI-Enhanced Search (6 credits, longer processing)

ai_enhanced_search: true โ€” Enables AI-powered deep search to discover additional social profiles and gather more comprehensive social data. Performs extensive searches and can take significantly longer to complete (up to several minutes). Only enable when comprehensive results are needed and extended processing time is acceptable. Use when standard enrichment returns sparse social profile data and you want broader coverage. {"email": "someone@example.com", "ai_enhanced_search": true}

Newsfeed Add-on (+6 credits when data found)

newsfeed: [...] โ€” Requests social media newsfeed data from specified sources. Valid sources: "linkedin", "twitter", "instagram", "github", "facebook", or "all". Cannot mix "all" with specific sources. Additional charges apply only when newsfeed data is actually found. Stacks on top of standard or AI-enhanced enrichment. Use when you need to see what someone is posting about or gauge their activity level. {"email": "someone@example.com", "newsfeed": ["linkedin", "twitter"]} {"email": "someone@example.com", "newsfeed": ["all"]}

Strict Email Check

strict_email_check: true โ€” Enables strict email validation for the best email to use. May return nothing due to its strictness. Use when email accuracy is critical and you'd rather get no result than a questionable one. {"email": "someone@example.com", "strict_email_check": true}

No Match (0 credits)

If the person cannot be found, you are not charged.

Rate Limits

Per minute: 60 requests Per hour: 1,000 requests Monthly: Plan-dependent

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
1 Docs
  • SKILL.md Primary doc

Related skills

readyClaw Free
Featured

API Architect

Design contracts before code

Designs contracts before implementation and treats REST, GraphQL, and gRPC as tools rather than dogma.

Developer Tools agent claude
souls.zip $149
Featured

The Dev Team

A four-agent engineering squad for shipping products

Four-agent engineering team spanning CTO, frontend, backend, and design roles, built to mirror the stack behind souls.zip.

Developer Tools team openclaw
readyClaw Free
Featured

Web Platform Engineer

Build for the open web with strong fundamentals

A web engineering agent grounded in HTML semantics, CSS layout systems, and browser-native resilience.

Developer Tools agent claude