Class: Clacky::Tools::WebSearch

Inherits:
Base
  • Object
show all
Defined in:
lib/clacky/tools/web_search.rb

Constant Summary collapse

PROVIDERS =

Ordered list of search providers to try in sequence. cn.bing.com is accessible in mainland China without VPN.

%i[duckduckgo bing].freeze
USER_AGENTS =

── Shared HTTP helper ─────────────────────────────────────────────────

[
  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
  "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
].freeze

Instance Method Summary collapse

Methods inherited from Base

#category, #description, #name, #parameters, #to_function_definition

Instance Method Details

#execute(query:, max_results: 10, working_dir: nil) ⇒ Object 



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/clacky/tools/web_search.rb', line 36

def execute(query:, max_results: 10, working_dir: nil)
  if query.nil? || query.strip.empty?
    return { error: "Query cannot be empty" }
  end

  last_error = nil

  providers = active_providers
  providers.each do |provider|
    begin
      results = send(:"search_#{provider}", query, max_results)
      # Consider it a success only if we got real results
      next if results.empty? || results.first[:url].include?("duckduckgo.com") && results.first[:title] == "Web search results"

      return {
        query: query,
        results: results,
        count: results.length,
        provider: provider.to_s,
        error: nil
      }
    rescue StandardError => e
      # DuckDuckGo failed — suppress it for 10 minutes
      @ddg_unavailable_until = Time.now + 600 if provider == :duckduckgo
      last_error = e
      next
    end
  end

  # All providers failed
  {
    query: query,
    results: [],
    count: 0,
    provider: nil,
    error: "All search providers failed. Last error: #{last_error&.message}"
  }
end

#format_call(args) ⇒ Object

── Formatting ─────────────────────────────────────────────────────────



231
232
233
234
235
 
# File 'lib/clacky/tools/web_search.rb', line 231

def format_call(args)
  query = args[:query] || args["query"] || ""
  display_query = query.length > 40 ? "#{query[0..37]}..." : query
  "web_search(\"#{display_query}\")"
end

#format_result(result) ⇒ Object 



237
238
239
240
241
242
243
244
245
 
# File 'lib/clacky/tools/web_search.rb', line 237

def format_result(result)
  if result[:error]
    "[Error] #{result[:error]}"
  else
    count = result[:count] || 0
    provider = result[:provider] ? " via #{result[:provider]}" : ""
    "[OK] Found #{count} results#{provider}"
  end
end