{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zyla-api-hub-skill",
    "name": "Zyla API Hub Skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/alebrega/zyla-api-hub-skill",
    "canonicalUrl": "https://clawhub.ai/alebrega/zyla-api-hub-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/zyla-api-hub-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zyla-api-hub-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "openclaw.plugin.json",
      "package-lock.json",
      "package.json",
      "plugin/index.ts"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-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/zyla-api-hub-skill"
    },
    "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/zyla-api-hub-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/zyla-api-hub-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zyla-api-hub-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zyla-api-hub-skill/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Zyla API Hub Skill",
        "body": "Turn your OpenClaw AI agent into a real-world operator.\nPower it with 10,000+ production-ready APIs from Zyla API Hub — instant access to weather, finance, translation, email validation, geolocation, and more, all through one unified API key, pay-as-you-go pricing, and zero vendor lock-in."
      },
      {
        "title": "Setup",
        "body": "If ZYLA_API_KEY is not configured, guide the user:\n\nVisit https://zylalabs.com/openclaw/connect to get an API key\nOr run /zyla connect if the plugin is installed (opens browser automatically)\nAdd the key to ~/.openclaw/openclaw.json under skills.entries.zyla-api-hub-skill.apiKey\n\nNever ask the user to paste their API key in chat. Ask them to set it via the config and confirm when ready."
      },
      {
        "title": "Quick Start — Popular APIs",
        "body": "Use these directly without searching the catalog. Each includes the API ID, endpoint details, and parameters."
      },
      {
        "title": "Weather by Zip API (ID: 781)",
        "body": "Use when: user asks about weather, temperature, forecast, climate, conditions by zip code\nCategory: Weather & Environment\nCall: npx tsx {baseDir}/scripts/zyla-api.ts call --api 781 --endpoint <endpoint_id> --params '{\"zip\":\"10001\"}'"
      },
      {
        "title": "Currency Conversion API (example)",
        "body": "Use when: user asks about currency exchange, conversion rates, forex\nCategory: Finance\nCall: npx tsx {baseDir}/scripts/zyla-api.ts call --api <id> --endpoint <endpoint_id> --params '{\"from\":\"USD\",\"to\":\"EUR\",\"amount\":\"100\"}'"
      },
      {
        "title": "Email Validation API (example)",
        "body": "Use when: user asks to validate, verify, or check an email address\nCategory: Data Validation\nCall: npx tsx {baseDir}/scripts/zyla-api.ts call --api <id> --endpoint <endpoint_id> --params '{\"email\":\"test@example.com\"}'\n\nNote: Run npx tsx {baseDir}/scripts/generate-popular.ts to regenerate this section with real API IDs and endpoints from the live catalog."
      },
      {
        "title": "Discovering APIs",
        "body": "For APIs not listed above, search the catalog:\n\n# Search by keyword\nnpx tsx {baseDir}/scripts/zyla-catalog.ts search \"recipe\"\n\n# List APIs by category\nnpx tsx {baseDir}/scripts/zyla-catalog.ts list --category \"Finance\"\n\n# Get endpoints for a specific API\nnpx tsx {baseDir}/scripts/zyla-catalog.ts endpoints --api 781"
      },
      {
        "title": "Using the helper script (recommended)",
        "body": "# Basic call\nnpx tsx {baseDir}/scripts/zyla-api.ts call \\\n  --api <api_id> \\\n  --endpoint <endpoint_id> \\\n  --params '{\"key\":\"value\"}'\n\n# Specify HTTP method (default: GET)\nnpx tsx {baseDir}/scripts/zyla-api.ts call \\\n  --api <api_id> \\\n  --endpoint <endpoint_id> \\\n  --method POST \\\n  --params '{\"key\":\"value\"}'\n\n# Get info about an API\nnpx tsx {baseDir}/scripts/zyla-api.ts info --api <api_id>\n\n# Check health and remaining quota\nnpx tsx {baseDir}/scripts/zyla-api.ts health"
      },
      {
        "title": "Using curl (fallback)",
        "body": "curl -H \"Authorization: Bearer $ZYLA_API_KEY\" \\\n  \"https://zylalabs.com/api/{api_id}/{api_slug}/{endpoint_id}/{endpoint_slug}?param=value\"\n\nURL pattern: https://zylalabs.com/api/{api_id}/{api_name_slug}/{endpoint_id}/{endpoint_name_slug}\n\napi_id and endpoint_id are numeric IDs (these do the actual routing)\napi_name_slug and endpoint_name_slug are URL-friendly names (for readability)"
      },
      {
        "title": "Error Handling",
        "body": "401 Unauthorized: API key is invalid or expired. Ask the user to run /zyla connect or visit https://zylalabs.com/openclaw/connect to get a new key.\n403 Forbidden: Subscription issue. The pay-as-you-go plan should handle this automatically. If it persists, ask the user to contact support.\n429 Too Many Requests: Rate limit exceeded. Check the X-Zyla-RateLimit-Minute-Remaining response header. Wait before retrying.\n404 Not Found: The API or endpoint does not exist. Verify the IDs using the catalog.\n5xx Server Error: Upstream API issue. Retry after a short delay (2-5 seconds)."
      },
      {
        "title": "Rate Limit Headers",
        "body": "Every API response includes these headers:\n\nX-Zyla-RateLimit-Minute-Limit: Max requests per minute\nX-Zyla-RateLimit-Minute-Remaining: Remaining requests this minute\nX-Zyla-API-Calls-Monthly-Used: Total calls this billing cycle\nX-Zyla-API-Calls-Monthly-Remaining: Remaining calls this cycle"
      },
      {
        "title": "Billing",
        "body": "Pay-as-you-go: No monthly fee. Each API call is billed at the API's per-call rate.\nBilling happens at the end of each cycle via Stripe.\nUse the health endpoint to check current usage: npx tsx {baseDir}/scripts/zyla-api.ts health"
      }
    ],
    "body": "Zyla API Hub Skill\n\nTurn your OpenClaw AI agent into a real-world operator. Power it with 10,000+ production-ready APIs from Zyla API Hub — instant access to weather, finance, translation, email validation, geolocation, and more, all through one unified API key, pay-as-you-go pricing, and zero vendor lock-in.\n\nSetup\n\nIf ZYLA_API_KEY is not configured, guide the user:\n\nVisit https://zylalabs.com/openclaw/connect to get an API key\nOr run /zyla connect if the plugin is installed (opens browser automatically)\nAdd the key to ~/.openclaw/openclaw.json under skills.entries.zyla-api-hub-skill.apiKey\n\nNever ask the user to paste their API key in chat. Ask them to set it via the config and confirm when ready.\n\nQuick Start — Popular APIs\n\nUse these directly without searching the catalog. Each includes the API ID, endpoint details, and parameters.\n\n<!-- POPULAR_APIS_START --> <!-- This section is auto-generated by: npx tsx scripts/generate-popular.ts --> <!-- Run before publishing to update with the latest top 20 APIs by popularity -->\nWeather by Zip API (ID: 781)\nUse when: user asks about weather, temperature, forecast, climate, conditions by zip code\nCategory: Weather & Environment\nCall: npx tsx {baseDir}/scripts/zyla-api.ts call --api 781 --endpoint <endpoint_id> --params '{\"zip\":\"10001\"}'\nCurrency Conversion API (example)\nUse when: user asks about currency exchange, conversion rates, forex\nCategory: Finance\nCall: npx tsx {baseDir}/scripts/zyla-api.ts call --api <id> --endpoint <endpoint_id> --params '{\"from\":\"USD\",\"to\":\"EUR\",\"amount\":\"100\"}'\nEmail Validation API (example)\nUse when: user asks to validate, verify, or check an email address\nCategory: Data Validation\nCall: npx tsx {baseDir}/scripts/zyla-api.ts call --api <id> --endpoint <endpoint_id> --params '{\"email\":\"test@example.com\"}'\n\nNote: Run npx tsx {baseDir}/scripts/generate-popular.ts to regenerate this section with real API IDs and endpoints from the live catalog.\n\n<!-- POPULAR_APIS_END -->\nDiscovering APIs\n\nFor APIs not listed above, search the catalog:\n\n# Search by keyword\nnpx tsx {baseDir}/scripts/zyla-catalog.ts search \"recipe\"\n\n# List APIs by category\nnpx tsx {baseDir}/scripts/zyla-catalog.ts list --category \"Finance\"\n\n# Get endpoints for a specific API\nnpx tsx {baseDir}/scripts/zyla-catalog.ts endpoints --api 781\n\nCalling APIs\nUsing the helper script (recommended)\n# Basic call\nnpx tsx {baseDir}/scripts/zyla-api.ts call \\\n  --api <api_id> \\\n  --endpoint <endpoint_id> \\\n  --params '{\"key\":\"value\"}'\n\n# Specify HTTP method (default: GET)\nnpx tsx {baseDir}/scripts/zyla-api.ts call \\\n  --api <api_id> \\\n  --endpoint <endpoint_id> \\\n  --method POST \\\n  --params '{\"key\":\"value\"}'\n\n# Get info about an API\nnpx tsx {baseDir}/scripts/zyla-api.ts info --api <api_id>\n\n# Check health and remaining quota\nnpx tsx {baseDir}/scripts/zyla-api.ts health\n\nUsing curl (fallback)\ncurl -H \"Authorization: Bearer $ZYLA_API_KEY\" \\\n  \"https://zylalabs.com/api/{api_id}/{api_slug}/{endpoint_id}/{endpoint_slug}?param=value\"\n\n\nURL pattern: https://zylalabs.com/api/{api_id}/{api_name_slug}/{endpoint_id}/{endpoint_name_slug}\n\napi_id and endpoint_id are numeric IDs (these do the actual routing)\napi_name_slug and endpoint_name_slug are URL-friendly names (for readability)\nError Handling\n401 Unauthorized: API key is invalid or expired. Ask the user to run /zyla connect or visit https://zylalabs.com/openclaw/connect to get a new key.\n403 Forbidden: Subscription issue. The pay-as-you-go plan should handle this automatically. If it persists, ask the user to contact support.\n429 Too Many Requests: Rate limit exceeded. Check the X-Zyla-RateLimit-Minute-Remaining response header. Wait before retrying.\n404 Not Found: The API or endpoint does not exist. Verify the IDs using the catalog.\n5xx Server Error: Upstream API issue. Retry after a short delay (2-5 seconds).\nRate Limit Headers\n\nEvery API response includes these headers:\n\nX-Zyla-RateLimit-Minute-Limit: Max requests per minute\nX-Zyla-RateLimit-Minute-Remaining: Remaining requests this minute\nX-Zyla-API-Calls-Monthly-Used: Total calls this billing cycle\nX-Zyla-API-Calls-Monthly-Remaining: Remaining calls this cycle\nBilling\nPay-as-you-go: No monthly fee. Each API call is billed at the API's per-call rate.\nBilling happens at the end of each cycle via Stripe.\nUse the health endpoint to check current usage: npx tsx {baseDir}/scripts/zyla-api.ts health"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/alebrega/zyla-api-hub-skill",
    "publisherUrl": "https://clawhub.ai/alebrega/zyla-api-hub-skill",
    "owner": "alebrega",
    "version": "1.0.7",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zyla-api-hub-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/zyla-api-hub-skill",
    "agentUrl": "https://openagent3.xyz/skills/zyla-api-hub-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zyla-api-hub-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zyla-api-hub-skill/agent.md"
  }
}