searxng 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2b8849ed3269f41fc39d8b6274f8b0ae92ade2649dd1f6e5111b1799fec375e5
+  data.tar.gz: cd78466743cbad58a93d2453f2128e7bfb2f139a05c84eba0c984166da662e2f
+SHA512:
+  metadata.gz: 38818edbabaf94b55bca1e43cbee38fb8bf7d54319d1b2fe3b56a10653f33152011697dd01e9135d1e05fc23f07629a716578dce791b55addc97ca3f471afd92
+  data.tar.gz: 4a77e1ba98532c75d7da8c5e3da80c5cb53127488c094fa8dfc331de5285afb4a78e5278f332aa92e27d8e489a1273e8e39eea1027d4643988869c9bdd75b610

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0
+
+- Initial release.
+- `Searxng::Client` for SearXNG `/search` JSON API (results, infoboxes, suggestions, answers, corrections).
+- CLI: `searxng search QUERY` and `searxng serve` (MCP server).
+- MCP tool `searxng_web_search` (query, pageno, time_range, language, safesearch).
+- Configuration via SEARXNG_URL, SEARXNG_USER, SEARXNG_PASSWORD.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andrei Makarov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,201 @@
+# searxng
+
+[![Gem Version](https://badge.fury.io/rb/searxng.svg)](https://badge.fury.io/rb/searxng) [![Test Status](https://github.com/amkisko/searxng.rb/actions/workflows/test.yml/badge.svg)](https://github.com/amkisko/searxng.rb/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/amkisko/searxng.rb/graph/badge.svg)](https://codecov.io/gh/amkisko/searxng.rb)
+
+Ruby gem providing a SearXNG HTTP client, CLI (search), and MCP (Model Context Protocol) server for web search. Integrates with MCP-compatible clients like Codex, Cursor, Claude, and other MCP-enabled tools.
+
+Sponsored by [Kisko Labs](https://www.kiskolabs.com).
+
+<a href="https://www.kiskolabs.com">
+  <img src="kisko.svg" width="200" alt="Sponsored by Kisko Labs" />
+</a>
+
+## Requirements
+
+- **Ruby 3.1 or higher** (Ruby 3.0 and earlier are not supported). For managing Ruby versions, [rbenv](https://github.com/rbenv/rbenv) or [mise](https://mise.jdx.dev/) are recommended; system Ruby may be sufficient if it meets the version requirement.
+
+## Quick Start
+
+```bash
+gem install searxng
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "searxng"
+```
+
+### Configuration
+
+- **SEARXNG_URL** (required for remote): Base URL of your SearXNG instance (e.g. `http://localhost:8080` or `https://search.example.com`). Defaults to `http://localhost:8080` when not set.
+- **SEARXNG_USER** / **SEARXNG_PASSWORD** (optional): Basic auth credentials if your instance is protected.
+- **SEARXNG_CA_FILE** / **SEARXNG_CA_PATH** (optional): Custom CA certificate file or directory for HTTPS. You can also pass `ca_file:`, `ca_path:`, or `verify_mode:` to `Searxng::Client.new`.
+- **SEARXNG_USER_AGENT** (optional): Custom User-Agent string. The client sends a default identifying the gem; if your instance returns 403 Forbidden (e.g. bot detection), set a custom User-Agent or pass `user_agent:` to `Searxng::Client.new`.
+
+To fully customize the HTTP client (e.g. custom certs, proxy, timeouts), override `#build_http(uri)` in a subclass, or pass a `configure_http:` callable to the client; it is invoked with the `Net::HTTP` instance and the request URI before each request.
+
+### Cursor IDE Configuration
+
+For Cursor IDE, create or update `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "searxng": {
+      "command": "bundle",
+      "args": ["exec", "searxng", "serve"],
+      "env": {
+        "SEARXNG_URL": "http://localhost:8080"
+      }
+    }
+  }
+}
+```
+
+**Note**: Using `gem exec searxng serve` (with `command`: `"gem"`, `args`: `["exec", "searxng", "serve"]`) ensures the correct Ruby version is used when the gem is installed globally.
+
+### Claude Desktop Configuration
+
+For Claude Desktop, edit the MCP configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "searxng": {
+      "command": "bundle",
+      "args": ["exec", "searxng", "serve"],
+      "env": {
+        "SEARXNG_URL": "http://localhost:8080"
+      }
+    }
+  }
+}
+```
+
+**Note**: After updating the configuration, restart Claude Desktop for changes to take effect.
+
+### Running the MCP Server manually
+
+After installation, you can start the MCP server immediately:
+
+```bash
+# With bundler
+bundle exec searxng serve
+
+# Or if installed globally
+gem exec searxng serve
+```
+
+The server will start and communicate via STDIN/STDOUT using the MCP protocol.
+
+### Testing with MCP Inspector
+
+You can test the MCP server using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) tool:
+
+```bash
+# Ensure a SearXNG instance is running (e.g. docker compose -f examples/docker-compose.yml up -d)
+export SEARXNG_URL="http://localhost:8080"
+
+# Run the MCP inspector with the server
+npx @modelcontextprotocol/inspector bundle exec searxng serve
+```
+
+The inspector will:
+
+1. Start a proxy server and open a browser interface
+2. Connect to your MCP server via STDIO
+3. Allow you to test all available tools interactively
+4. Display request/response messages and any errors
+
+Useful for testing the `searxng_web_search` tool before integrating with Cursor or other MCP clients.
+
+## Features
+
+- **SearXNG HTTP Client**: Full-featured client for the SearXNG search API (results, infoboxes, suggestions, answers, corrections)
+- **CLI**: `searxng search` for ad-hoc queries and `searxng serve` for the MCP server
+- **MCP Server Integration**: Ready-to-use MCP server with web search tool, compatible with Cursor IDE, Claude Desktop, and other MCP-enabled tools
+- **Configurable HTTP**: Optional custom CA, verify mode, and `configure_http` hook or `build_http` override for proxy/timeouts/certs
+- **Basic Auth**: Optional Basic authentication via options or ENV
+
+## Basic Usage
+
+### Ruby API
+
+```ruby
+require "searxng"
+
+client = Searxng::Client.new
+data = client.search("ruby programming", pageno: 1, language: "en")
+
+data[:results].each do |r|
+  puts r[:title], r[:url], r[:content]
+end
+```
+
+### CLI
+
+```bash
+searxng search "your query"
+searxng search "ruby" --page 2 --language en --time-range day --json
+```
+
+Options: `--url`, `--page`, `--language`, `--time-range` (day|month|year), `--safesearch` (0|1|2), `--json`.
+
+## MCP Tools
+
+The MCP server provides the following tools:
+
+1. **searxng_web_search** - Web search via SearXNG
+   - Parameters: `query` (required), `pageno` (optional), `max_results` (optional, default 10), `time_range` (optional), `language` (optional), `safesearch` (optional). Use `max_results` to limit how many results are returned in one response (reduces token usage); use `pageno` for the next page.
+
+## Examples
+
+See [examples/SETUP.md](examples/SETUP.md) for running SearXNG locally (e.g. Docker) and [examples/run_queries.rb](examples/run_queries.rb) for a small script using the client.
+
+## Development
+
+```bash
+# Install dependencies
+bundle install
+
+# Run tests
+bundle exec rspec
+
+# Run tests across multiple Ruby versions
+bundle exec appraisal install
+bundle exec appraisal rspec
+
+# Run linting
+bundle exec rubocop
+
+# Validate RBS type signatures
+bundle exec rbs validate
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/amkisko/searxng.rb.
+
+Contribution policy:
+- New features are not necessarily added to the gem
+- Pull request should have test coverage for affected parts
+- Pull request should have changelog entry
+
+Review policy:
+- It might take up to 2 calendar weeks to review and merge critical fixes
+- It might take up to 6 calendar months to review and merge pull request
+- It might take up to 1 calendar year to review an issue
+
+For more information, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Security
+
+If you discover a security vulnerability, please report it responsibly. See [SECURITY.md](SECURITY.md) for details.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/bin/searxng

@@ -0,0 +1,70 @@
+#!/usr/bin/env ruby
+
+cmd = ARGV.shift
+
+case cmd
+when "serve"
+  unless ENV["DEBUG"]
+    require "stringio"
+    $stderr = StringIO.new
+    $stderr.set_encoding("UTF-8")
+  end
+  $LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+  require "searxng/server"
+  Searxng::Server.start
+when "search"
+  $LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+  require "searxng"
+  require "optparse"
+  require "json"
+
+  base_url = nil
+  page = 1
+  language = "all"
+  time_range = nil
+  safesearch = nil
+  json_output = false
+
+  OptionParser.new do |o|
+    o.on("--url URL", "SearXNG base URL (overrides SEARXNG_URL)") { |v| base_url = v }
+    o.on("--page N", Integer, "Page number (default: 1)") { |v| page = v }
+    o.on("--language LANG", "Language code (default: all)") { |v| language = v }
+    o.on("--time-range RANGE", "Time range: day, month, year") { |v| time_range = v }
+    o.on("--safesearch N", Integer, "Safe search: 0, 1, or 2") { |v| safesearch = v }
+    o.on("--json", "Output raw JSON") { json_output = true }
+  end.parse!(ARGV)
+
+  query = ARGV.join(" ").strip
+  if query.empty?
+    warn "Usage: searxng search QUERY [--url URL] [--page N] [--language LANG] [--time-range day|month|year] [--safesearch 0|1|2] [--json]"
+    exit 1
+  end
+
+  opts = { pageno: page, language: language, time_range: time_range, safesearch: safesearch }
+  opts[:base_url] = base_url if base_url
+
+  client = Searxng::Client.new(**opts.slice(:base_url))
+  data = client.search(query, **opts.slice(:pageno, :time_range, :language, :safesearch))
+
+  if json_output
+    puts JSON.pretty_generate(data)
+  else
+    data[:infoboxes]&.each do |ib|
+      puts "Infobox: #{ib[:infobox]}"
+      puts "  #{ib[:content]}"
+      puts ""
+    end
+    data[:results]&.each do |r|
+      puts "#{r[:title]}"
+      puts "  #{r[:url]}"
+      puts "  #{r[:content]}"
+      puts ""
+    end
+    puts "No results found" if (data[:results].nil? || data[:results].empty?) && (data[:infoboxes].nil? || data[:infoboxes].empty?)
+  end
+else
+  warn "Usage: searxng (search|serve) ..."
+  warn "  search QUERY  - Run a search and print results"
+  warn "  serve        - Start MCP server (stdio)"
+  exit 1
+end

data/lib/searxng/client.rb

@@ -0,0 +1,142 @@
+require "uri"
+require "net/http"
+require "openssl"
+require "json"
+
+module Searxng
+  class Client
+    DEFAULT_BASE_URL = "http://localhost:8080"
+    DEFAULT_USER_AGENT = "searxng-ruby/#{Searxng::VERSION} (https://github.com/amkisko/searxng.rb)".freeze
+    VALID_TIME_RANGES = %w[day month year].freeze
+    VALID_SAFESEARCH = [0, 1, 2].freeze
+
+    def initialize(
+      base_url: nil,
+      user: nil,
+      password: nil,
+      open_timeout: 10,
+      read_timeout: 10,
+      ca_file: nil,
+      ca_path: nil,
+      verify_mode: nil,
+      user_agent: nil,
+      configure_http: nil
+    )
+      @base_url = (base_url || ENV["SEARXNG_URL"] || DEFAULT_BASE_URL).to_s.chomp("/")
+      @user = user || ENV["SEARXNG_USER"]
+      @password = password || ENV["SEARXNG_PASSWORD"]
+      @open_timeout = open_timeout
+      @read_timeout = read_timeout
+      @ca_file = ca_file || ENV["SEARXNG_CA_FILE"]
+      @ca_path = ca_path || ENV["SEARXNG_CA_PATH"]
+      @verify_mode = verify_mode
+      @user_agent = user_agent || ENV["SEARXNG_USER_AGENT"] || DEFAULT_USER_AGENT
+      @configure_http = configure_http
+    end
+
+    def search(query, pageno: 1, time_range: nil, language: "all", safesearch: nil)
+      raise ConfigurationError, "SEARXNG_URL not set" if @base_url.nil? || @base_url.empty?
+
+      uri = build_search_uri(query, pageno: pageno, time_range: time_range, language: language, safesearch: safesearch)
+      response = perform_request(uri)
+      parse_response(response, uri, query)
+    end
+
+    private
+
+    def build_search_uri(query, pageno:, time_range:, language:, safesearch:)
+      uri = URI.join("#{@base_url}/", "search")
+      params = {"q" => query, "format" => "json", "pageno" => pageno.to_s}
+      params["time_range"] = time_range if time_range && VALID_TIME_RANGES.include?(time_range.to_s)
+      params["language"] = language if language && language != "all"
+      params["safesearch"] = safesearch.to_s if safesearch && VALID_SAFESEARCH.include?(safesearch.to_i)
+      uri.query = URI.encode_www_form(params)
+      uri
+    end
+
+    def perform_request(uri)
+      http = build_http(uri)
+      @configure_http&.call(http, uri)
+
+      request = Net::HTTP::Get.new(uri)
+      request["Accept"] = "application/json"
+      request["User-Agent"] = @user_agent
+      request.basic_auth(@user, @password) if @user && @password
+
+      http.request(request)
+    rescue SocketError, Errno::ECONNREFUSED, Errno::ETIMEDOUT, Errno::ECONNRESET, Errno::EPIPE, Timeout::Error, OpenSSL::SSL::SSLError, EOFError => e
+      raise NetworkError, "Connection failed: #{e.message}"
+    end
+
+    # Builds and returns a configured Net::HTTP instance. Override in a subclass to customize
+    # timeouts, SSL, proxy, or other options. Called once per request.
+    def build_http(uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == "https")
+      http.open_timeout = @open_timeout
+      http.read_timeout = @read_timeout
+      apply_ssl_config(http) if http.use_ssl?
+      http
+    end
+
+    def apply_ssl_config(http)
+      http.verify_mode = @verify_mode || OpenSSL::SSL::VERIFY_PEER
+      default_ca = OpenSSL::X509::DEFAULT_CERT_FILE
+      http.ca_file = @ca_file if @ca_file && File.exist?(@ca_file)
+      http.ca_file = default_ca if !http.ca_file && File.exist?(default_ca)
+      http.ca_path = @ca_path if @ca_path && File.directory?(@ca_path)
+    end
+
+    def parse_response(response, uri, query)
+      case response
+      when Net::HTTPSuccess
+        body = response.body
+        data = JSON.parse(body)
+        {
+          query: data["query"] || query,
+          number_of_results: data["number_of_results"],
+          results: normalize_results(data["results"] || []),
+          infoboxes: normalize_infoboxes(data["infoboxes"] || []),
+          suggestions: data["suggestions"] || [],
+          answers: data["answers"] || [],
+          corrections: data["corrections"] || []
+        }
+      else
+        raise APIError.new(
+          "SearXNG returned #{response.code} #{response.message}",
+          status_code: response.code.to_i,
+          response_data: response.body,
+          uri: uri.to_s
+        )
+      end
+    rescue JSON::ParserError => e
+      raise APIError.new(
+        "Invalid JSON response: #{e.message}",
+        response_data: response&.body,
+        uri: uri.to_s
+      )
+    end
+
+    def normalize_results(results)
+      Array(results).map do |r|
+        {
+          title: r["title"].to_s,
+          url: r["url"].to_s,
+          content: r["content"].to_s,
+          score: (r["score"] || 0).to_f
+        }
+      end
+    end
+
+    def normalize_infoboxes(infoboxes)
+      Array(infoboxes).map do |ib|
+        {
+          infobox: ib["infobox"].to_s,
+          id: ib["id"].to_s,
+          content: ib["content"].to_s,
+          urls: Array(ib["urls"]).map { |u| {title: u["title"].to_s, url: u["url"].to_s} }
+        }
+      end
+    end
+  end
+end

data/lib/searxng/errors.rb

@@ -0,0 +1,18 @@
+module Searxng
+  class Error < StandardError; end
+
+  class ConfigurationError < Error; end
+
+  class NetworkError < Error; end
+
+  class APIError < Error
+    attr_reader :status_code, :response_data, :uri
+
+    def initialize(message, status_code: nil, response_data: nil, uri: nil)
+      super(message)
+      @status_code = status_code
+      @response_data = response_data
+      @uri = uri
+    end
+  end
+end

data/lib/searxng/server.rb

@@ -0,0 +1,131 @@
+require "fast_mcp"
+require "searxng"
+
+FastMcp = MCP unless defined?(FastMcp)
+
+module Searxng
+  class Server
+    class NullLogger
+      attr_accessor :transport, :client_initialized
+
+      def initialize
+        @transport = nil
+        @client_initialized = false
+        @level = nil
+      end
+
+      attr_writer :level
+      attr_reader :level
+
+      def debug(*)
+      end
+
+      def info(*)
+      end
+
+      def warn(*)
+      end
+
+      def error(*)
+      end
+
+      def fatal(*)
+      end
+
+      def unknown(*)
+      end
+
+      def client_initialized?
+        @client_initialized
+      end
+
+      def set_client_initialized(value = true)
+        @client_initialized = value
+      end
+
+      def stdio_transport?
+        @transport == :stdio
+      end
+
+      def rack_transport?
+        @transport == :rack
+      end
+    end
+
+    def self.start
+      server = FastMcp::Server.new(
+        name: "searxng",
+        version: Searxng::VERSION,
+        logger: NullLogger.new
+      )
+      server.register_tool(SearxngWebSearchTool)
+      server.start
+    end
+
+    class BaseTool < FastMcp::Tool
+      protected
+
+      def get_client
+        Client.new
+      end
+    end
+
+    class SearxngWebSearchTool < BaseTool
+      tool_name "searxng_web_search"
+      description "Performs a web search using the SearXNG API. Use this to find information on the web. Aggregates results from multiple search engines."
+
+      arguments do
+        required(:query).filled(:string).description("The search query")
+        optional(:pageno).filled(:integer).description("Search page number (default: 1)")
+        optional(:max_results).filled(:integer).description("Max number of results to return in the response (default: 10). Use pageno for more.")
+        optional(:time_range).filled(:string).description("Time range: day, month, or year")
+        optional(:language).filled(:string).description("Language code (e.g. en, fr). Default: all")
+        optional(:safesearch).filled(:integer).description("Safe search: 0=none, 1=moderate, 2=strict")
+      end
+
+      def call(query:, pageno: 1, max_results: 10, time_range: nil, language: "all", safesearch: nil)
+        data = get_client.search(
+          query,
+          pageno: pageno,
+          time_range: time_range,
+          language: language,
+          safesearch: safesearch
+        )
+        format_search_result(data, max_results: max_results, pageno: pageno)
+      end
+
+      private
+
+      def format_search_result(data, max_results: 10, pageno: 1)
+        out = []
+        data[:infoboxes]&.each do |ib|
+          out << "Infobox: #{ib[:infobox]}"
+          out << "ID: #{ib[:id]}"
+          out << "Content: #{ib[:content]}"
+          out << ""
+        end
+        results = data[:results] || []
+        total = data[:number_of_results]
+        if results.empty?
+          out << "No results found"
+        else
+          limit = [max_results.to_i, 1].max
+          shown = results.first(limit)
+          shown.each do |r|
+            out << "Title: #{r[:title]}"
+            out << "URL: #{r[:url]}"
+            out << "Content: #{r[:content]}"
+            out << "Score: #{r[:score]}"
+            out << ""
+          end
+          if results.size > limit
+            out << "Showing #{limit} of #{results.size} on this page. Use pageno=#{pageno + 1} for more."
+          elsif total && total > results.size
+            out << "Showing #{shown.size} results (page #{pageno}). #{total} total. Use pageno=#{pageno + 1} for more."
+          end
+        end
+        out.join("\n").strip
+      end
+    end
+  end
+end

data/lib/searxng/version.rb

@@ -0,0 +1,3 @@
+module Searxng
+  VERSION = "0.1.0"
+end

data/lib/searxng.rb

@@ -0,0 +1,6 @@
+require_relative "searxng/version"
+require_relative "searxng/errors"
+require_relative "searxng/client"
+
+module Searxng
+end

data/sig/searxng.rbs

@@ -0,0 +1,36 @@
+module Searxng
+  VERSION: String
+
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class NetworkError < Error; end
+
+  class APIError < Error
+    def initialize: (String message, ?status_code: Integer?, ?response_data: String?, ?uri: String?) -> void
+    attr_reader status_code: Integer?
+    attr_reader response_data: String?
+    attr_reader uri: String?
+  end
+
+  class Client
+    def initialize: (
+      ?base_url: String?,
+      ?user: String?,
+      ?password: String?,
+      ?open_timeout: Integer,
+      ?read_timeout: Integer,
+      ?ca_file: String?,
+      ?ca_path: String?,
+      ?verify_mode: Integer?,
+      ?user_agent: String?,
+      ?configure_http: (Net::HTTP, URI::Generic) -> void
+    ) -> void
+    def search: (
+      String query,
+      ?pageno: Integer,
+      ?time_range: String?,
+      ?language: String,
+      ?safesearch: Integer?
+    ) -> Hash[Symbol, untyped]
+  end
+end

metadata

@@ -0,0 +1,329 @@
+--- !ruby/object:Gem::Specification
+name: searxng
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andrei Makarov
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fast-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.26'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.26'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.3'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: rspec_junit_formatter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: simplecov-cobertura
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.52'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.52'
+- !ruby/object:Gem::Dependency
+  name: standard-custom
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: standard-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: standard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+- !ruby/object:Gem::Dependency
+  name: rubocop-thread_safety
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: memory_profiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+description: Ruby gem providing a SearXNG HTTP client, CLI (search), and MCP server
+  for web search. Integrates with Cursor IDE via Model Context Protocol.
+email:
+- andrei@kiskolabs.com
+executables:
+- searxng
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/searxng
+- lib/searxng.rb
+- lib/searxng/client.rb
+- lib/searxng/errors.rb
+- lib/searxng/server.rb
+- lib/searxng/version.rb
+- sig/searxng.rbs
+homepage: https://github.com/amkisko/searxng.rb
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/amkisko/searxng.rb
+  changelog_uri: https://github.com/amkisko/searxng.rb/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/amkisko/searxng.rb/issues
+  documentation_uri: https://github.com/amkisko/searxng.rb#readme
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: SearXNG Ruby client and MCP server
+test_files: []