searchlink 2.3.93 → 2.3.94

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26563c3d6842264d4ee543dbac0cd7be148658c13b2020cc09009e94c1d9d8a0
-  data.tar.gz: 49c8165891b3f5713b2aada1db49bae241d7f9c41f92fe24f14af03e68930364
+  metadata.gz: db8c6a0ca4005dab57850ac6073c79ccb8af7a716dc2abbdca7c28e56236152d
+  data.tar.gz: 3dac8559336062734a5d207dae3478f6075198d3f2547b2500c3b511b038bce2
 SHA512:
-  metadata.gz: 45b47101b11cb81b5b0ca2b74a5370a396cc7a1a95d0d27650498bf9cce8de590cbb855d8f9c9601aa75cffcb1911b23c44de53478b9797c4adc24356dd520cf
-  data.tar.gz: 8c2b3f6db03a379899ac14cc9ec21134e46f322f31080843c425a06f234cb245f6e1ccef1ead6100c71a795a9a4656845c6eb0ca4855c3a3fb29d8c02d3dc7ab
+  metadata.gz: f8c8eaac79f1fa31bc44489911fe432575c435bf801c528fea7b19afa72bba273fac0f5469bc552eee38f17353bdc2a732a95a60821c61aa12b999e04ab41e7b
+  data.tar.gz: ecc834af5225f72159ff21dd68d03f598ff611dd1f43b98006481e5b2157cf08376d020074c7e281c2f6bd6663f6d231cef068f512ac9830df34760d291e1bf2

data/lib/searchlink/searches/keenable.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module SL
+  # Keenable web search
+  class KeenableSearch
+    class << self
+      # Returns the settings hash for the KeenableSearch plugin.
+      #
+      # @return [Hash] settings including trigger, searches, and config entries
+      #
+      def settings
+        {
+          trigger: "kn",
+          searches: [
+            ["kn", "Keenable Search"]
+          ],
+          config: [
+            {
+              key: "keenable_api_key",
+              value: "xxxxxx",
+              required: false,
+              description: "Keenable API key for web search (see https://keenable.ai)"
+            }
+          ]
+        }
+      end
+
+      # Returns true if a usable Keenable API key is configured.
+      #
+      # @return [Boolean] true when a non-placeholder API key is present
+      #
+      def api_key?
+        return false unless SL.config.key?("keenable_api_key") && SL.config["keenable_api_key"]
+
+        key = SL.config["keenable_api_key"].to_s.strip
+        return false if key.empty? || key =~ /^(x{4,})?$/i
+
+        @api_key = key
+
+        true
+      end
+
+      # Perform a Keenable web search and return the first result.
+      #
+      # @param _search_type [String] the search shortcut ("kn")
+      # @param search_terms [String] the terms to search for
+      # @param link_text [String] the text to display for the link
+      #
+      # @return [Array] [url, title, link_text] or DuckDuckGo fallback
+      #
+      def search(_search_type, search_terms, link_text)
+        unless api_key?
+          SL.notify("Keenable not configured", "Missing Keenable API key, defaulting to DuckDuckGo")
+          return SL.ddg(search_terms, link_text, google: false)
+        end
+
+        headers = {
+          "X-API-Key" => @api_key,
+          "X-Keenable-Title" => "SearchLink",
+          "Content-Type" => "application/json"
+        }
+        # Curl::Json passes the body inside single quotes; escape them as JSON.
+        body = { query: search_terms.gsub("%22", '"'), max_results: 1 }.to_json.gsub("'", "\\u0027")
+
+        res = Curl::Json.new("https://api.keenable.ai/v1/search", data: body, headers: headers, symbolize_names: true)
+        return SL.ddg(search_terms, link_text, google: false) unless res && res.code.to_i == 200 && res.json
+
+        results = res.json[:results]
+        first = results.is_a?(Array) ? results.find { |r| r.is_a?(Hash) && r[:url] } : nil
+        return SL.ddg(search_terms, link_text, google: false) unless first
+
+        output_url = first[:url]
+        output_title = first[:title] || link_text
+
+        if defined?(SL.config) && SL.config.respond_to?(:[]) && output_title && SL.config["remove_seo"]
+          output_title.remove_seo!(output_url)
+        end
+
+        [output_url, output_title, link_text]
+      rescue StandardError => e
+        SL.notify("Keenable error", "Error fetching Keenable results, switching to DuckDuckGo")
+        SL.add_error("Keenable error", e.message)
+        SL.ddg(search_terms, link_text, google: false)
+      end
+    end
+
+    SL::Searches.register "keenable", :search, self
+  end
+end

data/lib/searchlink/searches.rb

@@ -205,6 +205,9 @@ require_relative "searches/github"
 # import
 require_relative "searches/kagi"
 
+# import
+require_relative "searches/keenable"
+
 # import
 require_relative "searches/google"
 

data/lib/searchlink/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module SL
-  VERSION = '2.3.93'
+  VERSION = '2.3.94'
 end
 
 # Main module

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: searchlink
 version: !ruby/object:Gem::Version
-  version: 2.3.93
+  version: 2.3.94
 platform: ruby
 authors:
 - Brett Terpstra
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-02 00:00:00.000000000 Z
+date: 2026-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -302,6 +302,7 @@ files:
 - lib/searchlink/searches/hook.rb
 - lib/searchlink/searches/itunes.rb
 - lib/searchlink/searches/kagi.rb
+- lib/searchlink/searches/keenable.rb
 - lib/searchlink/searches/lastfm.rb
 - lib/searchlink/searches/linkding.rb
 - lib/searchlink/searches/lyrics.rb