← Back to Skills Marketplace
stigg86

Betting Research

by stigg86 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
105
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install betting-research
Description
Multi-source sports betting research tool. Aggregates odds, team form, head-to-head history, weather conditions, and injury data to identify value betting op...
README (SKILL.md)

Betting Research

Multi-source data aggregator for sports betting analysis. Pulls from free and paid APIs to give you an edge.

Data Sources

Source Data Cost Rate Limit
TheSportsDB Fixtures, results, H2H, team info Free No limit
API-Football Lineups, injuries, player stats, xG 100 calls/day free 100/day
Open-Meteo Weather (precipitation, wind) Free No limit
The Odds API Current odds, bookmaker prices 500 calls/month free 500/mo

Quick Start

# Research a specific match
python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py "Liverpool vs Everton"

# Research a team
python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py --team "Bolton Wanderers"

What You Get

Basic Analysis (Free APIs)

  • ✅ Team form (last 5 matches)
  • ✅ Win/draw/loss record
  • ✅ Goals scored/conceded
  • ✅ Upcoming fixtures
  • ✅ Head-to-head history
  • ✅ Weather conditions

Pro Analysis (with API-Football key)

  • ⭐ Confirmed lineups (1 hour before kickoff)
  • ⭐ Injury/suspension reports
  • ⭐ Expected goals (xG) data
  • ⭐ Player form and ratings
  • ⭐ Manager tactics info

Setup

The Odds API (already have)

Key stored at: ~/.config/the-odds-api/key

API-Football (optional, for pro features)

  1. Sign up: https://www.api-football.com/pricing
  2. Get free tier: 100 calls/day
  3. Save key:
mkdir -p ~/.config/api-football
echo '{"api_key": "YOUR_KEY"}' > ~/.config/api-football/config.json

Usage Examples

Pre-match research:

python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py "Bolton vs Plymouth"

Full analysis (uses more API calls):

python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py "Liverpool vs Man City" --full

Check multiple games efficiently:

# Uses only 3-4 API calls per match
# 100 calls = ~25 matches per day

Interpreting Results

Value Indicators

  • Form streaks — teams on hot/cold runs
  • H2H dominance — historical advantage
  • Weather impact — rain = lower scoring
  • Odds mispricing — bookie odds vs. true probability

What NOT to Expect

  • ❌ Guaranteed winners
  • ❌ "Bet on this" tips
  • ❌ Inside information

What TO Expect

  • ✅ Data patterns
  • ✅ Value opportunities
  • ✅ Informed decisions

Pro Tips

  1. Check lineups 1 hour before kickoff — key players resting = different bet
  2. Weather matters — rain, wind affect totals (under value)
  3. H2H at this venue — home advantage varies by team
  4. Motivation check — cup games, relegation battles

API Call Budgeting

Task Calls
Basic match research 3-4
Full analysis + lineups 8-10
Team form check 2-3
Odds comparison 1

100 calls/day = 10-15 full match analyses

See references/data-sources.md for API details.

Usage Guidance
This skill appears to implement what it claims (aggregating sports APIs), but take these precautions before running or installing: 1) Review the included scripts yourself — the Python code will try to execute a Node script at ~/.openclaw/workspace/skills/search-x/scripts/search.js if present. That means it can run code from other skills/workspace entries; verify that search-x (and any Node code) is trustworthy or remove/disable those calls. 2) The skill expects API keys in ~/.config or as env vars (APIFOOTBALL_KEY, ODDS_API_KEY); keep secrets in a safe place and avoid world-readable files. 3) If you don't want cross-skill execution, either ensure 'search-x' isn't installed or edit the Python script to remove the subprocess/node calls. 4) Ensure you have (or intentionally install) node if you want the X/Twitter lookups to work; the skill doesn't declare node as a required binary. If you want me to, I can summarize exactly where the script executes external binaries and produce a patch to disable those calls.
Capability Analysis
Type: OpenClaw Skill Name: betting-research Version: 1.0.0 The 'betting-research' skill is a legitimate tool for aggregating sports data from various APIs (TheSportsDB, Open-Meteo, and The Odds API). The Python script (scripts/betting_research.py) correctly handles API keys via local configuration files in ~/.config/ and includes logic for form analysis, fatigue calculation, and motivation indexing. While it uses subprocess.run to interact with an optional 'search-x' skill, it does so safely without shell=True, and no evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The skill's stated purpose (betting research) aligns with the included Python script and referenced APIs. However metadata claims no required binaries or env vars while the script reads APIFOOTBALL_KEY / ODDS_API_KEY environment variables (as fallbacks) and expects config files under ~/.config. More importantly, the script attempts to run a Node-based helper at ~/.openclaw/workspace/skills/search-x/scripts/search.js, but the skill does not declare a dependency on that other skill or on the 'node' binary. Requiring execution of another skill's script without declaring it is an incoherence.
Instruction Scope
SKILL.md instructions are generally limited to running the included Python script and storing API keys in ~/.config paths — those are appropriate. The runtime code however will attempt to execute a local Node script from a different skill path (~/.openclaw/.../search-x/scripts/search.js) via subprocess.run to fetch X/Twitter results; this expands the execution scope to run potentially arbitrary code from the workspace and is not documented as a dependency in SKILL.md. The script also reads files in ~/.config and the workspace, which SKILL.md partially documents for API keys but not for cross-skill execution.
Install Mechanism
No install spec is provided (instruction-only with an included script). Nothing is downloaded or extracted by the skill itself, which lowers installation risk.
Credentials
The skill asks for API keys for API-Football and The Odds API — these are proportional to its functionality. It suggests storing them in ~/.config/api-football/config.json and ~/.config/the-odds-api/key, and the script will also accept APIFOOTBALL_KEY and ODDS_API_KEY environment variables. The metadata declared no required env vars which is arguably misleading but not dangerous. No unrelated credentials are requested.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent privileges. It does not modify other skills' configs; it only reads files from the user's home directory and workspace when run.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install betting-research
  3. After installation, invoke the skill by name or use /betting-research
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Multi-source sports betting research tool. Aggregates form, H2H, weather, odds, fatigue, motivation, and X/Twitter intel to identify value betting opportunities.
Metadata
Slug betting-research
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Betting Research?

Multi-source sports betting research tool. Aggregates odds, team form, head-to-head history, weather conditions, and injury data to identify value betting op... It is an AI Agent Skill for Claude Code / OpenClaw, with 105 downloads so far.

How do I install Betting Research?

Run "/install betting-research" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Betting Research free?

Yes, Betting Research is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Betting Research support?

Betting Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Betting Research?

It is built and maintained by stigg86 (@stigg86); the current version is v1.0.0.

💬 Comments