{
  "schemaVersion": "1.0",
  "item": {
    "slug": "alpha-vantage",
    "name": "Alpha Vantage CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/oscraters/alpha-vantage",
    "canonicalUrl": "https://clawhub.ai/oscraters/alpha-vantage",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/alpha-vantage",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=alpha-vantage",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/api_docs.md",
      "scripts/alpha_vantage_client.py"
    ],
    "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-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/alpha-vantage"
    },
    "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/alpha-vantage",
    "agentPageUrl": "https://openagent3.xyz/skills/alpha-vantage/agent",
    "manifestUrl": "https://openagent3.xyz/skills/alpha-vantage/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/alpha-vantage/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": "Overview",
        "body": "This skill provides a production-ready workflow for Alpha Vantage API usage: selecting the right endpoints, building validated requests, handling throttling/error responses, and preparing safe public/commercial deployment."
      },
      {
        "title": "Quick Start",
        "body": "Set API key: export ALPHAVANTAGE_API_KEY=...\nFor endpoint/params, read references/api_docs.md\nFor scriptable calls with retry/backoff, use scripts/alpha_vantage_client.py\nFor public deployment, follow the Deployment Guardrails section before release"
      },
      {
        "title": "Workflow",
        "body": "Classify request type:\n\nPrice bars or latest price: time series functions\nIndicators (RSI, SMA, MACD, etc.): technical indicator functions\nCompany info, earnings, statements: fundamentals\nFX/Crypto/Commodities/Macro: their dedicated function families\n\nResolve mandatory parameters from references/api_docs.md.\nBuild request with function=... and apikey=....\nParse response and branch for:\n\nHTTP error status\nError Message\nNote (usually rate-limit/throttle condition)\nEmpty/partial payload\n\nIf Note/throttled, retry using exponential backoff with jitter.\nNormalize output to a stable schema before downstream use."
      },
      {
        "title": "Authentication",
        "body": "Use ALPHAVANTAGE_API_KEY environment variable by default.\nNever hardcode keys in source, logs, prompts, or examples.\nMask keys in debug output (show only short prefix/suffix)."
      },
      {
        "title": "Reliability and Rate Limits",
        "body": "Treat responses containing Note as retriable throttle events.\nUse bounded retries with exponential backoff and jitter.\nFor multi-symbol jobs, queue calls and pace to plan limits.\nCache stable responses (fundamentals, metadata) to reduce quota burn."
      },
      {
        "title": "Response Validation",
        "body": "Validate both transport and payload success.\nHandle string-encoded numbers safely (float(...)/Decimal as needed).\nKeep parser logic resilient to minor schema/key ordering changes."
      },
      {
        "title": "Data Quality",
        "body": "Preserve source timestamps/time zones from payload metadata.\nDo not infer adjusted/unadjusted semantics; use explicit functions.\nRecord the function and params used for reproducibility/auditability."
      },
      {
        "title": "Public/Commercial Readiness",
        "body": "Review Alpha Vantage terms before public/commercial release:\nhttps://www.alphavantage.co/terms_of_service/\nEnsure your usage tier and traffic profile are aligned with your plan:\nhttps://www.alphavantage.co/premium/\nDo not redistribute restricted content if terms disallow it."
      },
      {
        "title": "Security and Operations",
        "body": "Store API keys in secret managers (or environment variables for local dev only).\nAdd circuit-breaking and queue backpressure for upstream rate spikes.\nInstrument call counts, throttle rate, retry count, and error classes.\nAdd alerting for sustained Note responses and non-2xx response spikes."
      },
      {
        "title": "references/",
        "body": "references/api_docs.md contains endpoint selection guidance and required parameters."
      },
      {
        "title": "scripts/",
        "body": "scripts/alpha_vantage_client.py provides a reusable request wrapper with:\n\nenv-based auth\ntimeout and retry logic\nthrottle/error detection\noptional compact output"
      }
    ],
    "body": "Alpha Vantage\nOverview\n\nThis skill provides a production-ready workflow for Alpha Vantage API usage: selecting the right endpoints, building validated requests, handling throttling/error responses, and preparing safe public/commercial deployment.\n\nQuick Start\nSet API key: export ALPHAVANTAGE_API_KEY=...\nFor endpoint/params, read references/api_docs.md\nFor scriptable calls with retry/backoff, use scripts/alpha_vantage_client.py\nFor public deployment, follow the Deployment Guardrails section before release\nWorkflow\nClassify request type:\nPrice bars or latest price: time series functions\nIndicators (RSI, SMA, MACD, etc.): technical indicator functions\nCompany info, earnings, statements: fundamentals\nFX/Crypto/Commodities/Macro: their dedicated function families\nResolve mandatory parameters from references/api_docs.md.\nBuild request with function=... and apikey=....\nParse response and branch for:\nHTTP error status\nError Message\nNote (usually rate-limit/throttle condition)\nEmpty/partial payload\nIf Note/throttled, retry using exponential backoff with jitter.\nNormalize output to a stable schema before downstream use.\nImplementation Guidelines\nAuthentication\nUse ALPHAVANTAGE_API_KEY environment variable by default.\nNever hardcode keys in source, logs, prompts, or examples.\nMask keys in debug output (show only short prefix/suffix).\nReliability and Rate Limits\nTreat responses containing Note as retriable throttle events.\nUse bounded retries with exponential backoff and jitter.\nFor multi-symbol jobs, queue calls and pace to plan limits.\nCache stable responses (fundamentals, metadata) to reduce quota burn.\nResponse Validation\nValidate both transport and payload success.\nHandle string-encoded numbers safely (float(...)/Decimal as needed).\nKeep parser logic resilient to minor schema/key ordering changes.\nData Quality\nPreserve source timestamps/time zones from payload metadata.\nDo not infer adjusted/unadjusted semantics; use explicit functions.\nRecord the function and params used for reproducibility/auditability.\nDeployment Guardrails\nPublic/Commercial Readiness\nReview Alpha Vantage terms before public/commercial release: https://www.alphavantage.co/terms_of_service/\nEnsure your usage tier and traffic profile are aligned with your plan: https://www.alphavantage.co/premium/\nDo not redistribute restricted content if terms disallow it.\nSecurity and Operations\nStore API keys in secret managers (or environment variables for local dev only).\nAdd circuit-breaking and queue backpressure for upstream rate spikes.\nInstrument call counts, throttle rate, retry count, and error classes.\nAdd alerting for sustained Note responses and non-2xx response spikes.\nResources\nreferences/\nreferences/api_docs.md contains endpoint selection guidance and required parameters.\nscripts/\nscripts/alpha_vantage_client.py provides a reusable request wrapper with:\nenv-based auth\ntimeout and retry logic\nthrottle/error detection\noptional compact output"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/oscraters/alpha-vantage",
    "publisherUrl": "https://clawhub.ai/oscraters/alpha-vantage",
    "owner": "oscraters",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/alpha-vantage",
    "downloadUrl": "https://openagent3.xyz/downloads/alpha-vantage",
    "agentUrl": "https://openagent3.xyz/skills/alpha-vantage/agent",
    "manifestUrl": "https://openagent3.xyz/skills/alpha-vantage/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/alpha-vantage/agent.md"
  }
}