{
  "schemaVersion": "1.0",
  "item": {
    "slug": "blackswan",
    "name": "BlackClaw",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/bilalmotiwala/blackswan",
    "canonicalUrl": "https://clawhub.ai/bilalmotiwala/blackswan",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/blackswan",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=blackswan",
    "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-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/blackswan"
    },
    "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/blackswan",
    "agentPageUrl": "https://openagent3.xyz/skills/blackswan/agent",
    "manifestUrl": "https://openagent3.xyz/skills/blackswan/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/blackswan/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": "BlackSwan Risk Intelligence",
        "body": "BlackSwan monitors crypto markets 24/7 and produces two risk assessments:\n\nFlare — Precursor detection from a 15-minute signal window. Use for immediate, alarm-bell risk checks. Before the news breaks.\nCore — State synthesis from a 60-minute signal window. Use for market context and risk assessment. As the news breaks."
      },
      {
        "title": "When to use each tool",
        "body": "QuestionTool\"Is something happening right now?\"Flare\"What's the overall market risk environment?\"Core\"Should I be worried about sudden moves?\"Flare\"Give me a full risk briefing\"Both (Flare first, then Core)"
      },
      {
        "title": "Base URL",
        "body": "https://mcp.blackswan.wtf"
      },
      {
        "title": "GET /api/flare",
        "body": "Returns the latest Flare precursor detection assessment.\n\ncurl -s https://mcp.blackswan.wtf/api/flare\n\nResponse fields:\n\nFieldDescriptionagentAlways \"flare\"data_ageHuman-readable age of the data (e.g. \"12 minutes ago\")status\"clear\" or \"alert\"severity\"none\", \"low\", \"medium\", \"high\", or \"critical\"checked_atISO 8601 timestamp of the assessmentassessmentNatural language risk assessmentsignalsArray of detected signals, each with type, source, and detail"
      },
      {
        "title": "GET /api/core",
        "body": "Returns the latest Core state synthesis assessment.\n\ncurl -s https://mcp.blackswan.wtf/api/core\n\nResponse fields:\n\nFieldDescriptionagentAlways \"core\"data_ageHuman-readable age of the data (e.g. \"1 hour ago\")timestampISO 8601 timestamp of the assessmentenvironment\"stable\", \"elevated\", \"stressed\", or \"crisis\"assessmentNatural language risk assessmentkey_factorsArray of strings describing the main risk factorssources_usedArray of data source names used in the assessmentdata_freshnessDescription of how fresh the underlying data is"
      },
      {
        "title": "Interpreting severity levels (Flare)",
        "body": "SeverityMeaningnoneNo precursors detected, markets quietlowMinor signals, worth noting but not actionablemediumNotable signals, warrants attentionhighStrong precursors detected, elevated risk of sudden movescriticalExtreme signals, immediate risk of major market event"
      },
      {
        "title": "Interpreting environment levels (Core)",
        "body": "EnvironmentMeaningstableNormal market conditions, low systemic riskelevatedAbove-normal risk, some stress indicators presentstressedSignificant stress across multiple indicatorscrisisSevere market stress, active dislocation or contagion"
      },
      {
        "title": "Error handling",
        "body": "HTTP StatusMeaning200Success, response contains full assessment502Agent output failed validation — format may have changed503No recent agent runs — system may be starting up500Unexpected server error\n\nOn non-200 responses, the body is {\"error\": \"...\"} with a human-readable message."
      },
      {
        "title": "Complete risk check pattern",
        "body": "To get a full picture, call both endpoints:\n\ncurl -s https://mcp.blackswan.wtf/api/flare\ncurl -s https://mcp.blackswan.wtf/api/core\n\nPresent Flare results first (immediate risks), then Core (broader context)."
      }
    ],
    "body": "BlackSwan Risk Intelligence\n\nBlackSwan monitors crypto markets 24/7 and produces two risk assessments:\n\nFlare — Precursor detection from a 15-minute signal window. Use for immediate, alarm-bell risk checks. Before the news breaks.\nCore — State synthesis from a 60-minute signal window. Use for market context and risk assessment. As the news breaks.\nWhen to use each tool\nQuestion\tTool\n\"Is something happening right now?\"\tFlare\n\"What's the overall market risk environment?\"\tCore\n\"Should I be worried about sudden moves?\"\tFlare\n\"Give me a full risk briefing\"\tBoth (Flare first, then Core)\nBase URL\nhttps://mcp.blackswan.wtf\n\nEndpoints\nGET /api/flare\n\nReturns the latest Flare precursor detection assessment.\n\ncurl -s https://mcp.blackswan.wtf/api/flare\n\n\nResponse fields:\n\nField\tDescription\nagent\tAlways \"flare\"\ndata_age\tHuman-readable age of the data (e.g. \"12 minutes ago\")\nstatus\t\"clear\" or \"alert\"\nseverity\t\"none\", \"low\", \"medium\", \"high\", or \"critical\"\nchecked_at\tISO 8601 timestamp of the assessment\nassessment\tNatural language risk assessment\nsignals\tArray of detected signals, each with type, source, and detail\nGET /api/core\n\nReturns the latest Core state synthesis assessment.\n\ncurl -s https://mcp.blackswan.wtf/api/core\n\n\nResponse fields:\n\nField\tDescription\nagent\tAlways \"core\"\ndata_age\tHuman-readable age of the data (e.g. \"1 hour ago\")\ntimestamp\tISO 8601 timestamp of the assessment\nenvironment\t\"stable\", \"elevated\", \"stressed\", or \"crisis\"\nassessment\tNatural language risk assessment\nkey_factors\tArray of strings describing the main risk factors\nsources_used\tArray of data source names used in the assessment\ndata_freshness\tDescription of how fresh the underlying data is\nInterpreting severity levels (Flare)\nSeverity\tMeaning\nnone\tNo precursors detected, markets quiet\nlow\tMinor signals, worth noting but not actionable\nmedium\tNotable signals, warrants attention\nhigh\tStrong precursors detected, elevated risk of sudden moves\ncritical\tExtreme signals, immediate risk of major market event\nInterpreting environment levels (Core)\nEnvironment\tMeaning\nstable\tNormal market conditions, low systemic risk\nelevated\tAbove-normal risk, some stress indicators present\nstressed\tSignificant stress across multiple indicators\ncrisis\tSevere market stress, active dislocation or contagion\nError handling\nHTTP Status\tMeaning\n200\tSuccess, response contains full assessment\n502\tAgent output failed validation — format may have changed\n503\tNo recent agent runs — system may be starting up\n500\tUnexpected server error\n\nOn non-200 responses, the body is {\"error\": \"...\"} with a human-readable message.\n\nComplete risk check pattern\n\nTo get a full picture, call both endpoints:\n\ncurl -s https://mcp.blackswan.wtf/api/flare\ncurl -s https://mcp.blackswan.wtf/api/core\n\n\nPresent Flare results first (immediate risks), then Core (broader context)."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/bilalmotiwala/blackswan",
    "publisherUrl": "https://clawhub.ai/bilalmotiwala/blackswan",
    "owner": "bilalmotiwala",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/blackswan",
    "downloadUrl": "https://openagent3.xyz/downloads/blackswan",
    "agentUrl": "https://openagent3.xyz/skills/blackswan/agent",
    "manifestUrl": "https://openagent3.xyz/skills/blackswan/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/blackswan/agent.md"
  }
}