← Back to Skills Marketplace
yszheda

Skill Openclaw Library Monitor

by Shuai YUAN · GitHub ↗ · v1.0.1
cross-platform ✓ Security Clean
329
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install library-book-monitor
Description
Monitor library book availability and get notified when books become available for borrowing. Supports Shenzhen Library and extensible for other libraries.
README (SKILL.md)

Library Book Monitor Skill

A skill to monitor library book availability and get notified when books become available for borrowing.

When to Use

Use this skill when you want to:

  • Track book availability at Shenzhen Library
  • Get notified when a book becomes available for borrowing
  • Monitor multiple books and their availability status
  • Automate library book availability checking

Setup

Before using this skill, ensure:

  1. Python 3.8+ is installed
  2. Dependencies are installed: pip install -r requirements.txt
  3. Configuration file config.yaml is set up (copy from config.yaml.example)

Commands

Add a Book

Add book "Python Programming" by "Guido van Rossum" with monitoring enabled

List All Books

List all monitored books

Check Book Availability

Check availability of all books

Remove a Book

Remove book with ID abc123

Toggle Monitoring

Toggle monitoring for book abc123

Start Scheduled Monitoring

Start monitoring scheduler

Configuration

The skill uses config.yaml for settings:

library:
  name: "Shenzhen Library"
  base_url: "https://www.szlib.org.cn/"
  search_url: "https://www.szlib.org.cn/opac/"
  timeout: 30

scheduler:
  enabled: true
  interval_minutes: 30
  retry_on_failure: true
  max_retries: 3

notification:
  enabled: true
  methods:
    - console
    - email
  email:
    smtp_server: smtp.qq.com
    smtp_port: 587
    sender: [email protected]
    password: your_smtp_password
    recipients:
      - [email protected]

Notes

  • The skill supports Shenzhen Library by default
  • Other libraries can be added by implementing custom scrapers
  • Book data is stored in book_list.json
  • Please set reasonable check intervals to avoid overloading library servers
Usage Guidance
This skill appears to do what it says. Before installing or running it: 1) Review and create config.yaml yourself if you enable email notifications — the SMTP password is stored in that file (treat it as a secret and keep it local). 2) Install the listed Python dependencies in an isolated environment (virtualenv) and run the monitor from a user-controlled directory so book_list.json and config.yaml are kept where you expect. 3) Choose a reasonable scheduler interval to avoid overloading the library API. 4) If you want extra assurance, inspect the included files (library_scraper.py and notifier.py) yourself or run the code in a sandboxed environment; there are no hidden network endpoints or obfuscated behaviors found in the source.
Capability Analysis
Type: OpenClaw Skill Name: library-book-monitor Version: 1.0.1 The library-book-monitor skill is a legitimate utility designed to track book availability at the Shenzhen Library. The codebase is well-structured, using standard Python libraries like requests for API interaction, schedule for periodic checks, and argparse for the CLI. It manages book data in a local JSON file and supports email notifications via SMTP. No evidence of malicious intent, data exfiltration, or prompt injection was found; the requested shell and network permissions are appropriate for its stated functionality.
Capability Assessment
Purpose & Capability
Name/description align with code and runtime instructions: the package implements book management, a Shenzhen library scraper, scheduled checks, and notifications. Declared permissions (network, filesystem, shell) are appropriate for scraping, storing book_list.json, and running the CLI.
Instruction Scope
SKILL.md directs the agent to run Python CLI commands (main.py add/list/check/remove/toggle/monitor). The runtime instructions and code operate on local config.yaml/book_list.json and the Shenzhen library API; they do not instruct reading unrelated system files or environment secrets.
Install Mechanism
No installation script is provided (instruction-only install), and included code uses standard Python packages. requirements.txt lists commonly used libraries; there are no downloads from untrusted URLs or archive extraction steps.
Credentials
The skill does not require environment variables. It does use an on-disk config.yaml that can contain SMTP credentials (sender/password) for email notifications — this is proportionate to the email notification feature but is a sensitive local secret the user must supply and protect.
Persistence & Privilege
always is false and the skill does not attempt to modify other skills or global agent settings. It persists its own data to local book_list.json and relies on config.yaml as expected.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install library-book-monitor
  3. After installation, invoke the skill by name or use /library-book-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added core modules: book manager, scheduler, scraper, and notification support. - Introduced config file for flexible library, scheduling, and notification settings. - Implemented main script for command-line operations: add, list, check, remove, toggle, and monitor books. - Skill now supports scheduled background monitoring and notification when book availability changes. - Dependency management and initial project structure established.
v1.0.0
Initial release: Monitor library book availability and get notified when books become available for borrowing
Metadata
Slug library-book-monitor
Version 1.0.1
License
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Skill Openclaw Library Monitor?

Monitor library book availability and get notified when books become available for borrowing. Supports Shenzhen Library and extensible for other libraries. It is an AI Agent Skill for Claude Code / OpenClaw, with 329 downloads so far.

How do I install Skill Openclaw Library Monitor?

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

Is Skill Openclaw Library Monitor free?

Yes, Skill Openclaw Library Monitor is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Skill Openclaw Library Monitor support?

Skill Openclaw Library Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Skill Openclaw Library Monitor?

It is built and maintained by Shuai YUAN (@yszheda); the current version is v1.0.1.

💬 Comments