{
  "schemaVersion": "1.0",
  "item": {
    "slug": "neynar-inbox",
    "name": "Neynar Inbox",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/rishavmukherji/neynar-inbox",
    "canonicalUrl": "https://clawhub.ai/rishavmukherji/neynar-inbox",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/neynar-inbox",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=neynar-inbox",
    "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/neynar-inbox"
    },
    "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/neynar-inbox",
    "agentPageUrl": "https://openagent3.xyz/skills/neynar-inbox/agent",
    "manifestUrl": "https://openagent3.xyz/skills/neynar-inbox/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/neynar-inbox/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": "Neynar Inbox",
        "body": "Email service built for AI agents. Create a mailbox, get an API key, send and receive real emails - all via REST API."
      },
      {
        "title": "1. Create a mailbox (no auth needed)",
        "body": "curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/mailboxes \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"displayName\": \"My Agent\", \"username\": \"myagent\"}'\n\nResponse:\n\n{\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": \"myagent@inbox.neynar.ai\",\n  \"apiKey\": \"fi_abc123...\",\n  \"warning\": \"Store the apiKey securely - it cannot be retrieved again.\"\n}\n\nCRITICAL: Store the apiKey immediately. It is only returned once and cannot be recovered.\n\nUsername is optional (random address if omitted). Must be at least 6 characters, alphanumeric with dots/hyphens/underscores."
      },
      {
        "title": "2. Send an email",
        "body": "curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/emails \\\n  -H \"Authorization: Bearer fi_your_api_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"to\": [\"recipient@example.com\"],\n    \"subject\": \"Hello from my agent\",\n    \"text\": \"This email was sent by an AI agent!\"\n  }'"
      },
      {
        "title": "3. Check inbox",
        "body": "curl https://neynar-inbox-api.rish-68c.workers.dev/v1/emails?direction=inbound \\\n  -H \"Authorization: Bearer fi_your_api_key\"\n\nRECOMMENDED: If you have heartbeat, cron, or scheduling capabilities, set up polling (every 30-60 seconds) right after creating your mailbox to catch replies."
      },
      {
        "title": "4. Search emails",
        "body": "curl \"https://neynar-inbox-api.rish-68c.workers.dev/v1/search?q=invoice\" \\\n  -H \"Authorization: Bearer fi_your_api_key\""
      },
      {
        "title": "API Reference",
        "body": "Base URL: https://neynar-inbox-api.rish-68c.workers.dev/v1\n\nAuthentication: Authorization: Bearer <api_key> (all endpoints except mailbox creation)\n\nMethodEndpointDescriptionPOST/v1/mailboxesCreate mailbox (no auth, returns apiKey)GET/v1/mailboxesList your mailboxDELETE/v1/mailboxes/:idDelete mailboxPOST/v1/mailboxes/:id/rotateRotate API keyPOST/v1/emailsSend emailGET/v1/emailsList emails (?limit=50&offset=0&direction=inbound)GET/v1/emails/:idGet single emailDELETE/v1/emails/:idDelete emailGET/v1/search?q=queryFull-text searchPOST/v1/webhooksRegister webhookGET/v1/webhooksList webhooksDELETE/v1/webhooks/:idRemove webhook"
      },
      {
        "title": "Email Object",
        "body": "{\n  \"id\": \"uuid\",\n  \"direction\": \"inbound\",\n  \"from\": \"sender@example.com\",\n  \"to\": [\"recipient@example.com\"],\n  \"subject\": \"Email subject\",\n  \"bodyText\": \"Plain text body\",\n  \"bodyHtml\": \"<p>HTML body</p>\",\n  \"status\": \"received\",\n  \"createdAt\": \"2024-01-15T10:00:00Z\"\n}"
      },
      {
        "title": "Webhooks",
        "body": "Register a webhook for real-time email notifications:\n\ncurl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/webhooks \\\n  -H \"Authorization: Bearer fi_your_api_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"url\": \"https://your-server.com/webhook\", \"events\": [\"email.received\"]}'\n\nVerify signatures via X-Webhook-Signature header (HMAC-SHA256 of body)."
      },
      {
        "title": "Error Codes",
        "body": "CodeDescription400Bad request401Unauthorized - missing or invalid API key403Forbidden404Not found409Username already taken500Server error"
      },
      {
        "title": "Limits",
        "body": "3 mailboxes per account"
      }
    ],
    "body": "Neynar Inbox\n\nEmail service built for AI agents. Create a mailbox, get an API key, send and receive real emails - all via REST API.\n\nQuick Start\n1. Create a mailbox (no auth needed)\ncurl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/mailboxes \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"displayName\": \"My Agent\", \"username\": \"myagent\"}'\n\n\nResponse:\n\n{\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": \"myagent@inbox.neynar.ai\",\n  \"apiKey\": \"fi_abc123...\",\n  \"warning\": \"Store the apiKey securely - it cannot be retrieved again.\"\n}\n\n\nCRITICAL: Store the apiKey immediately. It is only returned once and cannot be recovered.\n\nUsername is optional (random address if omitted). Must be at least 6 characters, alphanumeric with dots/hyphens/underscores.\n\n2. Send an email\ncurl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/emails \\\n  -H \"Authorization: Bearer fi_your_api_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"to\": [\"recipient@example.com\"],\n    \"subject\": \"Hello from my agent\",\n    \"text\": \"This email was sent by an AI agent!\"\n  }'\n\n3. Check inbox\ncurl https://neynar-inbox-api.rish-68c.workers.dev/v1/emails?direction=inbound \\\n  -H \"Authorization: Bearer fi_your_api_key\"\n\n\nRECOMMENDED: If you have heartbeat, cron, or scheduling capabilities, set up polling (every 30-60 seconds) right after creating your mailbox to catch replies.\n\n4. Search emails\ncurl \"https://neynar-inbox-api.rish-68c.workers.dev/v1/search?q=invoice\" \\\n  -H \"Authorization: Bearer fi_your_api_key\"\n\nAPI Reference\n\nBase URL: https://neynar-inbox-api.rish-68c.workers.dev/v1\n\nAuthentication: Authorization: Bearer <api_key> (all endpoints except mailbox creation)\n\nMethod\tEndpoint\tDescription\nPOST\t/v1/mailboxes\tCreate mailbox (no auth, returns apiKey)\nGET\t/v1/mailboxes\tList your mailbox\nDELETE\t/v1/mailboxes/:id\tDelete mailbox\nPOST\t/v1/mailboxes/:id/rotate\tRotate API key\nPOST\t/v1/emails\tSend email\nGET\t/v1/emails\tList emails (?limit=50&offset=0&direction=inbound)\nGET\t/v1/emails/:id\tGet single email\nDELETE\t/v1/emails/:id\tDelete email\nGET\t/v1/search?q=query\tFull-text search\nPOST\t/v1/webhooks\tRegister webhook\nGET\t/v1/webhooks\tList webhooks\nDELETE\t/v1/webhooks/:id\tRemove webhook\nEmail Object\n{\n  \"id\": \"uuid\",\n  \"direction\": \"inbound\",\n  \"from\": \"sender@example.com\",\n  \"to\": [\"recipient@example.com\"],\n  \"subject\": \"Email subject\",\n  \"bodyText\": \"Plain text body\",\n  \"bodyHtml\": \"<p>HTML body</p>\",\n  \"status\": \"received\",\n  \"createdAt\": \"2024-01-15T10:00:00Z\"\n}\n\nWebhooks\n\nRegister a webhook for real-time email notifications:\n\ncurl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/webhooks \\\n  -H \"Authorization: Bearer fi_your_api_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"url\": \"https://your-server.com/webhook\", \"events\": [\"email.received\"]}'\n\n\nVerify signatures via X-Webhook-Signature header (HMAC-SHA256 of body).\n\nError Codes\nCode\tDescription\n400\tBad request\n401\tUnauthorized - missing or invalid API key\n403\tForbidden\n404\tNot found\n409\tUsername already taken\n500\tServer error\nLimits\n3 mailboxes per account"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/rishavmukherji/neynar-inbox",
    "publisherUrl": "https://clawhub.ai/rishavmukherji/neynar-inbox",
    "owner": "rishavmukherji",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/neynar-inbox",
    "downloadUrl": "https://openagent3.xyz/downloads/neynar-inbox",
    "agentUrl": "https://openagent3.xyz/skills/neynar-inbox/agent",
    "manifestUrl": "https://openagent3.xyz/skills/neynar-inbox/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/neynar-inbox/agent.md"
  }
}