{ "schemaVersion": "1.0", "item": { "slug": "nyne-enrichment", "name": "Nyne Enrichment", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/MichaelFanous2/nyne-enrichment", "canonicalUrl": "https://clawhub.ai/MichaelFanous2/nyne-enrichment", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/nyne-enrichment", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nyne-enrichment", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/nyne-enrichment" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/nyne-enrichment", "agentPageUrl": "https://openagent3.xyz/skills/nyne-enrichment/agent", "manifestUrl": "https://openagent3.xyz/skills/nyne-enrichment/agent.json", "briefUrl": "https://openagent3.xyz/skills/nyne-enrichment/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Nyne Enrichment Skill", "body": "Enrich any person by email, phone, LinkedIn URL, or name. Returns contact info, social profiles, work history, education, and optional social media posts.\n\nImportant: This API is async. You POST to submit, get a request_id, then poll GET until complete." }, { "title": "Agent Instructions", "body": "When presenting results to the user, show all available data. Walk through each section:\n\nIdentity — displayname, bio, location, gender\nContact — emails (work + personal + alt), phones with type\nSocial Profiles — LinkedIn, Twitter, GitHub, Instagram with follower counts\nWork History — all organizations with title, dates, current status\nEducation — schools with degree, field, dates\nNewsfeed (if requested) — recent posts with engagement metrics\n\nIf a field is missing from the response, it means no data was found — skip it silently.\n\nFor lite mode responses, note that only 5 fields are returned (displayname, firstname, lastname, first organization, LinkedIn URL)." }, { "title": "Setup", "body": "Required environment variables:\n\nNYNE_API_KEY — your Nyne API key\nNYNE_API_SECRET — your Nyne API secret\n\nGet credentials at https://api.nyne.ai.\n\nexport NYNE_API_KEY=\"your-api-key\"\nexport NYNE_API_SECRET=\"your-api-secret\"\n\nVerify they're set:\n\necho \"Key: ${NYNE_API_KEY:0:8}... Secret: ${NYNE_API_SECRET:0:6}...\"" }, { "title": "Important: JSON Handling", "body": "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:\n\nnyne_parse() {\n python3 -c \"\nimport sys, json, re\nraw = sys.stdin.read()\nclean = re.sub(r'[\\x00-\\x1f]+', ' ', raw)\ndata = json.loads(clean)\njson.dump(data, sys.stdout)\n\"\n}" }, { "title": "Quick Start", "body": "Submit an enrichment request by email and poll until complete:\n\nnyne_parse() {\n python3 -c \"\nimport sys, json, re\nraw = sys.stdin.read()\nclean = re.sub(r'[\\x00-\\x1f]+', ' ', raw)\ndata = json.loads(clean)\njson.dump(data, sys.stdout)\n\"\n}\n\n# Submit enrichment request\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\necho \"Request submitted: $REQUEST_ID\"\n\n# Poll until complete (checks every 3s, times out after 6 min)\nSECONDS_WAITED=0\nwhile [ $SECONDS_WAITED -lt 360 ]; do\n curl -s \"https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" | nyne_parse > /tmp/nyne_enrich.json\n STATUS=$(jq -r '.data.status' /tmp/nyne_enrich.json)\n echo \"Status: $STATUS ($SECONDS_WAITED seconds elapsed)\"\n if [ \"$STATUS\" = \"completed\" ]; then\n jq '.data.result' /tmp/nyne_enrich.json\n break\n elif [ \"$STATUS\" = \"failed\" ]; then\n echo \"Enrichment failed.\"\n jq . /tmp/nyne_enrich.json\n break\n fi\n sleep 3\n SECONDS_WAITED=$((SECONDS_WAITED + 3))\ndone\n\nif [ $SECONDS_WAITED -ge 360 ]; then\n echo \"Timed out after 6 minutes. Resume polling with request_id: $REQUEST_ID\"\nfi" }, { "title": "Submit Enrichment (POST)", "body": "Endpoint: POST https://api.nyne.ai/person/enrichment\n\nHeaders:\n\nContent-Type: application/json\nX-API-Key: $NYNE_API_KEY\nX-API-Secret: $NYNE_API_SECRET" }, { "title": "Input Parameters", "body": "At least one identifier is required.\n\nParameterTypeDescriptionemailstringEmail 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)\n\nInput priority ranking: LinkedIn URL (best) > Email (work > personal) > Phone (lowest match rate). LinkedIn + email together yields best results." }, { "title": "Feature Parameters", "body": "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" }, { "title": "Examples", "body": "By email:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\necho \"Request ID: $REQUEST_ID\"\n\nBy LinkedIn URL:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"social_media_url\": \"https://linkedin.com/in/johndoe\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\nBy name + company:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"name\": \"Jane Smith\", \"company\": \"Acme Corp\", \"city\": \"SF\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\nWith newsfeed:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\", \"newsfeed\": [\"linkedin\", \"twitter\"]}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\nLite mode (3 credits):\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\", \"lite_enrich\": true}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\nWith AI-enhanced search:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\", \"ai_enhanced_search\": true}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\nSubmit response:\n\n{\n \"success\": true,\n \"data\": {\n \"request_id\": \"abc123-...\",\n \"status\": \"queued\",\n \"message\": \"Enrichment request queued. Use GET /person/enrichment?request_id=... to check status.\"\n }\n}" }, { "title": "Poll for Results (GET)", "body": "Endpoint: GET https://api.nyne.ai/person/enrichment?request_id={id}\n\nHeaders: Same X-API-Key and X-API-Secret as above." }, { "title": "Check status once", "body": "curl -s \"https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" | nyne_parse > /tmp/nyne_enrich.json\n\njq '{status: .data.status, completed: .data.completed}' /tmp/nyne_enrich.json" }, { "title": "Full polling loop", "body": "SECONDS_WAITED=0\nTIMEOUT=360 # 6 minutes\n\nwhile [ $SECONDS_WAITED -lt $TIMEOUT ]; do\n curl -s \"https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" | nyne_parse > /tmp/nyne_enrich.json\n STATUS=$(jq -r '.data.status' /tmp/nyne_enrich.json)\n\n echo \"[$(date +%H:%M:%S)] Status: $STATUS ($SECONDS_WAITED s)\"\n\n case \"$STATUS\" in\n completed)\n jq '.data.result' /tmp/nyne_enrich.json\n break\n ;;\n failed)\n echo \"Enrichment failed:\"\n jq '.data' /tmp/nyne_enrich.json\n break\n ;;\n *)\n sleep 3\n SECONDS_WAITED=$((SECONDS_WAITED + 3))\n ;;\n esac\ndone\n\nif [ \"$STATUS\" != \"completed\" ] && [ \"$STATUS\" != \"failed\" ]; then\n echo \"Timed out. Resume polling with request_id: $REQUEST_ID\"\nfi" }, { "title": "Response Structure", "body": "When status is completed:\n\n{\n \"success\": true,\n \"timestamp\": \"2025-09-05T21:45:25Z\",\n \"data\": {\n \"request_id\": \"abc123-...\",\n \"status\": \"completed\",\n \"completed\": true,\n \"created_on\": \"2025-09-05T21:45:06\",\n \"completed_on\": \"2025-09-05T21:45:12\",\n \"result\": {\n \"displayname\": \"...\",\n \"firstname\": \"...\",\n \"lastname\": \"...\",\n \"bio\": \"...\",\n \"location\": \"...\",\n \"gender\": \"...\",\n \"fullphone\": [...],\n \"altemails\": [...],\n \"best_work_email\": \"...\",\n \"best_personal_email\": \"...\",\n \"social_profiles\": {...},\n \"organizations\": [...],\n \"schools_info\": [...],\n \"newsfeed\": [...],\n \"probability\": \"high\"\n }\n }\n}\n\nAll fields are optional — only included when data is found. No charges if person cannot be located." }, { "title": "Result Fields", "body": "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)" }, { "title": "Social Profiles Object", "body": "{\n \"linkedin\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 542, \"connections\": 1243},\n \"twitter\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 1234, \"following\": 567, \"posts\": 892},\n \"github\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 89, \"following\": 45},\n \"instagram\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 500}\n}" }, { "title": "Newsfeed Item", "body": "{\n \"source\": \"linkedin\",\n \"type\": \"post\",\n \"content\": \"...\",\n \"date_posted\": \"2025-09-01T14:30:00Z\",\n \"url\": \"...\",\n \"author\": {\"display_name\": \"...\", \"username\": \"...\", \"profile_url\": \"...\"},\n \"engagement\": {\"likes\": 42, \"comments\": 5, \"shares\": 3, \"total_reactions\": 50}\n}" }, { "title": "Lite Mode Response", "body": "When lite_enrich: true, only these fields are returned:\n\ndisplayname, firstname, lastname\nFirst organization (name + title)\nLinkedIn URL" }, { "title": "Useful jq Filters", "body": "After polling completes, the clean response is at /tmp/nyne_enrich.json:\n\n# Full result\njq '.data.result' /tmp/nyne_enrich.json\n\n# Identity summary\njq '.data.result | {displayname, bio, location, gender}' /tmp/nyne_enrich.json\n\n# All emails\njq '.data.result | {best_work_email, best_personal_email, altemails}' /tmp/nyne_enrich.json\n\n# Social profiles\njq '.data.result.social_profiles' /tmp/nyne_enrich.json\n\n# Work history\njq '.data.result.organizations' /tmp/nyne_enrich.json\n\n# Education\njq '.data.result.schools_info' /tmp/nyne_enrich.json\n\n# Phone numbers\njq '.data.result.fullphone' /tmp/nyne_enrich.json\n\n# Newsfeed posts (if requested)\njq '.data.result.newsfeed[] | {source, date_posted, content, engagement}' /tmp/nyne_enrich.json\n\n# LinkedIn info specifically\njq '.data.result.social_profiles.linkedin' /tmp/nyne_enrich.json\n\n# Current job\njq '[.data.result.organizations[] | select(.endDate_formatted.is_current == true)]' /tmp/nyne_enrich.json" }, { "title": "Error Handling", "body": "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" }, { "title": "Standard Enrichment (6 credits)", "body": "The default. Returns full contact info, social profiles, work history, and education. Use this for most lookups.\n\n{\"email\": \"someone@example.com\"}" }, { "title": "Lite Enrichment (3 credits)", "body": "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.\n\n{\"email\": \"someone@example.com\", \"lite_enrich\": true}" }, { "title": "AI-Enhanced Search (6 credits, longer processing)", "body": "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.\n\n{\"email\": \"someone@example.com\", \"ai_enhanced_search\": true}" }, { "title": "Newsfeed Add-on (+6 credits when data found)", "body": "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.\n\n{\"email\": \"someone@example.com\", \"newsfeed\": [\"linkedin\", \"twitter\"]}\n{\"email\": \"someone@example.com\", \"newsfeed\": [\"all\"]}" }, { "title": "Strict Email Check", "body": "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.\n\n{\"email\": \"someone@example.com\", \"strict_email_check\": true}" }, { "title": "No Match (0 credits)", "body": "If the person cannot be found, you are not charged." }, { "title": "Rate Limits", "body": "Per minute: 60 requests\nPer hour: 1,000 requests\nMonthly: Plan-dependent" } ], "body": "Nyne Enrichment Skill\n\nEnrich any person by email, phone, LinkedIn URL, or name. Returns contact info, social profiles, work history, education, and optional social media posts.\n\nImportant: This API is async. You POST to submit, get a request_id, then poll GET until complete.\n\nAgent Instructions\n\nWhen presenting results to the user, show all available data. Walk through each section:\n\nIdentity — displayname, bio, location, gender\nContact — emails (work + personal + alt), phones with type\nSocial Profiles — LinkedIn, Twitter, GitHub, Instagram with follower counts\nWork History — all organizations with title, dates, current status\nEducation — schools with degree, field, dates\nNewsfeed (if requested) — recent posts with engagement metrics\n\nIf a field is missing from the response, it means no data was found — skip it silently.\n\nFor lite mode responses, note that only 5 fields are returned (displayname, firstname, lastname, first organization, LinkedIn URL).\n\nSetup\n\nRequired environment variables:\n\nNYNE_API_KEY — your Nyne API key\nNYNE_API_SECRET — your Nyne API secret\n\nGet credentials at https://api.nyne.ai.\n\nexport NYNE_API_KEY=\"your-api-key\"\nexport NYNE_API_SECRET=\"your-api-secret\"\n\n\nVerify they're set:\n\necho \"Key: ${NYNE_API_KEY:0:8}... Secret: ${NYNE_API_SECRET:0:6}...\"\n\nImportant: JSON Handling\n\nThe 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:\n\nnyne_parse() {\n python3 -c \"\nimport sys, json, re\nraw = sys.stdin.read()\nclean = re.sub(r'[\\x00-\\x1f]+', ' ', raw)\ndata = json.loads(clean)\njson.dump(data, sys.stdout)\n\"\n}\n\nQuick Start\n\nSubmit an enrichment request by email and poll until complete:\n\nnyne_parse() {\n python3 -c \"\nimport sys, json, re\nraw = sys.stdin.read()\nclean = re.sub(r'[\\x00-\\x1f]+', ' ', raw)\ndata = json.loads(clean)\njson.dump(data, sys.stdout)\n\"\n}\n\n# Submit enrichment request\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\necho \"Request submitted: $REQUEST_ID\"\n\n# Poll until complete (checks every 3s, times out after 6 min)\nSECONDS_WAITED=0\nwhile [ $SECONDS_WAITED -lt 360 ]; do\n curl -s \"https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" | nyne_parse > /tmp/nyne_enrich.json\n STATUS=$(jq -r '.data.status' /tmp/nyne_enrich.json)\n echo \"Status: $STATUS ($SECONDS_WAITED seconds elapsed)\"\n if [ \"$STATUS\" = \"completed\" ]; then\n jq '.data.result' /tmp/nyne_enrich.json\n break\n elif [ \"$STATUS\" = \"failed\" ]; then\n echo \"Enrichment failed.\"\n jq . /tmp/nyne_enrich.json\n break\n fi\n sleep 3\n SECONDS_WAITED=$((SECONDS_WAITED + 3))\ndone\n\nif [ $SECONDS_WAITED -ge 360 ]; then\n echo \"Timed out after 6 minutes. Resume polling with request_id: $REQUEST_ID\"\nfi\n\nSubmit Enrichment (POST)\n\nEndpoint: POST https://api.nyne.ai/person/enrichment\n\nHeaders:\n\nContent-Type: application/json\nX-API-Key: $NYNE_API_KEY\nX-API-Secret: $NYNE_API_SECRET\n\nInput Parameters\n\nAt least one identifier is required.\n\nParameter\tType\tDescription\nemail\tstring\tEmail address (work email preferred)\nphone\tstring\tPhone number (e.g., \"+14155551234\")\nsocial_media_url\tstring\tLinkedIn, Twitter, or GitHub URL\nname\tstring\tFull name (use with company or city to disambiguate)\ncompany\tstring\tCompany name (helps disambiguate name lookups)\ncity\tstring\tCity (accepts abbreviations: SF, NYC, LA)\n\nInput priority ranking: LinkedIn URL (best) > Email (work > personal) > Phone (lowest match rate). LinkedIn + email together yields best results.\n\nFeature Parameters\nParameter\tType\tDefault\tDescription\nai_enhanced_search\tboolean\tfalse\tAI-powered deep search for additional social profiles. Longer processing time.\nlite_enrich\tboolean\tfalse\tMinimal enrichment: only 5 fields, 3 credits instead of 6\nnewsfeed\tarray\tomit\tSocial posts to fetch: [\"linkedin\", \"twitter\", \"instagram\", \"github\", \"facebook\"] or [\"all\"]. Cannot mix \"all\" with specific sources. +6 credits when data found.\nstrict_email_check\tboolean\tfalse\tStrict email validation (may return no results)\ncallback_url\tstring\tomit\tWebhook URL for async delivery\nExamples\n\nBy email:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\necho \"Request ID: $REQUEST_ID\"\n\n\nBy LinkedIn URL:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"social_media_url\": \"https://linkedin.com/in/johndoe\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\n\nBy name + company:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"name\": \"Jane Smith\", \"company\": \"Acme Corp\", \"city\": \"SF\"}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\n\nWith newsfeed:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\", \"newsfeed\": [\"linkedin\", \"twitter\"]}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\n\nLite mode (3 credits):\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\", \"lite_enrich\": true}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\n\nWith AI-enhanced search:\n\ncurl -s -X POST \"https://api.nyne.ai/person/enrichment\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" \\\n -d '{\"email\": \"someone@example.com\", \"ai_enhanced_search\": true}' | nyne_parse > /tmp/nyne_enrich.json\n\nREQUEST_ID=$(jq -r '.data.request_id' /tmp/nyne_enrich.json)\n\n\nSubmit response:\n\n{\n \"success\": true,\n \"data\": {\n \"request_id\": \"abc123-...\",\n \"status\": \"queued\",\n \"message\": \"Enrichment request queued. Use GET /person/enrichment?request_id=... to check status.\"\n }\n}\n\nPoll for Results (GET)\n\nEndpoint: GET https://api.nyne.ai/person/enrichment?request_id={id}\n\nHeaders: Same X-API-Key and X-API-Secret as above.\n\nCheck status once\ncurl -s \"https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" | nyne_parse > /tmp/nyne_enrich.json\n\njq '{status: .data.status, completed: .data.completed}' /tmp/nyne_enrich.json\n\nFull polling loop\nSECONDS_WAITED=0\nTIMEOUT=360 # 6 minutes\n\nwhile [ $SECONDS_WAITED -lt $TIMEOUT ]; do\n curl -s \"https://api.nyne.ai/person/enrichment?request_id=$REQUEST_ID\" \\\n -H \"X-API-Key: $NYNE_API_KEY\" \\\n -H \"X-API-Secret: $NYNE_API_SECRET\" | nyne_parse > /tmp/nyne_enrich.json\n STATUS=$(jq -r '.data.status' /tmp/nyne_enrich.json)\n\n echo \"[$(date +%H:%M:%S)] Status: $STATUS ($SECONDS_WAITED s)\"\n\n case \"$STATUS\" in\n completed)\n jq '.data.result' /tmp/nyne_enrich.json\n break\n ;;\n failed)\n echo \"Enrichment failed:\"\n jq '.data' /tmp/nyne_enrich.json\n break\n ;;\n *)\n sleep 3\n SECONDS_WAITED=$((SECONDS_WAITED + 3))\n ;;\n esac\ndone\n\nif [ \"$STATUS\" != \"completed\" ] && [ \"$STATUS\" != \"failed\" ]; then\n echo \"Timed out. Resume polling with request_id: $REQUEST_ID\"\nfi\n\nResponse Structure\n\nWhen status is completed:\n\n{\n \"success\": true,\n \"timestamp\": \"2025-09-05T21:45:25Z\",\n \"data\": {\n \"request_id\": \"abc123-...\",\n \"status\": \"completed\",\n \"completed\": true,\n \"created_on\": \"2025-09-05T21:45:06\",\n \"completed_on\": \"2025-09-05T21:45:12\",\n \"result\": {\n \"displayname\": \"...\",\n \"firstname\": \"...\",\n \"lastname\": \"...\",\n \"bio\": \"...\",\n \"location\": \"...\",\n \"gender\": \"...\",\n \"fullphone\": [...],\n \"altemails\": [...],\n \"best_work_email\": \"...\",\n \"best_personal_email\": \"...\",\n \"social_profiles\": {...},\n \"organizations\": [...],\n \"schools_info\": [...],\n \"newsfeed\": [...],\n \"probability\": \"high\"\n }\n }\n}\n\n\nAll fields are optional — only included when data is found. No charges if person cannot be located.\n\nResult Fields\nField\tType\tDescription\ndisplayname\tstring\tFull display name\nfirstname\tstring\tFirst name\nlastname\tstring\tLast name\nbio\tstring\tBio/headline\nlocation\tstring\tLocation\ngender\tstring\tGender\nfullphone\tarray\tPhone numbers, each: {fullphone, type}\naltemails\tarray\tAlternative email addresses\nbest_work_email\tstring\tMost probable work email\nbest_personal_email\tstring\tMost probable personal email\nsocial_profiles\tobject\tLinkedIn, Twitter, GitHub, Instagram with URLs, usernames, follower counts\norganizations\tarray\tWork history: {name, title, startDate, endDate, is_current}\nschools_info\tarray\tEducation: {name, degree, title, startDate, endDate}\nnewsfeed\tarray\tSocial posts (if requested): {source, type, content, date_posted, url, engagement}\nprobability\tstring\tMatch confidence: \"high\", \"medium\", \"low\" (only if probability_score: true)\nSocial Profiles Object\n{\n \"linkedin\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 542, \"connections\": 1243},\n \"twitter\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 1234, \"following\": 567, \"posts\": 892},\n \"github\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 89, \"following\": 45},\n \"instagram\": {\"url\": \"...\", \"username\": \"...\", \"followers\": 500}\n}\n\nNewsfeed Item\n{\n \"source\": \"linkedin\",\n \"type\": \"post\",\n \"content\": \"...\",\n \"date_posted\": \"2025-09-01T14:30:00Z\",\n \"url\": \"...\",\n \"author\": {\"display_name\": \"...\", \"username\": \"...\", \"profile_url\": \"...\"},\n \"engagement\": {\"likes\": 42, \"comments\": 5, \"shares\": 3, \"total_reactions\": 50}\n}\n\nLite Mode Response\n\nWhen lite_enrich: true, only these fields are returned:\n\ndisplayname, firstname, lastname\nFirst organization (name + title)\nLinkedIn URL\nUseful jq Filters\n\nAfter polling completes, the clean response is at /tmp/nyne_enrich.json:\n\n# Full result\njq '.data.result' /tmp/nyne_enrich.json\n\n# Identity summary\njq '.data.result | {displayname, bio, location, gender}' /tmp/nyne_enrich.json\n\n# All emails\njq '.data.result | {best_work_email, best_personal_email, altemails}' /tmp/nyne_enrich.json\n\n# Social profiles\njq '.data.result.social_profiles' /tmp/nyne_enrich.json\n\n# Work history\njq '.data.result.organizations' /tmp/nyne_enrich.json\n\n# Education\njq '.data.result.schools_info' /tmp/nyne_enrich.json\n\n# Phone numbers\njq '.data.result.fullphone' /tmp/nyne_enrich.json\n\n# Newsfeed posts (if requested)\njq '.data.result.newsfeed[] | {source, date_posted, content, engagement}' /tmp/nyne_enrich.json\n\n# LinkedIn info specifically\njq '.data.result.social_profiles.linkedin' /tmp/nyne_enrich.json\n\n# Current job\njq '[.data.result.organizations[] | select(.endDate_formatted.is_current == true)]' /tmp/nyne_enrich.json\n\nError Handling\nHTTP Code\tError\tDescription\n400\tmissing_parameters\tNo identifier provided\n400\tinvalid_newsfeed\tBad newsfeed param (can't mix \"all\" with specific sources)\n401\tinvalid_credentials\tInvalid API key/secret\n403\tsubscription_required\tPlan lacks access\n404\trequest_not_found\tInvalid request_id for status check\n429\trate_limit_exceeded\tToo many requests\n500\tinternal_error\tServer error\nModes & When to Use Each\nStandard Enrichment (6 credits)\n\nThe default. Returns full contact info, social profiles, work history, and education. Use this for most lookups.\n\n{\"email\": \"someone@example.com\"}\n\nLite Enrichment (3 credits)\n\nlite_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.\n\n{\"email\": \"someone@example.com\", \"lite_enrich\": true}\n\nAI-Enhanced Search (6 credits, longer processing)\n\nai_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.\n\n{\"email\": \"someone@example.com\", \"ai_enhanced_search\": true}\n\nNewsfeed Add-on (+6 credits when data found)\n\nnewsfeed: [...] — 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.\n\n{\"email\": \"someone@example.com\", \"newsfeed\": [\"linkedin\", \"twitter\"]}\n{\"email\": \"someone@example.com\", \"newsfeed\": [\"all\"]}\n\nStrict Email Check\n\nstrict_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.\n\n{\"email\": \"someone@example.com\", \"strict_email_check\": true}\n\nNo Match (0 credits)\n\nIf the person cannot be found, you are not charged.\n\nRate Limits\nPer minute: 60 requests\nPer hour: 1,000 requests\nMonthly: Plan-dependent" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/MichaelFanous2/nyne-enrichment", "publisherUrl": "https://clawhub.ai/MichaelFanous2/nyne-enrichment", "owner": "MichaelFanous2", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/nyne-enrichment", "downloadUrl": "https://openagent3.xyz/downloads/nyne-enrichment", "agentUrl": "https://openagent3.xyz/skills/nyne-enrichment/agent", "manifestUrl": "https://openagent3.xyz/skills/nyne-enrichment/agent.json", "briefUrl": "https://openagent3.xyz/skills/nyne-enrichment/agent.md" } }