🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Easy Search
πŸ¦€ ClawHub

Easy Search

by @hkall

Simple web search using multiple search engines with no API key required. Supports Google, Bing, DuckDuckGo, Baidu, Sogou, 360, Brave, Yandex. Features time...

Versionv1.0.1
Downloads1,116
#crypto-defi#api#seo#legal
TERMINAL
clawhub install easy-search

πŸ“– About This Skill

name: "easy-search" description: "Simple web search using multiple search engines with no API key required. Supports Google, Bing, DuckDuckGo, Baidu, Sogou, 360, Brave, Yandex. Features time filtering, interactive mode, snippet extraction, and network diagnostics."

Easy Search Skill

A powerful web search skill that doesn't require API keys. It uses direct HTTP requests and the duckduckgo_search library for reliable results.

Features

  • No API key required - Uses public search interfaces
  • 9 search engines - Google, Bing, DuckDuckGo, Baidu, Sogou, 360, Brave, Yandex, Startpage
  • Auto engine selection - Automatically picks the best available engine
  • Snippet extraction - Get result previews, not just titles
  • Time filtering - Filter by day/week/month/year
  • Interactive mode - Continuous searching with live engine switching
  • Network diagnostics - Built-in connectivity checking and proxy hints
  • Proxy support - Respects ALL_PROXY, HTTPS_PROXY environment variables
  • Result caching - Faster repeated searches
  • Smart failover - Auto-switches to backup engines on failure

    • Requirements

  • Python 3.6+
  • Optional: pip install duckduckgo-search requests for better results

    • Commands

    Basic Search

    # Simple search (positional argument)
python3 {baseDir}/scripts/search.py Python tutorial
    With flag
    
python3 {baseDir}/scripts/search.py --query "your search terms"
    Specify engine
    
python3 {baseDir}/scripts/search.py "AI news" --engine bing
    More results
    
python3 {baseDir}/scripts/search.py "React hooks" --results 10
    JSON output (default)
    
python3 {baseDir}/scripts/search.py "Vue.js" --format json
    Markdown output
    
python3 {baseDir}/scripts/search.py "machine learning" --format md
    Simple output (quick reading)
    
python3 {baseDir}/scripts/search.py "Docker" --format simple
    CSV output
    
python3 {baseDir}/scripts/search.py "Kubernetes" --format csv

    Time Filtering

    # News from last 24 hours
python3 {baseDir}/scripts/search.py "AI news" --time day
    Results from last week
    
python3 {baseDir}/scripts/search.py "React 19" --time week
    Results from last month
    
python3 {baseDir}/scripts/search.py "Python 3.13" --time month
    Results from last year
    
python3 {baseDir}/scripts/search.py "best laptops 2024" --time year

    Interactive Mode

    # Start interactive mode
python3 {baseDir}/scripts/search.py --interactive
    In interactive mode:
    

    [auto]> Python tutorial          # Search with auto engine
    

    [auto]> :engine duckduckgo       # Change engine
    

    [duckduckgo]> React hooks        # Search with new engine
    

    [duckduckgo]> :format simple     # Change output format
    

    [duckduckgo]> :check             # Check engine health
    

    [duckduckgo]> :quit              # Exit

    Network Diagnostics

    # Run network diagnostics
python3 {baseDir}/scripts/search.py --diagnose
    Check which engines are available
    
python3 {baseDir}/scripts/search.py --check-engines

    Engine Management

    # Clear cache
python3 {baseDir}/scripts/search.py --clear-cache
    Disable auto-fallback (stay on specified engine)
    
python3 {baseDir}/scripts/search.py "query" --engine google --no-fallback

    Search Engines

    | Engine | Best For | Notes | |--------|----------|-------| | auto | General use | Auto-selects best available engine | | startpage | Privacy, global | Privacy-focused, reliable HTML parsing | | duckduckgo | Privacy, global | Preferred, uses library if installed | | bing | Global search | Good reliability, decent snippets | | google | Best results | May need proxy in some regions | | baidu | Chinese content | Strong anti-crawl measures | | sogou | Chinese content | Good alternative to Baidu | | so360 | Chinese content | Another Chinese option | | brave | Privacy-focused | Growing index | | yandex | Russian/Global | Works in some regions |

    Output Formats

    JSON

    {
  "query": "search terms",
  "engine": "bing",
  "method": "HTML scraping",
  "results": [
    {
      "title": "Result Title",
      "url": "https://example.com",
      "snippet": "Brief description..."
    }
  ],
  "total": 5
}

    Markdown

    ## Search Results: your terms
    Engine: BING
Method: _HTML scraping_
    1. Result Title
   > Brief description...
    2. Another Title
   > More info...

    Simple

    1. Result Title
   https://example.com
   Brief description...
    2. Another Title
   https://another.com
   More info...

    Examples

    # Quick search for documentation
python3 {baseDir}/scripts/search.py "Python requests library docs"
    Search Chinese content with Sogou
    
python3 {baseDir}/scripts/search.py "δΊΊε·₯ζ™Ίθƒ½ζœ€ζ–°θΏ›ε±•" --engine sogou
    Get recent news in markdown format
    
python3 {baseDir}/scripts/search.py "OpenAI news" --time day --format md
    Use interactive mode for multiple searches
    
python3 {baseDir}/scripts/search.py -i
    Search with time filter
    
python3 {baseDir}/scripts/search.py "React 19 features" --time month --results 10

    Proxy Configuration

    Set environment variables for proxy support:

    # Set proxy
export ALL_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
    Then run search
    
python3 {baseDir}/scripts/search.py "your query"

    Troubleshooting

    | Problem | Solution | |---------|----------| | Empty results | Try a different engine with --engine | | Connection timeout | Check proxy settings or use --timeout 60 | | Rate limiting | Wait between searches or switch engines | | DuckDuckGo slow | Install library: pip install duckduckgo-search | | No snippets | Some engines have limited snippet extraction | | Google blocked | Use proxy or switch to Bing/DuckDuckGo | | All engines fail | Run --diagnose to check network |

    Tips for Best Results

    1. Use auto engine - Let the tool pick the best available engine 2. Install dependencies - pip install duckduckgo-search requests for better reliability 3. Use time filters - For news and recent topics, use --time day or --time week 4. Try Chinese engines - Use sogou or so360 for Chinese content 5. Interactive mode - Great for multiple related searches 6. Cache is your friend - Repeated searches are instant (1 hour cache) 7. Run diagnostics - Use --diagnose to troubleshoot network issues

    Version History

  • v1.1.0 - Added Startpage engine with proper parsing, fixed HTML entity decoding in URLs
  • v1.0.1 - Added network diagnostics, better proxy hints, improved error messages
  • v1.0.0 - Added 4 new engines (Sogou, 360, Brave, Yandex), time filtering, interactive mode, snippet extraction, engine health caching
  • v4.0.0 - Integrated duckduckgo_search library, auto engine selection
  • v1.0.0 - Initial release with basic search

    • πŸ’‘ Examples

    # Quick search for documentation
python3 {baseDir}/scripts/search.py "Python requests library docs"
    Search Chinese content with Sogou
    
python3 {baseDir}/scripts/search.py "δΊΊε·₯ζ™Ίθƒ½ζœ€ζ–°θΏ›ε±•" --engine sogou
    Get recent news in markdown format
    
python3 {baseDir}/scripts/search.py "OpenAI news" --time day --format md
    Use interactive mode for multiple searches
    
python3 {baseDir}/scripts/search.py -i
    Search with time filter
    
python3 {baseDir}/scripts/search.py "React 19 features" --time month --results 10

    πŸ“‹ Tips & Best Practices

    | Problem | Solution | |---------|----------| | Empty results | Try a different engine with --engine | | Connection timeout | Check proxy settings or use --timeout 60 | | Rate limiting | Wait between searches or switch engines | | DuckDuckGo slow | Install library: pip install duckduckgo-search | | No snippets | Some engines have limited snippet extraction | | Google blocked | Use proxy or switch to Bing/DuckDuckGo | | All engines fail | Run --diagnose to check network |