docs: document CirrusSearch query syntax in search help and README

Author: teal-bauer

README.md

@@ -81,6 +81,35 @@ wikitool search "mars" --output json
 | `-l, --lang` | Wikipedia language code (default: `en`) |
 | `-o, --output` | Output format: `text`, `json`, `html` (default: `text`) |
 
+## Search Syntax
+
+Wikipedia uses CirrusSearch (Elasticsearch-based), which supports advanced query syntax:
+
+| Syntax | Example | Description |
+|--------|---------|-------------|
+| `"phrase"` | `"theory of relativity"` | Exact phrase match |
+| `intitle:` | `intitle:einstein` | Search only in page titles |
+| `incategory:` | `incategory:"Nobel laureates"` | Filter by category |
+| `*` | `einst*` | Wildcard prefix matching |
+| `~` | `quantim~` | Explicit fuzzy match (typo-tolerant by default) |
+| `-` | `einstein -albert` | Exclude term from results |
+| `OR` | `einstein OR feynman` | Boolean OR |
+| `hastemplate:` | `hastemplate:Infobox` | Pages using a specific template |
+
+```bash
+# Phrase search
+wikitool search '"theory of relativity"'
+
+# Title-only search
+wikitool search "intitle:einstein"
+
+# Exclude terms
+wikitool search "physics -quantum"
+
+# Category filter
+wikitool search 'incategory:"Physics" waves'
+```
+
 ## License
 
 GPL-3.0 - see [LICENSE](LICENSE)

cmd/search.go

@@ -20,10 +20,23 @@ var searchCmd = &cobra.Command{
 
 By default, searches page content. Use --title for title autocomplete.
 
+The search supports CirrusSearch query syntax:
+  "exact phrase"     Exact phrase match
+  intitle:word       Search only in titles
+  incategory:"Name"  Filter by category
+  prefix*            Wildcard prefix matching
+  word~              Fuzzy matching (typo-tolerant by default)
+  -exclude           Exclude term from results
+  word1 OR word2     Boolean OR
+  hastemplate:Name   Pages using a specific template
+
 Examples:
   wikitool search "solar system"
   wikitool search "quantum" --limit 20
-  wikitool search "einst" --title --lang de`,
+  wikitool search "einst" --title --lang de
+  wikitool search "intitle:einstein"
+  wikitool search "physics -quantum"
+  wikitool search '"theory of relativity"'`,
 	Args: cobra.ExactArgs(1),
 	RunE: runSearch,
 }