{
  "schemaVersion": "1.0",
  "item": {
    "slug": "cricket-live",
    "name": "Cricket Live",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/harshilmathur/cricket-live",
    "canonicalUrl": "https://clawhub.ai/harshilmathur/cricket-live",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/cricket-live",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cricket-live",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "config/README.md",
      "config/cricket.yaml",
      "config/teams.yaml",
      "scripts/cricket-alert.sh",
      "scripts/helpers.sh"
    ],
    "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/cricket-live"
    },
    "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/cricket-live",
    "agentPageUrl": "https://openagent3.xyz/skills/cricket-live/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cricket-live/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cricket-live/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": "🏏 Cricket Live",
        "body": "Live cricket scores, IPL tracking, and match alerts for OpenClaw.\n\nGet real-time scores, upcoming schedules, detailed scorecards, and IPL standings — all from your OpenClaw agent. Powered by CricketData.org API (endpoint: api.cricapi.com)."
      },
      {
        "title": "✨ Features",
        "body": "🔴 Live Scores — All currently live matches with real-time scores, overs, and status\n📋 Match Details — Full scorecards with batting and bowling stats\n📅 Upcoming Matches — Next 7 days of scheduled matches, filterable by team\n✅ Recent Results — Completed matches from the last 3 days\n🏆 IPL Hub — Standings, upcoming IPL matches, live scores, and results\n🔍 Match Search — Find any match by team name (supports aliases like \"MI\", \"CSK\", \"AUS\")\n🔔 Alerts — Cron-ready script for wicket, century, and result notifications\n💾 Smart Caching — Respects API quota with configurable TTL per endpoint\n🇮🇳 IST by Default — All times displayed in Indian Standard Time"
      },
      {
        "title": "1. Get a Free API Key",
        "body": "Sign up at cricketdata.org — the free tier gives you 100 API calls/day. (CricketData.org's API is served at api.cricapi.com — they are the same service.)"
      },
      {
        "title": "2. Set the Environment Variable",
        "body": "export CRICKET_API_KEY=\"your-api-key-here\"\n# Add to your shell profile or ~/.openclaw/.env for persistence"
      },
      {
        "title": "3. Run Any Script",
        "body": "bash scripts/live-scores.sh              # What's happening right now?\nbash scripts/upcoming-matches.sh         # What's coming up?\nbash scripts/ipl.sh standings            # IPL points table"
      },
      {
        "title": "Live Scores",
        "body": "bash scripts/live-scores.sh\n\nShows all currently live matches with scores, overs, and match status.\n\nExample output:\n\n🏏 LIVE CRICKET SCORES\n━━━━━━━━━━━━━━━━━━━━━\n\n🔴 India vs England — 3rd Test, Day 2\n🇮🇳 India: 285/6 (78.2 ov)\n🏴 England: 312 (98.4 ov)\n📊 India trail by 27 runs\n\n🔴 Australia vs South Africa — 1st ODI\n🇦🇺 Australia: 156/3 (28.1 ov)\n📊 In Progress"
      },
      {
        "title": "Upcoming Matches",
        "body": "bash scripts/upcoming-matches.sh              # All upcoming\nbash scripts/upcoming-matches.sh --team India  # Filter by team\nbash scripts/upcoming-matches.sh MI            # Works with aliases\n\nExample output:\n\n📅 UPCOMING MATCHES (Next 7 Days)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n🇮🇳 India vs England — 4th Test\n📍 Ranchi\n🕐 16 Feb 2026, 09:30 AM IST\n\n🏏 Mumbai Indians vs Chennai Super Kings — IPL 2026\n📍 Wankhede Stadium, Mumbai\n🕐 18 Feb 2026, 07:30 PM IST"
      },
      {
        "title": "Recent Results",
        "body": "bash scripts/recent-results.sh\n\nExample output:\n\n✅ RECENT RESULTS\n━━━━━━━━━━━━━━━━━\n\n🏆 India won by 5 wickets\nIndia vs England — 2nd Test\n📍 Visakhapatnam\n\n🏆 Australia won by 73 runs\nAustralia vs Sri Lanka — 3rd ODI\n📍 Melbourne"
      },
      {
        "title": "IPL Hub",
        "body": "bash scripts/ipl.sh standings   # Points table\nbash scripts/ipl.sh upcoming    # Upcoming IPL matches\nbash scripts/ipl.sh live        # Live IPL scores\nbash scripts/ipl.sh results     # Recent IPL results"
      },
      {
        "title": "Match Details (Scorecard)",
        "body": "bash scripts/match-details.sh <match-id>\n\nGet match IDs from live-scores or search results."
      },
      {
        "title": "Search Matches",
        "body": "bash scripts/search-match.sh \"India vs Australia\"\nbash scripts/search-match.sh \"MI vs CSK\""
      },
      {
        "title": "Cricket Alerts (Cron)",
        "body": "bash scripts/cricket-alert.sh\n\nDetects wickets, centuries, and match completions since last check. Outputs only when something notable happens — perfect for cron."
      },
      {
        "title": "🗣️ Natural Language Mapping",
        "body": "User saysScript\"What's the score?\" / \"Live scores\"live-scores.sh\"Show me the scorecard for match X\"match-details.sh <id>\"Upcoming matches\" / \"What's coming up?\"upcoming-matches.sh\"Recent results\" / \"Who won?\"recent-results.sh\"IPL table\" / \"IPL standings\"ipl.sh standings\"IPL matches today\"ipl.sh live\"India vs Australia\"search-match.sh \"India vs Australia\""
      },
      {
        "title": "config/cricket.yaml",
        "body": "Main configuration file. API key can be set here or via CRICKET_API_KEY env var (env var takes priority).\n\napi_key: \"\"                    # Set via env var recommended\nfavorite_teams:                # Teams for alert filtering\n  - India\n  - Mumbai Indians\nalert_events:                  # Events that trigger alerts\n  - wicket\n  - century\n  - match_end\ncache_dir: /tmp/cricket-cache  # Cache directory\ncache_ttl:                     # Cache TTL in seconds per endpoint\n  live: 120\n  upcoming: 1800\n  results: 1800\n  series: 86400\n  scorecard: 300"
      },
      {
        "title": "config/teams.yaml",
        "body": "Team name aliases for fuzzy matching. Maps shorthand names (MI, CSK, IND, AUS) to canonical API names. See config/README.md for details."
      },
      {
        "title": "⏰ Cron Integration",
        "body": "Set up periodic match alerts:\n\n# Check for notable events every 5 minutes during match hours\n*/5 9-23 * * * CRICKET_API_KEY=\"your-key\" bash /path/to/skills/cricket-scores/scripts/cricket-alert.sh\n\n# Or use OpenClaw cron:\n# Schedule cricket-alert.sh to run during IPL match times (7-11 PM IST)\n\nThe alert script tracks state in /tmp/cricket-alert-state.json and only outputs when something new happens (wicket, century, match result)."
      },
      {
        "title": "📊 API Quota Management",
        "body": "TierCalls/DayCostFree100$0Pro2,000$5.99/mo"
      },
      {
        "title": "How Caching Helps",
        "body": "All scripts cache API responses locally in /tmp/cricket-cache/:\n\nLive scores: 2 min TTL (fresh during matches)\nUpcoming/Results: 30 min TTL\nSeries info: 24 hour TTL\nScorecards: 5 min TTL"
      },
      {
        "title": "Budget During a Match Day",
        "body": "~10 list calls + ~50 score checks + 40 ad-hoc = 100 calls (fits free tier)"
      },
      {
        "title": "When Quota is Exhausted",
        "body": "Scripts show a clear message: \"API quota exhausted (100 calls/day limit reached). Try again tomorrow or upgrade.\""
      },
      {
        "title": "📂 Output Format",
        "body": "All output is messaging-friendly:\n\nNo markdown tables (works on WhatsApp, Discord, Telegram)\nBullet point lists with emoji\nTimes converted to IST\nMatch IDs included for drill-down"
      },
      {
        "title": "📋 Requirements",
        "body": "bash 4.0+\ncurl (usually pre-installed)\njq — apt install jq or brew install jq\nCricketData.org API key (free) — sign up at cricketdata.org"
      },
      {
        "title": "🔒 Security Notes",
        "body": "API key in URL query parameter: The CricketData.org API (api.cricapi.com) requires the API key to be passed as a URL query parameter (?apikey=...). This means the key may appear in shell history, process listings, server access logs, and any HTTP proxy/inspection logs. Mitigations:\n\nSet the key via the CRICKET_API_KEY environment variable (not hardcoded in config files).\nUse the free tier key for this skill — it has limited scope and can be rotated easily.\nAvoid running scripts in shared/multi-tenant environments where process arguments are visible to other users.\nThe CricketData.org API does not support header-based authentication, so query-param passing is unavoidable."
      },
      {
        "title": "📄 License",
        "body": "MIT — see LICENSE"
      }
    ],
    "body": "🏏 Cricket Live\n\nLive cricket scores, IPL tracking, and match alerts for OpenClaw.\n\nGet real-time scores, upcoming schedules, detailed scorecards, and IPL standings — all from your OpenClaw agent. Powered by CricketData.org API (endpoint: api.cricapi.com).\n\n✨ Features\n🔴 Live Scores — All currently live matches with real-time scores, overs, and status\n📋 Match Details — Full scorecards with batting and bowling stats\n📅 Upcoming Matches — Next 7 days of scheduled matches, filterable by team\n✅ Recent Results — Completed matches from the last 3 days\n🏆 IPL Hub — Standings, upcoming IPL matches, live scores, and results\n🔍 Match Search — Find any match by team name (supports aliases like \"MI\", \"CSK\", \"AUS\")\n🔔 Alerts — Cron-ready script for wicket, century, and result notifications\n💾 Smart Caching — Respects API quota with configurable TTL per endpoint\n🇮🇳 IST by Default — All times displayed in Indian Standard Time\n🚀 Quick Start\n1. Get a Free API Key\n\nSign up at cricketdata.org — the free tier gives you 100 API calls/day. (CricketData.org's API is served at api.cricapi.com — they are the same service.)\n\n2. Set the Environment Variable\nexport CRICKET_API_KEY=\"your-api-key-here\"\n# Add to your shell profile or ~/.openclaw/.env for persistence\n\n3. Run Any Script\nbash scripts/live-scores.sh              # What's happening right now?\nbash scripts/upcoming-matches.sh         # What's coming up?\nbash scripts/ipl.sh standings            # IPL points table\n\n📖 Usage\nLive Scores\nbash scripts/live-scores.sh\n\n\nShows all currently live matches with scores, overs, and match status.\n\nExample output:\n\n🏏 LIVE CRICKET SCORES\n━━━━━━━━━━━━━━━━━━━━━\n\n🔴 India vs England — 3rd Test, Day 2\n🇮🇳 India: 285/6 (78.2 ov)\n🏴 England: 312 (98.4 ov)\n📊 India trail by 27 runs\n\n🔴 Australia vs South Africa — 1st ODI\n🇦🇺 Australia: 156/3 (28.1 ov)\n📊 In Progress\n\nUpcoming Matches\nbash scripts/upcoming-matches.sh              # All upcoming\nbash scripts/upcoming-matches.sh --team India  # Filter by team\nbash scripts/upcoming-matches.sh MI            # Works with aliases\n\n\nExample output:\n\n📅 UPCOMING MATCHES (Next 7 Days)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n🇮🇳 India vs England — 4th Test\n📍 Ranchi\n🕐 16 Feb 2026, 09:30 AM IST\n\n🏏 Mumbai Indians vs Chennai Super Kings — IPL 2026\n📍 Wankhede Stadium, Mumbai\n🕐 18 Feb 2026, 07:30 PM IST\n\nRecent Results\nbash scripts/recent-results.sh\n\n\nExample output:\n\n✅ RECENT RESULTS\n━━━━━━━━━━━━━━━━━\n\n🏆 India won by 5 wickets\nIndia vs England — 2nd Test\n📍 Visakhapatnam\n\n🏆 Australia won by 73 runs\nAustralia vs Sri Lanka — 3rd ODI\n📍 Melbourne\n\nIPL Hub\nbash scripts/ipl.sh standings   # Points table\nbash scripts/ipl.sh upcoming    # Upcoming IPL matches\nbash scripts/ipl.sh live        # Live IPL scores\nbash scripts/ipl.sh results     # Recent IPL results\n\nMatch Details (Scorecard)\nbash scripts/match-details.sh <match-id>\n\n\nGet match IDs from live-scores or search results.\n\nSearch Matches\nbash scripts/search-match.sh \"India vs Australia\"\nbash scripts/search-match.sh \"MI vs CSK\"\n\nCricket Alerts (Cron)\nbash scripts/cricket-alert.sh\n\n\nDetects wickets, centuries, and match completions since last check. Outputs only when something notable happens — perfect for cron.\n\n🗣️ Natural Language Mapping\nUser says\tScript\n\"What's the score?\" / \"Live scores\"\tlive-scores.sh\n\"Show me the scorecard for match X\"\tmatch-details.sh <id>\n\"Upcoming matches\" / \"What's coming up?\"\tupcoming-matches.sh\n\"Recent results\" / \"Who won?\"\trecent-results.sh\n\"IPL table\" / \"IPL standings\"\tipl.sh standings\n\"IPL matches today\"\tipl.sh live\n\"India vs Australia\"\tsearch-match.sh \"India vs Australia\"\n⚙️ Configuration\nconfig/cricket.yaml\n\nMain configuration file. API key can be set here or via CRICKET_API_KEY env var (env var takes priority).\n\napi_key: \"\"                    # Set via env var recommended\nfavorite_teams:                # Teams for alert filtering\n  - India\n  - Mumbai Indians\nalert_events:                  # Events that trigger alerts\n  - wicket\n  - century\n  - match_end\ncache_dir: /tmp/cricket-cache  # Cache directory\ncache_ttl:                     # Cache TTL in seconds per endpoint\n  live: 120\n  upcoming: 1800\n  results: 1800\n  series: 86400\n  scorecard: 300\n\nconfig/teams.yaml\n\nTeam name aliases for fuzzy matching. Maps shorthand names (MI, CSK, IND, AUS) to canonical API names. See config/README.md for details.\n\n⏰ Cron Integration\n\nSet up periodic match alerts:\n\n# Check for notable events every 5 minutes during match hours\n*/5 9-23 * * * CRICKET_API_KEY=\"your-key\" bash /path/to/skills/cricket-scores/scripts/cricket-alert.sh\n\n# Or use OpenClaw cron:\n# Schedule cricket-alert.sh to run during IPL match times (7-11 PM IST)\n\n\nThe alert script tracks state in /tmp/cricket-alert-state.json and only outputs when something new happens (wicket, century, match result).\n\n📊 API Quota Management\nTier\tCalls/Day\tCost\nFree\t100\t$0\nPro\t2,000\t$5.99/mo\nHow Caching Helps\n\nAll scripts cache API responses locally in /tmp/cricket-cache/:\n\nLive scores: 2 min TTL (fresh during matches)\nUpcoming/Results: 30 min TTL\nSeries info: 24 hour TTL\nScorecards: 5 min TTL\nBudget During a Match Day\n\n~10 list calls + ~50 score checks + 40 ad-hoc = 100 calls (fits free tier)\n\nWhen Quota is Exhausted\n\nScripts show a clear message: \"API quota exhausted (100 calls/day limit reached). Try again tomorrow or upgrade.\"\n\n📂 Output Format\n\nAll output is messaging-friendly:\n\nNo markdown tables (works on WhatsApp, Discord, Telegram)\nBullet point lists with emoji\nTimes converted to IST\nMatch IDs included for drill-down\n📋 Requirements\nbash 4.0+\ncurl (usually pre-installed)\njq — apt install jq or brew install jq\nCricketData.org API key (free) — sign up at cricketdata.org\n🔒 Security Notes\nAPI key in URL query parameter: The CricketData.org API (api.cricapi.com) requires the API key to be passed as a URL query parameter (?apikey=...). This means the key may appear in shell history, process listings, server access logs, and any HTTP proxy/inspection logs. Mitigations:\nSet the key via the CRICKET_API_KEY environment variable (not hardcoded in config files).\nUse the free tier key for this skill — it has limited scope and can be rotated easily.\nAvoid running scripts in shared/multi-tenant environments where process arguments are visible to other users.\nThe CricketData.org API does not support header-based authentication, so query-param passing is unavoidable.\n📄 License\n\nMIT — see LICENSE"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/harshilmathur/cricket-live",
    "publisherUrl": "https://clawhub.ai/harshilmathur/cricket-live",
    "owner": "harshilmathur",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/cricket-live",
    "downloadUrl": "https://openagent3.xyz/downloads/cricket-live",
    "agentUrl": "https://openagent3.xyz/skills/cricket-live/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cricket-live/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cricket-live/agent.md"
  }
}