From f38b13c56384ded62d2c87f3ef0f45dd280663b7 Mon Sep 17 00:00:00 2001 From: Stefano Fiorini Date: Sun, 8 Mar 2026 20:35:48 -0500 Subject: [PATCH] Trim searxng skill to minimal custom-skill layout --- skills/searxng/.clawhub/origin.json | 7 -- skills/searxng/CHANGELOG.md | 38 ------ skills/searxng/PUBLISH.md | 147 ---------------------- skills/searxng/PUBLISHING_CHECKLIST.md | 111 ---------------- skills/searxng/README.md | 168 ------------------------- skills/searxng/_meta.json | 6 - 6 files changed, 477 deletions(-) delete mode 100644 skills/searxng/.clawhub/origin.json delete mode 100644 skills/searxng/CHANGELOG.md delete mode 100644 skills/searxng/PUBLISH.md delete mode 100644 skills/searxng/PUBLISHING_CHECKLIST.md delete mode 100644 skills/searxng/README.md delete mode 100644 skills/searxng/_meta.json diff --git a/skills/searxng/.clawhub/origin.json b/skills/searxng/.clawhub/origin.json deleted file mode 100644 index 14461a6..0000000 --- a/skills/searxng/.clawhub/origin.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - "version": 1, - "registry": "https://clawhub.ai", - "slug": "searxng", - "installedVersion": "1.0.3", - "installedAt": 1773013420514 -} diff --git a/skills/searxng/CHANGELOG.md b/skills/searxng/CHANGELOG.md deleted file mode 100644 index c72690a..0000000 --- a/skills/searxng/CHANGELOG.md +++ /dev/null @@ -1,38 +0,0 @@ -# Changelog - -All notable changes to the SearXNG skill will be documented in this file. - -The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), -and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). - -## [1.0.1] - 2026-01-26 - -### Changed -- **Security:** Changed default SEARXNG_URL from hardcoded private URL to generic `http://localhost:8080` -- **Configuration:** Made SEARXNG_URL required configuration (no private default) -- Updated all documentation to emphasize configuration requirement -- Removed hardcoded private URL from all documentation - -### Security -- Eliminated exposure of private SearXNG instance URL in published code - -## [1.0.0] - 2026-01-26 - -### Added -- Initial release -- Web search via local SearXNG instance -- Multiple search categories (general, images, videos, news, map, music, files, it, science) -- Time range filters (day, week, month, year) -- Rich table output with result snippets -- JSON output mode for programmatic use -- SSL self-signed certificate support -- Configurable SearXNG instance URL via SEARXNG_URL env var -- Comprehensive error handling -- Rich CLI with argparse - -### Features -- Privacy-focused (all searches local) -- No API keys required -- Multi-engine result aggregation -- Beautiful formatted output -- Language selection support diff --git a/skills/searxng/PUBLISH.md b/skills/searxng/PUBLISH.md deleted file mode 100644 index 6731d3e..0000000 --- a/skills/searxng/PUBLISH.md +++ /dev/null @@ -1,147 +0,0 @@ -# Publishing SearXNG Skill to ClawdHub - -## ✅ Pre-Publication Verification - -All files present: -- [x] SKILL.md (v1.0.1) -- [x] README.md -- [x] LICENSE (MIT) -- [x] CHANGELOG.md -- [x] scripts/searxng.py -- [x] .clawdhub/metadata.json - -Security: -- [x] No hardcoded private URLs -- [x] Generic default (http://localhost:8080) -- [x] Fully configurable via SEARXNG_URL - -Author: -- [x] Updated to: Avinash Venkatswamy - -## 📤 Publishing Steps - -### Step 1: Login to ClawdHub - -```bash -clawdhub login -``` - -This will open your browser. Complete the authentication flow. - -### Step 2: Verify Authentication - -```bash -clawdhub whoami -``` - -Should return your user info if logged in successfully. - -### Step 3: Publish the Skill - -From the workspace root: - -```bash -cd ~/clawd -clawdhub publish skills/searxng -``` - -Or from the skill directory: - -```bash -cd ~/clawd/skills/searxng -clawdhub publish . -``` - -### Step 4: Verify Publication - -After publishing, you can: - -**Search for your skill:** -```bash -clawdhub search searxng -``` - -**View on ClawdHub:** -Visit https://clawdhub.com/skills/searxng - -## 📋 What Gets Published - -The CLI will upload: -- SKILL.md -- README.md -- LICENSE -- CHANGELOG.md -- scripts/ directory -- .clawdhub/metadata.json - -It will NOT upload: -- PUBLISH.md (this file) -- PUBLISHING_CHECKLIST.md -- Any .git files -- Any node_modules or temporary files - -## 🔧 If Publishing Fails - -### Common Issues - -1. **Not logged in:** - ```bash - clawdhub login - ``` - -2. **Invalid skill structure:** - - Verify SKILL.md has all required fields - - Check .clawdhub/metadata.json is valid JSON - -3. **Duplicate slug:** - - If "searxng" is taken, you'll need a different name - - Update `name` in SKILL.md and metadata.json - -4. **Network issues:** - - Check your internet connection - - Try again: `clawdhub publish skills/searxng` - -### Get Help - -```bash -clawdhub publish --help -``` - -## 📊 After Publishing - -### Update Notifications - -If you make changes later: - -1. Update version in SKILL.md and metadata.json -2. Add entry to CHANGELOG.md -3. Run: `clawdhub publish skills/searxng` - -### Manage Your Skill - -**Delete (soft-delete):** -```bash -clawdhub delete searxng -``` - -**Undelete:** -```bash -clawdhub undelete searxng -``` - -## 🎉 Success! - -Once published, users can install with: - -```bash -clawdhub install searxng -``` - -Your skill will appear: -- On ClawdHub website: https://clawdhub.com -- In search results: `clawdhub search privacy` -- In explore: `clawdhub explore` - ---- - -**Ready to publish?** Run `clawdhub login` and then `clawdhub publish skills/searxng`! diff --git a/skills/searxng/PUBLISHING_CHECKLIST.md b/skills/searxng/PUBLISHING_CHECKLIST.md deleted file mode 100644 index 15323f4..0000000 --- a/skills/searxng/PUBLISHING_CHECKLIST.md +++ /dev/null @@ -1,111 +0,0 @@ -# ClawdHub Publishing Checklist - -## ✅ Pre-Publication Checklist - -### Required Files -- [x] `SKILL.md` - Skill definition with metadata -- [x] `README.md` - Comprehensive documentation -- [x] `LICENSE` - MIT License -- [x] `CHANGELOG.md` - Version history -- [x] `scripts/searxng.py` - Main implementation -- [x] `.clawdhub/metadata.json` - ClawdHub metadata - -### SKILL.md Requirements -- [x] `name` field -- [x] `description` field -- [x] `author` field -- [x] `version` field -- [x] `homepage` field -- [x] `triggers` keywords (optional but recommended) -- [x] `metadata` with emoji and requirements - -### Code Quality -- [x] Script executes successfully -- [x] Error handling implemented -- [x] Dependencies documented (inline PEP 723) -- [x] Help text / usage instructions -- [x] Clean, readable code - -### Documentation -- [x] Clear description of what it does -- [x] Prerequisites listed -- [x] Installation instructions -- [x] Usage examples (CLI + conversational) -- [x] Configuration options -- [x] Troubleshooting section -- [x] Feature list - -### Testing -- [x] Tested with target system (SearXNG) -- [x] Basic search works -- [x] Category search works -- [x] JSON output works -- [x] Error cases handled gracefully -- [ ] Tested on different SearXNG instances (optional) -- [ ] Tested with authenticated SearXNG (optional) - -### Metadata -- [x] Version number follows semver -- [x] Author attribution -- [x] License specified -- [x] Tags/keywords for discovery -- [x] Prerequisites documented - -## ⚠️ Optional Improvements - -### Nice to Have (not blocking) -- [ ] CI/CD for automated testing -- [ ] Multiple example configurations -- [ ] Screenshot/demo GIF -- [ ] Video demonstration -- [ ] Integration tests -- [ ] Authentication support (for private instances) -- [ ] Config file support (beyond env vars) -- [ ] Auto-discovery of local SearXNG instances - -### Future Enhancements -- [ ] Result caching -- [ ] Search history -- [ ] Favorite searches -- [ ] Custom result templates -- [ ] Export results to various formats -- [ ] Integration with other Clawdbot skills - -## 🚀 Publishing Steps - -1. **Review all files** - Make sure everything is polished -2. **Test one more time** - Fresh installation test -3. **Version bump if needed** - Update SKILL.md, metadata.json, CHANGELOG.md -4. **Git commit** - Clean commit message -5. **Submit to ClawdHub** - Follow ClawdHub submission process -6. **Monitor feedback** - Be ready to address issues - -## 📝 Current Status - -**Ready for publication:** ✅ YES - -**Confidence level:** High - -**Known limitations:** -- Requires a running SearXNG instance (clearly documented) -- SSL verification disabled for self-signed certs (by design) -- No authentication support yet (acceptable for v1.0.0) - -**Recommended for:** Users who: -- Value privacy -- Run their own SearXNG instance -- Want to avoid commercial search APIs -- Need local/offline search capability - -## 🎯 Next Steps - -1. **Publish to ClawdHub** - Skill is ready! -2. **Gather user feedback** - Real-world usage -3. **Plan v1.1.0** - Authentication support, more features -4. **Community contributions** - Accept PRs for improvements - ---- - -**Assessment:** This skill is publication-ready! 🎉 - -All critical requirements are met, documentation is excellent, and the code works reliably. diff --git a/skills/searxng/README.md b/skills/searxng/README.md deleted file mode 100644 index 395ba25..0000000 --- a/skills/searxng/README.md +++ /dev/null @@ -1,168 +0,0 @@ -# SearXNG Search Skill for Clawdbot - -Privacy-respecting web search using your local SearXNG instance. - -## Prerequisites - -**This skill requires a running SearXNG instance.** - -If you don't have SearXNG set up yet: - -1. **Docker (easiest)**: - ```bash - docker run -d -p 8080:8080 searxng/searxng - ``` - -2. **Manual installation**: Follow the [official guide](https://docs.searxng.org/admin/installation.html) - -3. **Public instances**: Use any public SearXNG instance (less private) - -## Features - -- 🔒 **Privacy-focused**: Uses your local SearXNG instance -- 🌐 **Multi-engine**: Aggregates results from multiple search engines -- 📰 **Multiple categories**: Web, images, news, videos, and more -- 🎨 **Rich output**: Beautiful table formatting with result snippets -- 🚀 **Fast JSON mode**: Programmatic access for scripts and integrations - -## Quick Start - -### Basic Search -``` -Search "python asyncio tutorial" -``` - -### Advanced Usage -``` -Search "climate change" with 20 results -Search "cute cats" in images category -Search "breaking news" in news category from last day -``` - -## Configuration - -**You must configure your SearXNG instance URL before using this skill.** - -### Set Your SearXNG Instance - -Configure the `SEARXNG_URL` environment variable in your Clawdbot config: - -```json -{ - "env": { - "SEARXNG_URL": "https://your-searxng-instance.com" - } -} -``` - -Or export it in your shell: -```bash -export SEARXNG_URL=https://your-searxng-instance.com -``` - -## Direct CLI Usage - -You can also use the skill directly from the command line: - -```bash -# Basic search -uv run ~/clawd/skills/searxng/scripts/searxng.py search "query" - -# More results -uv run ~/clawd/skills/searxng/scripts/searxng.py search "query" -n 20 - -# Category search -uv run ~/clawd/skills/searxng/scripts/searxng.py search "query" --category images - -# JSON output (for scripts) -uv run ~/clawd/skills/searxng/scripts/searxng.py search "query" --format json - -# Time-filtered news -uv run ~/clawd/skills/searxng/scripts/searxng.py search "latest AI news" --category news --time-range day -``` - -## Available Categories - -- `general` - General web search (default) -- `images` - Image search -- `videos` - Video search -- `news` - News articles -- `map` - Maps and locations -- `music` - Music and audio -- `files` - File downloads -- `it` - IT and programming -- `science` - Scientific papers and resources - -## Time Ranges - -Filter results by recency: -- `day` - Last 24 hours -- `week` - Last 7 days -- `month` - Last 30 days -- `year` - Last year - -## Examples - -### Web Search -```bash -uv run ~/clawd/skills/searxng/scripts/searxng.py search "rust programming language" -``` - -### Image Search -```bash -uv run ~/clawd/skills/searxng/scripts/searxng.py search "sunset photography" --category images -n 10 -``` - -### Recent News -```bash -uv run ~/clawd/skills/searxng/scripts/searxng.py search "tech news" --category news --time-range day -``` - -### JSON Output for Scripts -```bash -uv run ~/clawd/skills/searxng/scripts/searxng.py search "python tips" --format json | jq '.results[0]' -``` - -## SSL/TLS Notes - -The skill is configured to work with self-signed certificates (common for local SearXNG instances). If you need strict SSL verification, edit the script and change `verify=False` to `verify=True` in the httpx request. - -## Troubleshooting - -### Connection Issues - -If you get connection errors: - -1. **Check your SearXNG instance is running:** - ```bash - curl -k $SEARXNG_URL - # Or: curl -k http://localhost:8080 (default) - ``` - -2. **Verify the URL in your config** -3. **Check SSL certificate issues** - -### No Results - -If searches return no results: - -1. Check your SearXNG instance configuration -2. Ensure search engines are enabled in SearXNG settings -3. Try different search categories - -## Privacy Benefits - -- **No tracking**: All searches go through your local instance -- **No data collection**: Results are aggregated locally -- **Engine diversity**: Combines results from multiple search providers -- **Full control**: You manage the SearXNG instance - -## About SearXNG - -SearXNG is a free, open-source metasearch engine that respects your privacy. It aggregates results from multiple search engines while not storing your search data. - -Learn more: https://docs.searxng.org/ - -## License - -This skill is part of the Clawdbot ecosystem and follows the same license terms. diff --git a/skills/searxng/_meta.json b/skills/searxng/_meta.json deleted file mode 100644 index 7751dd1..0000000 --- a/skills/searxng/_meta.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "ownerId": "kn76z88c7kaynewbq2n2cv8831801bfs", - "slug": "searxng", - "version": "1.0.3", - "publishedAt": 1769472992634 -} \ No newline at end of file