ClawNetClawNet

Sonos Music Search Skill

A custom ClawHub skill that combines Brave Search and Sonos CLI to let you search for and play music on your Sonos speakers directly from the command line.

Features

  • Uses Brave Search to find Spotify tracks across the web
  • Automatically plays found tracks on your specified Sonos speaker
  • Supports viewing currently playing track
  • Configurable safe search mode via SAFESEARCH_MODE environment variable
  • Smart Spotify URI construction (strips tracking query parameters)
  • Device discovery with caching and timeout protection

Prerequisites

  • Node.js >= 14
  • A Sonos speaker on the same network
  • A Brave Search API key (Get one here)
  • Spotify account linked to your Sonos system

Installation

  1. Install dependencies: npm install
  2. Set your Brave Search API key: export BRAVE_API_KEY=your-api-key
  3. (Optional) Configure safe search mode: export SAFESEARCH_MODE=moderate (default: moderate, options: off, moderate, strict)

Usage

Play a track

node src/index.js play "Living Room" "pink floyd comfortably numb"

View currently playing track

node src/index.js current "Living Room"

Programmatic usage

const { searchAndPlay, getCurrentTrack } = require('./src/index');

const result = await searchAndPlay('Living Room', 'pink floyd comfortably numb');
console.log(result);
// { success: true, track: '...', speaker: 'Living Room', uri: 'spotify:track:...' }

const track = await getCurrentTrack('Living Room');
console.log(track);
// { title: 'Comfortably Numb', artist: 'Pink Floyd', album: '...', duration: 382 }

Configuration

Environment Variable Required Default Description
BRAVE_API_KEY Yes - Your Brave Search API key
SAFESEARCH_MODE No moderate Safe search mode: off/moderate/strict

Audit the skill

npm run audit

Format markdown files

npm run format

Publish to ClawHub

clawhub publish .

License

MIT