← Back to Skills Marketplace
x3r081

Blocket Watcher - Sweden

by x3r081 · GitHub ↗ · v1.0.0 · MIT-0
linux ✓ Security Clean
102
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install blocket-watch
Description
Poll Swedish Blocket.se via the blocket CLI on a schedule, dedupe listings by ad id, and send new matches to Telegram with openclaw message send — no LLM on...
README (SKILL.md)

Blocket Watch

OS-scheduled watcher for Blocket.se (Sweden). It runs blocket with your search argv, tracks seen ad IDs in seen.json, and notifies only via openclaw message send (Telegram by default). No hosted model is invoked during polling.

When to use this skill

  • You run OpenClaw with the Telegram channel configured.
  • You have the blocket CLI installed (blocket --help).
  • You want periodic checks (e.g. systemd user timer), not OpenClaw Gateway cron alone.

Install (end user)

  1. Install OpenClaw and authenticate openclaw so openclaw message send works.
  2. Install blocket (see upstream docs for your OS).
  3. Copy this skill folder to a fixed path, e.g. ~/.openclaw/scripts/blocket-watch/.
  4. cp config.example.json config.json and edit:
    • telegram_target: your Telegram chat id (DM with the bot).
    • queries: one object per search; argv is passed to blocket after the binary name.
  5. cp seen.example.json seen.json (or start with {"ids":[]}).
  6. chmod +x poll.sh onboard.sh
  7. Optional: install systemd/blocket-watch.service and blocket-watch.timeredit WorkingDirectory and ExecStart in the service file to match step 3.
  8. systemctl --user enable --now blocket-watch.timer

Operations

Action Command
Poll (normal) ./poll.sh
Poll without Telegram / without updating seen BLOCKET_WATCH_DRY_RUN=1 ./poll.sh
Post current config to Telegram ./onboard.sh
Preview onboard text locally ./onboard.sh --dry-run

Config shape

  • enabled: set true when ready.
  • telegram_target: recipient for openclaw message send.
  • queries: list of { "label", "argv", optional "max_price", "max_price_currency" }. If max_price is set, only listings ≤ max_price in that currency are notified (default currency SEK).

See README.md for argv examples (general search, cars, boats).

Security and etiquette

  • Do not commit real config.json or seen.json with personal chat IDs to public repos.
  • Respect Blocket’s terms of use and rate limits; this tool is for personal monitoring.
  • Telegram targets and search terms are your data — keep them private.

License

This skill is published under MIT-0 (see LICENSE). By publishing or redistributing on ClawHub you agree to the registry’s MIT-0 terms.

Usage Guidance
This skill appears to do exactly what it claims: run the `blocket` CLI on a schedule, dedupe by ad id, and send messages via `openclaw message send`. Before installing: 1) Ensure you install `blocket` and `openclaw` from trusted sources and that OpenClaw is authenticated only with the channels/accounts you intend to use. 2) Do not commit config.json or seen.json (these contain your Telegram chat id and tracked ids). 3) Edit the systemd service WorkingDirectory/ExecStart to the absolute path you choose. 4) Run a dry-run first (BLOCKET_WATCH_DRY_RUN=1 ./poll.sh) to validate behavior. 5) Review permissions on the script directory so seen.json is only writable by your user. If you want stronger guarantees, inspect the binaries `blocket` and `openclaw` on your system to confirm they are official and behave as expected.
Capability Analysis
Type: OpenClaw Skill Name: blocket-watch Version: 1.0.0 The blocket-watch skill is a legitimate utility for monitoring Swedish Blocket.se listings. It uses the 'blocket' CLI to fetch data and 'openclaw message send' to notify users via Telegram, as described in SKILL.md and README.md. The Python scripts (poll.py and onboard.py) handle data processing and configuration reporting without any evidence of malicious intent, unauthorized data exfiltration, or obfuscation.
Capability Assessment
Purpose & Capability
Name/description align with required binaries and included scripts: poll.py/onboard.py call the `blocket` CLI to fetch results and `openclaw message send` to notify Telegram. No unrelated services, credentials, or binaries are requested.
Instruction Scope
Runtime instructions and scripts operate only on local config.json and seen.json in the skill folder, invoke the `blocket` and `openclaw` CLIs, and optionally read the non-sensitive env var BLOCKET_WATCH_DRY_RUN for dry-run behavior. The SKILL.md and code do not transmit data to unexpected external endpoints beyond those two CLIs. They do assume `openclaw` is already authenticated (so OpenClaw-managed credentials will be used when sending messages).
Install Mechanism
No install spec is provided (instruction-only install). The skill is distributed as source scripts that the user copies; nothing is downloaded or executed from an arbitrary URL by the skill itself.
Credentials
The skill declares no required environment variables and requires only the `blocket` and `openclaw` binaries. It does rely on OpenClaw being configured (so OpenClaw's channel tokens/credentials are used to send Telegram messages), which is expected and proportionate. The skill does use a non-sensitive runtime env var (BLOCKET_WATCH_DRY_RUN) not declared in metadata; this is for user dry-runs only and not a credential.
Persistence & Privilege
The skill is not marked always:true and does not request elevated privileges. It writes a local seen.json to persist seen ad IDs and will be started via a systemd user timer if the user installs that; it does not modify other skills or system-wide agent configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install blocket-watch
  3. After installation, invoke the skill by name or use /blocket-watch
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Blocket Watch v1.1.0 - Improved documentation for installation, configuration, and usage. - Clearer instructions added for systemd timer setup. - Enhanced configuration explanation, including search argument examples and filtering by max price. - Security, privacy, and etiquette guidelines now included. - License clarified as MIT-0.
Metadata
Slug blocket-watch
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Blocket Watcher - Sweden?

Poll Swedish Blocket.se via the blocket CLI on a schedule, dedupe listings by ad id, and send new matches to Telegram with openclaw message send — no LLM on... It is an AI Agent Skill for Claude Code / OpenClaw, with 102 downloads so far.

How do I install Blocket Watcher - Sweden?

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

Is Blocket Watcher - Sweden free?

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

Which platforms does Blocket Watcher - Sweden support?

Blocket Watcher - Sweden is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux).

Who created Blocket Watcher - Sweden?

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

💬 Comments