Skip to content

Search Guide

Jump to bottom
Dragon edited this page Dec 23, 2025 · 2 revisions 
# 🔍 NaviDuck Search Guide

Master the art of searching with NaviDuck! This guide covers everything from basic searches to advanced techniques and troubleshooting.

## 📋 Table of Contents
- [Search Basics](#search-basics)
- [Search Engines](#search-engines) 
- [Advanced Search Techniques](#advanced-search-techniques)
- [Search Results Navigation](#search-results-navigation)
- [Troubleshooting](#troubleshooting)
- [Pro Tips & Tricks](#pro-tips--tricks)

---

## 🔎 Search Basics

### **The Three Search Methods**

#### 1. Quick Search (Recommended)
```bash
s <your query>

Examples:

s python tutorial
s machine learning algorithms
s latest tech news

2. Full Search Command

search <engine> <your query>

Examples:

search google python
search wikipedia artificial intelligence
search brave privacy tools

3. Direct Engine Search

google <query>      # Search Google
wikipedia <query>   # Search Wikipedia
brave <query>       # Search Brave
ddg <query>         # Search DuckDuckGo

Search Syntax Rules

Quotes for Exact Phrases

# Without quotes - searches for all words
s python web scraping
# Results: pages containing python, web, AND scraping

# With quotes - searches exact phrase
s "python web scraping"
# Results: pages containing the exact phrase "python web scraping"

Multiple Words

# All these work:
s python
s python tutorial
s python web scraping tutorial for beginners
s "advanced python decorators"

Special Characters

# Most special characters work
s python 3.11
s c++ tutorial
s python -m pip install
s what's new in python

🎯 Search Engines Deep Dive

Available Search Engines

Engine Command Best For Notes
Brave Search s or search brave General search, Privacy Default engine, no CAPTCHA
Google search google Comprehensive results May show CAPTCHA sometimes
Wikipedia search wikipedia Academic/encyclopedic Direct Wikipedia search
DuckDuckGo HTML search ddg Privacy-focused Text-based interface
DuckDuckGo API search ddg_api Quick answers Returns structured data

When to Use Each Engine

For General Browsing

# Use Brave (default) - fast and reliable
s your topic here

For Comprehensive Results

# Use Google - most comprehensive
search google your topic

For Academic Research

# Use Wikipedia - authoritative sources
search wikipedia your topic

For Privacy

# Use DuckDuckGo - privacy-focused
search ddg your topic

For Quick Answers

# Use DuckDuckGo API - structured answers
search ddg_api your question

Changing Default Engine

Temporary Change

# Specify engine for one search
search google your query

Permanent Change

# 1. Open settings
settings

# 2. Select option 1 (Change default search engine)

# 3. Choose your preferred engine

# 4. New engine will be used for all 's' commands

Manage Engine Availability

# Enable/disable engines
engines
# Then use: enable 1, disable 2, etc.

🚀 Advanced Search Techniques

Boolean Search Operators

AND (implied)

# Search for pages containing ALL terms
s python AND tutorial  # Same as: s python tutorial

OR

# Search for pages containing EITHER term
s python OR javascript tutorial

NOT (Exclude terms)

# Search for python but exclude django
s python -django
# or
s python NOT django

Parentheses for Grouping

# Complex boolean searches
s (python OR javascript) tutorial -django -flask

Site-Specific Search

# Search within specific sites
s python site:github.com
s tutorial site:medium.com
s "machine learning" site:towardsdatascience.com

File Type Search

# Search for specific file types
s python filetype:pdf
s tutorial filetype:ppt OR filetype:pptx
s "research paper" filetype:pdf

Date Range Search

# Recent content
s python 2024
s "machine learning" 2023..2024

# Historical content
s python 2020..2022

Title/URL Search

# Search in page titles
s intitle:python tutorial
s allintitle:python web scraping

# Search in URLs
s inurl:python
s inurl:tutorial python

Wildcard Search

# Search for variations
s python * tutorial  # python advanced tutorial, python basic tutorial, etc.
s how to * python    # how to learn python, how to install python, etc.

Exact Match Search

# Force exact match (even more strict than quotes)
s "exact phrase here"

📊 Search Results Mastery

Understanding Results Layout

When you search, you'll see:

1. 🔍 Result Title - example.com
     https://example.com/page
     Short description or snippet from the page
     ──────────────────────────────────────────
2. 🔍 Another Result - anotherexample.com
     https://anotherexample.com/page
     Another description

Result Actions

From search results, you can:

Action Command Description
Open in NaviDuck Type 1-10 View page content in terminal
Open in Browser Type o1-o10 Open in your default browser
Bookmark First Type b Bookmark the first result
Return Press Enter Go back to search

Quick Actions Examples

# After search results appear:

3          # Opens 3rd result in NaviDuck
o2         # Opens 2nd result in browser
b          # Bookmarks the first result
(Enter)    # Returns to search prompt

Results Filtering Tips

By Domain

# Prefer certain domains
s python site:docs.python.org OR site:realpython.com

By Content Type

# Tutorials
s python tutorial OR guide OR "how to"

# Documentation
s python documentation OR docs OR reference

# Examples/Code
s python example OR sample OR demo

By Language

# English only (most results are English by default)
s python lang:en

# Other languages (when available)
s python lang:es     # Spanish
s python lang:fr     # French

🔧 Search Customization

Custom Search Aliases

Create shortcuts for frequent searches:

# You could create a script or alias for:
alias searchpy="s python"
alias searchml="s machine learning"
alias searchnews="s latest news"

Search Presets

Common search patterns you can reuse:

Academic Research

# Pattern
s "your topic" research OR paper OR study OR journal

# Example
s "machine learning" research paper journal

Tutorial Search

# Pattern
s "your topic" tutorial OR guide OR "step by step" OR beginners

# Example
s python tutorial beginners "step by step"

Problem Solving

# Pattern
s "your problem" solution OR fix OR error OR troubleshooting

# Example
s "python import error" fix solution troubleshooting

Search History Features

Review Past Searches

# View search history
history

Repeat Previous Search

# From history list, type the number
# Example: if search #3 was "python tutorial", type 3

Search Within History

# Use grep or filter in your terminal if supported
history | grep python

🎯 Search Strategies by Use Case

For Developers

Code Search

# Find code examples
s python code example "how to"
s "function example" python
s github python project

Documentation Search

# Official docs
s python documentation site:python.org
s "module name" docs

# Stack Overflow
s "your error" site:stackoverflow.com

Library/Framework Search

s python library for data visualization
s django vs flask comparison
s "best python web framework 2024"

For Students & Researchers

Academic Search

s "research paper" "your topic"
s "academic journal" topic
s "literature review" topic

Learning Resources

s "online course" topic
s "textbook" topic
s "lecture notes" topic

Citation Search

s "author name" "paper title"
s DOI:xxxxxxxxxx

For Everyday Use

News & Current Events

s news today
s "breaking news" topic
s "latest update" topic

Shopping & Reviews

s "product name" review
s "best" product type 2024
s "price comparison" product

Travel & Local

s "restaurants near me"
s "weather" location
s "travel guide" destination

For Content Creators

Inspiration & Research

s "content ideas" topic
s "trending topics" category
s "what people are searching for" topic

SEO Research

s "keywords" topic
s "search volume" keyword
s "competitor analysis" topic

🚨 Troubleshooting Search Issues

Common Problems & Solutions

Problem: "No results found"

Solutions:

# 1. Broaden your search
s python        # Instead of s python advanced specific feature

# 2. Try different engine
search google your query
search wikipedia your topic

# 3. Check spelling
s "corect spellng"  # Might fail
s "correct spelling"  # Better

# 4. Use simpler terms
s learn python  # Instead of s python educational resources tutorial

Problem: "Too many irrelevant results"

Solutions:

# 1. Use more specific terms
s "python web scraping beautifulsoup"  # Instead of s python web

# 2. Use quotes for exact phrases
s "machine learning algorithms"  # Instead of s machine learning algorithms

# 3. Exclude unwanted terms
s python -django -flask  # Only python, exclude django and flask

# 4. Site-specific search
s python site:realpython.com  # Only from trusted site

Problem: "Search is slow"

Solutions:

# 1. Try different engine
search brave your query  # Usually faster

# 2. Use simpler query
s python  # Instead of s python with many modifiers

# 3. Check your connection
# Try pinging a website to test internet

# 4. Restart NaviDuck
quit
python naviduck.py

Problem: "CAPTCHA detected"

Solutions:

# NaviDuck automatically switches engines when CAPTCHA detected
# If it persists:

# 1. Use Brave search (default, avoids CAPTCHA)
s your query

# 2. Wait a few minutes and try again

# 3. Use Wikipedia or DuckDuckGo
search wikipedia your topic
search ddg your query

Engine-Specific Issues

Google Search Issues

# If Google shows CAPTCHA:
search brave your query    # Switch to Brave
search ddg your query      # Or DuckDuckGo

Wikipedia Search Issues

# If Wikipedia returns no results:
# 1. Check if article exists
search wikipedia "Exact Article Name"

# 2. Try broader topic
search wikipedia "General Topic"  # Instead of specific subtopic

# 3. Use regular search
s "your topic" wikipedia

Brave Search Issues

# If Brave has limited results:
search google your query    # More comprehensive
search ddg your query       # Alternative privacy option

⚡ Pro Tips & Tricks

Speed Search Techniques

Use Short Queries

# Instead of:
s how to learn python programming language for beginners tutorial

# Use:
s python tutorial beginners

Chain Searches

# Quick research flow
s python && ai explain python

Bookmark Common Searches

# After search, bookmark useful result pages
# Then access quickly via bookmarks menu

Search Optimization

Time Your Searches

  • Morning: Best for news and updates
  • Afternoon: Good for research and learning
  • Evening: Better for entertainment/leisure topics

Use Regional Settings

# Some engines support region-specific results
# Check settings for regional options

Leverage Search History

# Review what worked before
history

# Repeat successful searches
# Click number from history list

Advanced Power User Tips

Create Search Macros

# In your shell profile (bashrc, zshrc, etc.):
alias pysearch="s python"
alias mlsearch="s machine learning"
alias gsearch="search google"

Integrate with Other Tools

# Pipe search results to other commands
# (Advanced users can extend NaviDuck functionality)

Custom Search Scripts

# Create Python scripts that use NaviDuck search programmatically
# Check API documentation for integration options

📱 Mobile & Touch Search Tips

Touch-Friendly Commands

# Shorter commands are easier to type
s <query>      # Instead of search

Voice Search Integration

# Use device voice-to-text for:
"search python tutorial"
"ai what is machine learning"
"go wikipedia.org"

Mobile-Optimized Queries

# Keep queries short
s python        # Good
s learn python fast  # Better
s comprehensive guide to python programming for absolute beginners  # Too long

🔄 Search Comparison Table

Search Type Best Engine Command Example Use When...
Quick Lookup Brave s python Need fast answer
Deep Research Google search google topic Comprehensive results needed
Academic Wikipedia search wikipedia topic Authoritative sources needed
Privacy DuckDuckGo search ddg topic Privacy is priority
Structured Data DDG API search ddg_api query Need facts/answers
Avoid CAPTCHA Brave s topic Other engines show CAPTCHA

🎓 Search Proficiency Levels

Level 1: Beginner

  • ✅ Basic s command
  • ✅ Simple queries
  • ✅ Opening results

Level 2: Intermediate

  • ✅ Multiple search engines
  • ✅ Boolean operators (AND, OR, NOT)
  • ✅ Quotes for exact phrases
  • ✅ Site-specific searches

Level 3: Advanced

  • ✅ All boolean operators
  • ✅ File type searches
  • ✅ Date range filters
  • ✅ Wildcard searches
  • ✅ Result filtering strategies

Level 4: Expert

  • ✅ Complex nested searches
  • ✅ Search automation
  • ✅ Integration with other tools
  • ✅ Teaching others search techniques

📚 Related Resources

💡 Final Search Wisdom

  1. Start simple - Use basic s command first
  2. Refine gradually - Add operators as needed
  3. Try different engines - Each has strengths
  4. Learn from results - See what wording works
  5. Bookmark successes - Save good searches and results

Golden Rule of Searching

"The best search query is the simplest one that returns what you need."

❓ Search FAQ

Q: Why does NaviDuck sometimes switch engines automatically? A: To avoid CAPTCHAs. If one engine shows CAPTCHA, NaviDuck switches to another.

Q: Can I add my own search engine? A: Currently through code modification. Future versions may support plugins.

Q: How many results does NaviDuck show? A: Typically 10 results per search for speed and clarity.

Q: Can I save my favorite searches? A: Yes! Bookmark result pages or note successful search queries.

Q: Is there a way to search multiple engines at once? A: Not currently, but you can quickly try different engines with search <engine>.

"Good search skills are a superpower in the information age. Master them with NaviDuck!"

# Try a new search technique now:
s "python" -django -flask site:github.com
# or
search wikipedia "artificial intelligence history"

Happy searching! 🔍🦆

Last updated: 12/22/2025
Search Guide version: 2.2


This comprehensive Search Guide covers:
1. All search methods and syntax
2. Engine comparisons and use cases
3. Advanced search techniques
4. Use-case specific strategies
5. Troubleshooting common issues
6. Pro tips and best practices

Perfect for users who want to become search power users with NaviDuck!

Clone this wiki locally