← Back to Skills Marketplace
SoundCloud Watcher
by
Akilles Admin
· GitHub ↗
· v2.4.0
· MIT-0
750
Downloads
2
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install soundcloud-watcher
Description
Monitor your SoundCloud account, track artist releases, and get notified about new followers and likes.
Usage Guidance
This plugin appears to do what it says: monitor your SoundCloud account using the SoundCloud API and store plugin state under ~/.openclaw. Before installing: 1) Confirm the repository and package authors (README/package.json point to a GitHub repo and npm package) and prefer installing from the official source (git or npm) rather than unknown mirrors. 2) Be aware you must provide your SoundCloud Client ID/Client Secret and username; these are stored under ~/.openclaw/secrets/soundcloud.env and the plugin may also persist an access token in the same file. Ensure that file has restrictive filesystem permissions (e.g., 600). 3) Verify the registry metadata mismatch (the top-level metadata in the listing omitted required env/config paths) — that likely indicates an oversight in the registry entry, not malicious intent, but you should confirm the package source before trusting secrets to it. 4) If you need higher assurance, review the full plugin code in the referenced GitHub repo and verify it only calls api.soundcloud.com and does not include any other network endpoints. 5) To remove, follow the README uninstall steps and delete the secrets/data files. If you want me to, I can (a) fetch and compare the referenced GitHub repo code against these files, or (b) search the rest of the truncated source for any networking endpoints beyond api.soundcloud.com.
Capability Analysis
Type: OpenClaw Skill
Name: soundcloud-watcher
Version: 2.4.0
The SoundCloud Watcher plugin is a legitimate tool for monitoring account activity and artist releases. It follows standard OpenClaw patterns for credential management (using ~/.openclaw/secrets/soundcloud.env) and state persistence. The code in soundcloud_watcher.ts demonstrates high security awareness by implementing explicit sanitization of API-retrieved metadata (usernames, track titles) to prevent prompt injection against the agent. Network activity is strictly limited to official SoundCloud API endpoints (api.soundcloud.com and secure.soundcloud.com).
Capability Assessment
Purpose & Capability
The plugin claims to monitor a SoundCloud account and the code implements that: it reads a local secrets file, calls the SoundCloud API, and stores tracking data under ~/.openclaw. However the registry metadata at the top of the report claimed 'no required env vars / config paths', while the included openclaw.plugin.json and SKILL.md require SOUNDCLOUD_CLIENT_ID, SOUNDCLOUD_CLIENT_SECRET, MY_USERNAME and specific ~/.openclaw paths — a metadata mismatch that should be clarified.
Instruction Scope
SKILL.md instructs the agent to install/enable the plugin, place SoundCloud credentials in ~/.openclaw/secrets/soundcloud.env, and run cron or command triggers. The runtime instructions and commands map to code handlers; there are no instructions to read unrelated system files or exfiltrate data outside the SoundCloud API. The plugin reads/writes only its own ~/.openclaw files (secrets, data, backoff state).
Install Mechanism
This is an instruction-only plugin in the registry (no install spec). The package includes TypeScript source files and package.json, but there is no external download-from-URL or unexpected installer. No high-risk install behavior (no URL shorteners, no archives being downloaded at runtime) is present in the provided files.
Credentials
The environment/secret requirements (SoundCloud client ID/secret and username) are appropriate and expected for a SoundCloud integration. The plugin also persists an access token to the same secrets file and stores state in ~/.openclaw/data; this is typical. However, the registry-level metadata claims no required env vars or config paths while the plugin manifest and SKILL.md clearly require them — this discrepancy is unexpected and merits confirmation before installing.
Persistence & Privilege
The plugin requests no elevated platform privileges (always: false) and does not attempt to modify other plugins' configs. It persists only its own state under ~/.openclaw and writes a saved access token to its secrets file, which is consistent with its function.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soundcloud-watcher - After installation, invoke the skill by name or use
/soundcloud-watcher - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.4.0
Sanitize user-controlled data in output to prevent prompt injection
v2.3.1
Migrate to SoundCloud OAuth 2.1, declare required env vars in registry metadata
v2.3.0
Migrate to SoundCloud OAuth 2.1 (secure.soundcloud.com/oauth/token with Basic auth)
v2.2.5
Declare required env vars and data paths in metadata, remove Telegram-specific wording
v2.2.3
- Updated cron job example in documentation to remove the explicit Telegram forwarding instruction.
- Documentation improvements in README.md and SKILL.md for clarity and updated usage instructions.
- No functional or code changes.
v2.2.2
- Updated dependencies in package.json for improved stability.
- Revised plugin metadata in openclaw.plugin.json.
- No user-facing feature changes.
v2.2.1
- Improved documentation with clearer setup instructions and command usage.
- Added detailed installation and configuration steps for easier onboarding.
- Enhanced command list with descriptions for all available actions.
- Included example for setting up automated checks via cron.
Metadata
Frequently Asked Questions
What is SoundCloud Watcher?
Monitor your SoundCloud account, track artist releases, and get notified about new followers and likes. It is an AI Agent Skill for Claude Code / OpenClaw, with 750 downloads so far.
How do I install SoundCloud Watcher?
Run "/install soundcloud-watcher" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is SoundCloud Watcher free?
Yes, SoundCloud Watcher is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does SoundCloud Watcher support?
SoundCloud Watcher is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created SoundCloud Watcher?
It is built and maintained by Akilles Admin (@wlinds); the current version is v2.4.0.
More Skills