{
  "schemaVersion": "1.0",
  "item": {
    "slug": "searxng-bangs",
    "name": "Privacy-first web search with DuckDuckGo-style bangs (!w, !yt, !gh)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/rpeters511/searxng-bangs",
    "canonicalUrl": "https://clawhub.ai/rpeters511/searxng-bangs",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/searxng-bangs",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=searxng-bangs",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "references/api.md",
      "CLAWHUB.md",
      "SKILL.md",
      "README.md",
      "scripts/search.py",
      "INSTALL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/searxng-bangs"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/searxng-bangs",
    "agentPageUrl": "https://openagent3.xyz/skills/searxng-bangs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/searxng-bangs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/searxng-bangs/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "SearXNG Search",
        "body": "Privacy-respecting metasearch engine that anonymizes searches and aggregates results from 250+ engines."
      },
      {
        "title": "Quick Start",
        "body": "Search the web using the bundled script:\n\npython3 scripts/search.py \"your query\"\n\nReturns JSON with titles, URLs, and content snippets."
      },
      {
        "title": "Basic Web Search",
        "body": "python3 scripts/search.py \"OpenClaw AI agent\" --num 5"
      },
      {
        "title": "News Search",
        "body": "python3 scripts/search.py \"latest tech news\" --categories news"
      },
      {
        "title": "Localized Search",
        "body": "python3 scripts/search.py \"Python Tutorial\" --lang de"
      },
      {
        "title": "Multi-Category Search",
        "body": "python3 scripts/search.py \"machine learning\" --categories general,science --num 10"
      },
      {
        "title": "Bang Searches (Direct Engine)",
        "body": "# Wikipedia\npython3 scripts/search.py \"Albert Einstein\" --bang w\n\n# YouTube\npython3 scripts/search.py \"python tutorial\" --bang yt\n\n# GitHub\npython3 scripts/search.py \"openclaw\" --bang gh\n\n# Reddit\npython3 scripts/search.py \"best laptop 2026\" --bang r\n\nBangs are more granular than categories and search directly on specific engines."
      },
      {
        "title": "Privacy Features",
        "body": "SearXNG protects your privacy through multiple layers:\n\nRandomized Browser Fingerprints - Generates a new fake browser profile for each search query (version, OS, screen resolution, language)\nIP Masking - Search engines see the SearXNG instance IP, not yours\nNo Cookies - Never forwards cookies to external search engines\nNo Referrer - Target websites don't see which search engine referred you\nOptional Tor/Proxy - Can route all queries through Tor for additional anonymity\n\nResult: Search engines cannot build a profile about you."
      },
      {
        "title": "When to Use",
        "body": "Prefer SearXNG for:\n\nPrivacy-sensitive searches (no tracking, no profiling)\nHigh-volume searches (no rate limits)\nWhen self-hosted infrastructure is available\nMulti-engine result aggregation (250+ engines)\nAd-free results\n\nPrefer Brave API (web_search tool) for:\n\nFaster response times\nStructured data requirements\nWhen external APIs are acceptable"
      },
      {
        "title": "Processing Results",
        "body": "The script returns clean JSON that's easy to parse and present:\n\nimport json\nimport subprocess\n\nresult = subprocess.run(\n    ['python3', 'scripts/search.py', 'query', '--num', '5'],\n    capture_output=True,\n    text=True\n)\n\ndata = json.loads(result.stdout)\nfor item in data['results']:\n    print(f\"Title: {item['title']}\")\n    print(f\"URL: {item['url']}\")\n    print(f\"Snippet: {item['content']}\")\n    print()"
      },
      {
        "title": "Advanced Options",
        "body": "See references/api.md for:\n\nAll available categories\nEngine-specific searches\nLanguage codes\nError handling\nComparison with Brave Search API"
      },
      {
        "title": "SearXNG Instance",
        "body": "By default, the script uses http://127.0.0.1:8080. Configure via environment variable:\n\nexport SEARXNG_URL=http://your-searxng-instance.com\npython3 scripts/search.py \"query\"\n\nOptions:\n\nSelf-hosted instance (recommended for privacy)\nPublic instances: https://searx.space (community-run servers)"
      },
      {
        "title": "Using Public Instances",
        "body": "If you don't run your own SearXNG:\n\n# Example with public instance\nexport SEARXNG_URL=https://searx.be\npython3 scripts/search.py \"query\"\n\nNote: Public instances may have rate limits or be slower than self-hosted."
      },
      {
        "title": "Technical Details",
        "body": "Default URL: http://127.0.0.1:8080 (override with SEARXNG_URL)\nMethod: HTML parsing (JSON API often disabled for CSRF protection)\nParser: Custom HTMLParser in scripts/search.py\nTimeout: 15 seconds\nResult Format: Clean JSON with title, URL, content"
      }
    ],
    "body": "SearXNG Search\n\nPrivacy-respecting metasearch engine that anonymizes searches and aggregates results from 250+ engines.\n\nQuick Start\n\nSearch the web using the bundled script:\n\npython3 scripts/search.py \"your query\"\n\n\nReturns JSON with titles, URLs, and content snippets.\n\nCommon Workflows\nBasic Web Search\npython3 scripts/search.py \"OpenClaw AI agent\" --num 5\n\nNews Search\npython3 scripts/search.py \"latest tech news\" --categories news\n\nLocalized Search\npython3 scripts/search.py \"Python Tutorial\" --lang de\n\nMulti-Category Search\npython3 scripts/search.py \"machine learning\" --categories general,science --num 10\n\nBang Searches (Direct Engine)\n# Wikipedia\npython3 scripts/search.py \"Albert Einstein\" --bang w\n\n# YouTube\npython3 scripts/search.py \"python tutorial\" --bang yt\n\n# GitHub\npython3 scripts/search.py \"openclaw\" --bang gh\n\n# Reddit\npython3 scripts/search.py \"best laptop 2026\" --bang r\n\n\nBangs are more granular than categories and search directly on specific engines.\n\nPrivacy Features\n\nSearXNG protects your privacy through multiple layers:\n\nRandomized Browser Fingerprints - Generates a new fake browser profile for each search query (version, OS, screen resolution, language)\nIP Masking - Search engines see the SearXNG instance IP, not yours\nNo Cookies - Never forwards cookies to external search engines\nNo Referrer - Target websites don't see which search engine referred you\nOptional Tor/Proxy - Can route all queries through Tor for additional anonymity\n\nResult: Search engines cannot build a profile about you.\n\nWhen to Use\n\nPrefer SearXNG for:\n\nPrivacy-sensitive searches (no tracking, no profiling)\nHigh-volume searches (no rate limits)\nWhen self-hosted infrastructure is available\nMulti-engine result aggregation (250+ engines)\nAd-free results\n\nPrefer Brave API (web_search tool) for:\n\nFaster response times\nStructured data requirements\nWhen external APIs are acceptable\nProcessing Results\n\nThe script returns clean JSON that's easy to parse and present:\n\nimport json\nimport subprocess\n\nresult = subprocess.run(\n    ['python3', 'scripts/search.py', 'query', '--num', '5'],\n    capture_output=True,\n    text=True\n)\n\ndata = json.loads(result.stdout)\nfor item in data['results']:\n    print(f\"Title: {item['title']}\")\n    print(f\"URL: {item['url']}\")\n    print(f\"Snippet: {item['content']}\")\n    print()\n\nAdvanced Options\n\nSee references/api.md for:\n\nAll available categories\nEngine-specific searches\nLanguage codes\nError handling\nComparison with Brave Search API\nConfiguration\nSearXNG Instance\n\nBy default, the script uses http://127.0.0.1:8080. Configure via environment variable:\n\nexport SEARXNG_URL=http://your-searxng-instance.com\npython3 scripts/search.py \"query\"\n\n\nOptions:\n\nSelf-hosted instance (recommended for privacy)\nPublic instances: https://searx.space (community-run servers)\nUsing Public Instances\n\nIf you don't run your own SearXNG:\n\n# Example with public instance\nexport SEARXNG_URL=https://searx.be\npython3 scripts/search.py \"query\"\n\n\nNote: Public instances may have rate limits or be slower than self-hosted.\n\nTechnical Details\nDefault URL: http://127.0.0.1:8080 (override with SEARXNG_URL)\nMethod: HTML parsing (JSON API often disabled for CSRF protection)\nParser: Custom HTMLParser in scripts/search.py\nTimeout: 15 seconds\nResult Format: Clean JSON with title, URL, content"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/rpeters511/searxng-bangs",
    "publisherUrl": "https://clawhub.ai/rpeters511/searxng-bangs",
    "owner": "rpeters511",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/searxng-bangs",
    "downloadUrl": "https://openagent3.xyz/downloads/searxng-bangs",
    "agentUrl": "https://openagent3.xyz/skills/searxng-bangs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/searxng-bangs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/searxng-bangs/agent.md"
  }
}