← Back to Skills Marketplace
ichendong

CPBL

by ichendong · GitHub ↗ · v1.4.3 · MIT-0
cross-platform ✓ Security Clean
304
Downloads
0
Stars
0
Active Installs
13
Versions
Install in OpenClaw
/install cpbl
Description
Query CPBL 中華職棒 scores schedules live games standings player stats news and Taiwan baseball history for Taiwan users Use when the user asks about CPBL 戰績 賽程...
README (SKILL.md)

CPBL

Use the bundled scripts for official-site data first. Use web_search for recent news. Use web_fetch on 台灣棒球維基館 for awards history or facts the official site does not expose.

Primary workflow

  1. Pick the narrowest script that matches the request.
  2. Prefer text output for user-facing answers and JSON output for chaining or debugging.
  3. If the official source cannot provide the requested historical fact, fetch 台灣棒球維基館.
  4. If a result looks empty or partial, check references/api-endpoints.md before assuming the data does not exist.

Script map

  • scripts/cpbl_live.py 即時比分 今日賽況 指定日期賽況
  • scripts/cpbl_games.py 已完賽結果 歷史比賽
  • scripts/cpbl_schedule.py 賽程
  • scripts/cpbl_standings.py 戰績 排名
  • scripts/cpbl_stats.py 球員與排行榜數據

Common commands

uv run skills/cpbl/scripts/cpbl_live.py --output text
uv run skills/cpbl/scripts/cpbl_live.py --date 2026-04-01 --team 兄弟
uv run skills/cpbl/scripts/cpbl_games.py --year 2025 --limit 10
uv run skills/cpbl/scripts/cpbl_schedule.py --month 2026-04 --all
uv run skills/cpbl/scripts/cpbl_standings.py
uv run skills/cpbl/scripts/cpbl_stats.py --year 2025 --category batting --top 10

Game type codes

  • A 一軍例行賽 預設
  • B 一軍明星賽
  • C 一軍總冠軍賽
  • D 二軍例行賽
  • E 一軍季後挑戰賽
  • F 二軍總冠軍賽
  • G 一軍熱身賽
  • H 未來之星邀請賽
  • X 國際交流賽

Live score notes

  • Live data is polled from the official source and is not push-based.
  • API data may lag by a few minutes.
  • When PresentStatus shows "比賽中" but /box/getlive returns GameStatus=3, the script corrects the status to "已結束" automatically.
  • Finished games now include detailed Box Score: pitcher lines (IP/H/ER/K/BB/HR/H/SV/speed) and key batter lines (AB/H/RBI/HR/R/SB).
  • Game duration is displayed in Xh Xm format (e.g. 3h23m).
  • Monday often has no games unless adjusted by holidays or makeup scheduling.

Schedule cache

If a request is about schedule, check memory/cpbl_schedule_YYYY.md first. Refresh the cache when the file is missing, stale, or the requested range extends beyond the cached range.

Recommended refresh command

uv run skills/cpbl/scripts/cpbl_schedule.py --month YYYY-MM --all

Postponement info

To check today's postponement announcements, fetch the official news page:

https://cpbl.com.tw/news

Look for the latest "延賽公告" entry. The live script now auto-detects postponed games (0:0 + no winning/losing pitcher).

History and awards

Use 台灣棒球維基館 for MVP 新人王 歷史紀錄 球員生涯資料 or older facts that the official site does not return. Search URL format

https://twbsball.dils.tku.edu.tw/wiki/index.php?title=關鍵字

Common pages

  • 中華職棒年度最有價值球員
  • 中華職棒年度新人王
  • 球員姓名

References

Read these only when needed

  • references/api-endpoints.md official-site endpoint behavior and quirks
  • references/summary.md project background and current limitations
  • references/test-report.md prior investigation details

Known limits

  • Some official endpoints return HTML fragments instead of JSON.
  • Some standings and schedule flows are brittle because the site relies on AJAX plus CSRF.
  • If a script returns partial data, do not invent missing values. State the limit and fall back to another source when possible.
Usage Guidance
This skill is coherent with its stated purpose: it includes Python scripts that query CPBL site endpoints and (as a fallback) a Taiwan baseball wiki. Before installing, consider: 1) the scripts will make outbound HTTPS requests to cpbl.com.tw and the wiki (required for functionality); 2) they cache a CSRF token in the system temp directory (non-sensitive, but persistent until cleared); 3) running dynamic fetches may require installing scrapling and a headless browser/runtime; 4) the code targets undocumented/hidden endpoints so results can be brittle if the site changes. If you’re in a restrictive or high-security environment, review the bundled code and limit network access or run it in an isolated environment. If you want, I can point out specific lines that write the cache or where network calls are made.
Capability Analysis
Type: OpenClaw Skill Name: cpbl Version: 1.4.3 The skill bundle is a well-documented and functional tool for querying Chinese Professional Baseball League (CPBL) data. The Python scripts (e.g., `scripts/cpbl_live.py`, `scripts/cpbl_stats.py`) interact with official hidden AJAX endpoints on cpbl.com.tw using standard libraries like urllib and BeautifulSoup. The core logic in `scripts/_cpbl_api.py` handles CSRF tokens and implements TTL caching to optimize performance. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the instructions in `SKILL.md` are strictly aligned with the stated purpose of sports data retrieval.
Capability Assessment
✓ Purpose & Capability
Name/description (CPBL scores, schedules, live games, stats, history) match the included Python scripts which call CPBL site endpoints and the Taiwan baseball wiki. No unrelated credentials, binaries, or services are requested.
ℹ Instruction Scope
SKILL.md tells the agent to run the bundled scripts, use web_search for news, and web_fetch the Taiwan baseball wiki for historical facts — that aligns with the code. Scripts perform HTTP(S) calls to cpbl.com.tw and to the wiki, and read/write a CSRF token cache in the system temp directory; this is within scope but worth noting because the skill will perform network requests and persist a small token file.
ℹ Install Mechanism
No install spec is provided (instruction-only in registry), but the bundle contains runnable Python scripts with dependency comments (scrapling[ai]) and shebangs. There are no downloads from untrusted URLs or archive extracts in the package. Expect that running the scripts may require installing Python >=3.11 and the scrapling package and possibly a headless browser for dynamic fetches.
✓ Credentials
The skill requests no environment variables, no credentials, and doesn't access unrelated config paths. It writes a CSRF token cache to the system temp directory (temporary, single-purpose). Network access to cpbl.com.tw and the Taiwan baseball wiki is required and justified by the stated purpose.
✓ Persistence & Privilege
always:false and no special privileges requested. The only persistent artifact is a token cache file in the system temp directory for efficiency; the skill does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cpbl
  3. After installation, invoke the skill by name or use /cpbl
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.3
v1.4.3: Box Score detail, status fix, duration format, holds/saves, PR#3 merge
v1.4.2
修復 standings 排名解析 二軍代碼改為 D 修正 token bytes/str 相容性 更新 SKILL.md 路徑範例 並清理過期文件描述
v1.4.1
移除所有 lxml 依賴（可疑二進位），移除 __pycache__ 殘留，新增 .gitignore
v1.4.0
即時局數顯示 (第N局上/下半)、延賽自動偵測、API延遲修正、移除cpbl_news.py
v1.3.2
v1.3.2 移除與 CPBL 無關的 scripts/ralph 自治開發框架 清掉 Autonomous Coder 痕跡 降低 suspicious 審查風險 不影響既有 CPBL 查詢功能
v1.3.1
Add live scores support and enrich post-game results with home runs holds saves attendance plus docs updates
v1.3.0
Add live score support via cpbl_live.py and refresh docs
v1.2.1
Fix shared module refactor bugs and CLI validation. Uses cross-platform temp token cache, adds strict date/month validation, improves cpbl_stats team filtering, and fixes unknown-team regression.
v1.2.0
去重共用常數到_cpbl_api、post_api_html新增、bare except修復、stats解析重構
v1.0.2
v1.0.2: add 台灣棒球維基館 as secondary data source for awards, MVP, and historical records
v1.0.1
v1.0.1: Initial ClawHub release
v1.0.0
Initial release
v5.0.0
CPBL Skill 5.0.0 – Major update for CPBL (Chinese Professional Baseball League) data querying. - Unified querying for all game types (regular season, preseason, playoffs, etc.) with comprehensive team filters. - Python scripts to retrieve game results, upcoming schedules, player stats, and (stub) news. - Switch to hidden official CPBL API with CSRF token authentication (auto-handled). - Dependencies now auto-install via `uv` and inline metadata. - Official API limitation: standings data not currently available via endpoint. - Known anti-scraping and token-caching behaviors documented.
Metadata
Slug cpbl
Version 1.4.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 13
Frequently Asked Questions

What is CPBL?

Query CPBL 中華職棒 scores schedules live games standings player stats news and Taiwan baseball history for Taiwan users Use when the user asks about CPBL 戰績 賽程... It is an AI Agent Skill for Claude Code / OpenClaw, with 304 downloads so far.

How do I install CPBL?

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

Is CPBL free?

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

Which platforms does CPBL support?

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

Who created CPBL?

It is built and maintained by ichendong (@ichendong); the current version is v1.4.3.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments