{"skill":{"slug":"nuwa-world-osint-human-research","displayName":"Nuwa World - OSINT Human Research","summary":"Face search and deep research via the Nuwa World API — visual identity intelligence and knowledge synthesis from the open web.","description":"---\nname: nuwa-world-api\ndescription: Face search and deep research via the Nuwa World API — visual identity intelligence and knowledge synthesis from the open web.\nversion: 1.0.0\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - NUWA_API_KEY\n      bins:\n        - curl\n    primaryEnv: NUWA_API_KEY\n    emoji: \"🔍\"\n    homepage: https://gateway.nuwa.world/docs\n---\n\n# Nuwa World API\n\nTwo capabilities via `gateway.nuwa.world`:\n\n- **Face Search** — upload a face image, get matching URLs across the internet\n- **Deep Research** — submit a question, get a structured summary with citations\n\nBase URL: `https://gateway.nuwa.world/api/v1`\nAuth: `X-API-Key: $NUWA_API_KEY` header on every request.\nGet your key at https://platform.nuwa.world\n\n---\n\n## Face Search (10 credits)\n\nTwo-step async flow: upload → poll.\n\n### Step 1 — Upload\n\n```bash\ncurl -X POST https://gateway.nuwa.world/api/v1/face-search \\\n  -H \"X-API-Key: $NUWA_API_KEY\" \\\n  -F \"image=@photo.jpg\"\n```\n\nResponse (HTTP 202):\n\n```json\n{\n  \"search_id\": \"abc123\",\n  \"status\": \"processing\",\n  \"message\": \"Face uploaded. Poll GET /api/v1/face-search/{search_id} for results.\"\n}\n```\n\n### Step 2 — Poll (every 3–5 seconds, no credit cost)\n\n```bash\ncurl https://gateway.nuwa.world/api/v1/face-search/abc123 \\\n  -H \"X-API-Key: $NUWA_API_KEY\"\n```\n\nWhile processing:\n\n```json\n{ \"search_id\": \"abc123\", \"status\": \"processing\", \"results\": [], \"total_results\": 0 }\n```\n\nWhen done:\n\n```json\n{\n  \"search_id\": \"abc123\",\n  \"status\": \"completed\",\n  \"results\": [\n    { \"index\": 0, \"score\": 95.2, \"url\": \"https://example.com/profile\" },\n    { \"index\": 1, \"score\": 82.1, \"url\": \"https://social.example/user\" }\n  ],\n  \"total_results\": 2,\n  \"max_score\": 95.2\n}\n```\n\nProcessing takes 15–30 seconds. Results expire after 2 hours.\n\n---\n\n## Deep Research (20 credits)\n\nSingle synchronous call. Returns in 10–60 seconds.\n\n```bash\ncurl -X POST https://gateway.nuwa.world/api/v1/deep-research \\\n  -H \"X-API-Key: $NUWA_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\": \"0xajc on X\"}'\n```\n\nResponse:\n\n```json\n{\n  \"query\": \"Research the X user '0xajc' footprint on web.\",\n  \"summary\": \"Anthropic is an AI safety company founded in 2021...\",\n  \"facts\": [\n    \"X user '0xajc's real name is Andrew Chen\",\n    \"He founded Instap in 2020 and Nuwa Word in 2025\"\n    \"Studied CS/Managment in University of Massachusetts and dropped out\"\n  ],\n  \"sources\": [\n    { \"title\": \"0xajc - About\", \"url\": \"https://app.nuwa.world/research/04b7ac93-c711-4780-9c48-9201cf7f7e78\" }\n  ]\n}\n```\n\nQuery max length: 2000 characters.\n\n---\n\n## Error format\n\nAll errors follow:\n\n```json\n{ \"error\": { \"code\": \"ERROR_CODE\", \"message\": \"Human-readable description\" } }\n```\n\nCommon codes: `INVALID_API_KEY`, `RATE_LIMITED`, `INSUFFICIENT_CREDITS`, `UPLOAD_FAILED`, `NOT_FOUND`, `RESEARCH_FAILED`.\n\n---\n\n## Credit costs\n\n| Endpoint | Credits |\n|----------|---------|\n| Face Search (upload) | 10 |\n| Face Search (poll) | 0 |\n| Deep Research | 20 |\n\nFree tier: 30 credits/month. Plans at https://platform.nuwa.world\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":1526,"installsAllTime":0,"installsCurrent":0,"stars":2,"versions":1},"createdAt":1771820197396,"updatedAt":1778491617178},"latestVersion":{"version":"1.0.0","createdAt":1771820197396,"changelog":"Initial release of nuwa-world-api skill.\n\n- Enables face search to find matching URLs across the web by image upload and polling.\n- Provides deep research functionality to answer questions with structured summaries and citations of a person.\n- Details on API authentication and endpoint usage included.\n- Documents response formats, error handling, and credit costs.\n- Requires a Nuwa World API key and curl installed.","license":null},"metadata":{"setup":[{"key":"NUWA_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"andrewchen-oss","userId":"s17ayt1af2wsq9b1t9098b3tt18845zr","displayName":"Andrew Chen","image":"https://avatars.githubusercontent.com/u/110896927?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779952109535}}