nimble-web-searchReal-time web intelligence powered by Nimble Search API. Perform intelligent web searches with 8 specialized focus modes (general, coding, news, academic, shopping, social, geo, location). This skill provides real-time search results when you need to search the web, find current information, discover URLs, research topics, or gather up-to-date data. Use when: searching for information, finding recent news, looking up academic papers, searching for coding examples, finding shopping results, discovering social media posts, researching topics, or getting latest real-time data.
Install via ClawdBot CLI:
clawdbot install ilchemla/nimble-web-searchReal-time web intelligence using Nimble Search API with specialized focus modes and AI-powered result synthesis.
Nimble API Key Required - Get your key at https://www.nimbleway.com/
Set the NIMBLE_API_KEY environment variable using your platform's method:
Claude Code:
// ~/.claude/settings.json
{
"env": {
"NIMBLE_API_KEY": "your-api-key-here"
}
}VS Code/GitHub Copilot:
.github/skills/ directory in your repositoryShell/Terminal:
export NIMBLE_API_KEY="your-api-key-here"Any Platform:
The skill checks for the NIMBLE_API_KEY environment variable regardless of how you set it.
IMPORTANT: Before making any search request, verify the API key is configured:
# Check if API key is set
if [ -z "$NIMBLE_API_KEY" ]; then
echo "❌ Error: NIMBLE_API_KEY not configured"
echo ""
echo "Get your API key: https://www.nimbleway.com/"
echo ""
echo "Configure using your platform's method:"
echo "- Claude Code: Add to ~/.claude/settings.json"
echo "- GitHub Copilot: Use GitHub Actions secrets"
echo "- Shell: export NIMBLE_API_KEY=\"your-key\""
echo ""
echo "Do NOT fall back to other search tools - guide the user to configure first."
exit 1
fiNimble Search provides real-time web intelligence with 8 specialized focus modes optimized for different types of queries. Get instant access to current web data with AI-powered answer generation, deep content extraction, URL discovery, and smart filtering by domain and date.
IMPORTANT: Always Specify These Parameters
When using this skill, always explicitly set the following parameters in your requests:
deep_search: Default to false for 5-10x faster responsesfalse (FAST MODE - 1-3 seconds): For 95% of use cases - URL discovery, research, comparisons, answer generationtrue (DEEP MODE - 5-15 seconds): Only when you specifically need full page content extracted for archiving or detailed analysisfocus: Default to "general" for broad searchescoding, news, academic, shopping, social, geo, location) for targeted resultsmax_results: Default to 10 - Balanced speed and coveragePerformance Awareness: By explicitly setting deep_search: false, you're choosing fast mode and should expect results in 1-3 seconds. If you set deep_search: true, expect 5-15 seconds response time.
Use the wrapper script for the simplest experience:
# ALWAYS specify deep_search explicitly
./scripts/search.sh '{
"query": "React hooks",
"deep_search": false
}'The script automatically handles authentication, tracking headers, and output formatting.
Use deep_search: false (FAST MODE - 1-3 seconds) - Default for 95% of cases:
Use deep_search: true (DEEP MODE - 5-15 seconds) - Only when specifically needed:
Decision Rule: If you're not sure, use deep_search: false. You can always re-run with true if needed.
Choose the appropriate focus mode based on your query type:
LLM Answer Generation
URL Discovery
Deep Content Extraction
deep_search=false - Fastest response, returns titles, descriptions, and URLsdeep_search=true - Slower, extracts full page contentdeep_search=false (the default)Domain Filtering
Time Filtering
time_range for real-time recency filtering (hour, day, week, month, year)start_date/end_date for precise date ranges (YYYY-MM-DD)time_range and date filters are mutually exclusiveAll examples below use the ./scripts/search.sh wrapper for simplicity. For raw API usage, see the API Integration section.
Quick search in fast mode (ALWAYS specify deep_search explicitly):
./scripts/search.sh '{
"query": "React Server Components tutorial",
"deep_search": false
}'For technical content, specify coding focus (still fast mode):
./scripts/search.sh '{
"query": "React Server Components tutorial",
"focus": "coding",
"deep_search": false
}'Get synthesized insights from multiple sources (fast mode works great with answer generation):
./scripts/search.sh '{
"query": "impact of AI on software development 2026",
"deep_search": false,
"include_answer": true
}'Target specific authoritative sources (fast mode):
./scripts/search.sh '{
"query": "async await patterns",
"focus": "coding",
"deep_search": false,
"include_domains": ["github.com", "stackoverflow.com", "dev.to"],
"max_results": 8
}'Track current events and breaking news as they happen (fast mode):
./scripts/search.sh '{
"query": "latest developments in quantum computing",
"focus": "news",
"deep_search": false,
"time_range": "week",
"max_results": 15,
"include_answer": true
}'Find and synthesize scholarly content using fast mode:
./scripts/search.sh '{
"query": "machine learning interpretability methods",
"focus": "academic",
"deep_search": false,
"max_results": 20,
"include_answer": true
}'When to use deep mode: Only use "deep_search": true if you need full paper content extracted for archiving:
./scripts/search.sh '{
"query": "machine learning interpretability methods",
"focus": "academic",
"deep_search": true,
"max_results": 5,
"output_format": "markdown"
}'Note: Deep mode is 5-15x slower. Use only when specifically needed.
Compare products and current prices (fast mode):
./scripts/search.sh '{
"query": "best mechanical keyboards for programming",
"focus": "shopping",
"deep_search": false,
"max_results": 10,
"include_answer": true
}'Run multiple real-time searches in parallel when:
Method 1: Background Processes (Recommended)
Run multiple searches concurrently using the wrapper script:
# Start multiple searches in parallel
./scripts/search.sh '{"query": "React", "focus": "coding"}' > react_coding.json &
./scripts/search.sh '{"query": "React", "focus": "news"}' > react_news.json &
./scripts/search.sh '{"query": "React", "focus": "academic"}' > react_academic.json &
# Wait for all to complete
wait
# Combine results
jq -s '.' react_*.json > combined_results.jsonMethod 2: Loop with xargs (Controlled Parallelism)
Process multiple queries with rate limiting:
# Create queries file
cat > queries.txt <<EOF
{"query": "AI frameworks", "focus": "coding"}
{"query": "AI regulation", "focus": "news"}
{"query": "AI research", "focus": "academic"}
EOF
# Run with max 3 parallel processes
cat queries.txt | xargs -n1 -P3 -I{} ./scripts/search.sh '{}'Method 3: Focus Mode Comparison
Search the same query across different focus modes:
QUERY="artificial intelligence trends"
for focus in "general" "coding" "news" "academic"; do
(
./scripts/search.sh "{\"query\": \"$QUERY\", \"focus\": \"$focus\"}" \
> "${focus}_results.json"
) &
done
wait
echo "All searches complete!"xargs -P3 to set maximum concurrent requests
./scripts/search.sh '{"query": "test"}' || echo "Search failed" >> errors.log
# Wait for all searches
wait
# Merge JSON results
jq -s 'map(.results) | flatten' result*.json > combined.json
echo "Running 5 parallel searches..."
for i in {1..5}; do
./scripts/search.sh "{\"query\": \"query$i\"}" > "result$i.json" &
done
wait
echo "All searches complete!"#!/bin/bash
# Research a topic across multiple focus modes simultaneously
QUERY="artificial intelligence code generation"
OUTPUT_DIR="./search_results"
mkdir -p "$OUTPUT_DIR"
# Run searches in parallel across different focus modes
for focus in "general" "coding" "news" "academic"; do
(
./scripts/search.sh "{
\"query\": \"$QUERY\",
\"focus\": \"$focus\",
\"max_results\": 10
}" > "$OUTPUT_DIR/${focus}_results.json"
) &
done
# Wait for all searches to complete
wait
# Aggregate and analyze results
jq -s '{
general: .[0].results,
coding: .[1].results,
news: .[2].results,
academic: .[3].results
}' "$OUTPUT_DIR"/*.json > "$OUTPUT_DIR/combined_analysis.json"
echo "✓ Multi-perspective search complete"Note: For most use cases, use the ./scripts/search.sh wrapper script shown in Usage Patterns. The raw API examples below are for advanced users who need direct API access or custom integration.
Before making any API request, always validate the API key is configured:
# Validate API key is set
if [ -z "$NIMBLE_API_KEY" ]; then
echo "❌ Nimble API key not configured."
echo "Get your key at https://www.nimbleway.com/"
echo ""
echo "Set NIMBLE_API_KEY environment variable using your platform's method."
exit 1
fiThe skill requires the NIMBLE_API_KEY environment variable. See Prerequisites for platform-specific setup instructions.
Get your API key at: https://www.nimbleway.com/
POST https://nimble-retriever.webit.live/search{
"query": "search query string", // REQUIRED
"focus": "general", // OPTIONAL: default "general" | coding|news|academic|shopping|social|geo|location
"max_results": 10, // OPTIONAL: default 10 (range: 1-100)
"include_answer": false, // OPTIONAL: default false
"deep_search": false, // OPTIONAL: default false (RECOMMENDED: keep false for speed)
"output_format": "markdown", // OPTIONAL: default "markdown" | plain_text|simplified_html
"include_domains": ["domain1.com"], // OPTIONAL: default [] (no filter)
"exclude_domains": ["domain3.com"], // OPTIONAL: default [] (no filter)
"time_range": "week", // OPTIONAL: hour|day|week|month|year
"start_date": "2026-01-01", // OPTIONAL: Use time_range OR start_date/end_date (not both)
"end_date": "2026-12-31" // OPTIONAL
}Key Defaults:
focus: "general" - Change to specific mode for targeted resultsdeep_search: false - Keep false unless you need full page contentmax_results: 10 - Balanced speed and coverage{
"results": [
{
"url": "https://example.com/page",
"title": "Page Title",
"description": "Page description",
"content": "Full page content (if deep_search=true)",
"published_date": "2026-01-15"
}
],
"include_answer": "AI-generated summary (if include_answer=true)",
"urls": ["url1", "url2", "url3"],
"total_results": 10
}Use coding for:
Use news for:
Use academic for:
Use shopping for:
Use social for:
Use geo for:
Use location for:
✅ Use LLM answers when:
❌ Skip LLM answers when:
Default (Recommended): deep_search=false
The default setting works for 95% of use cases:
include_answer=trueOnly use deep_search=true when you specifically need:
Performance impact:
deep_search=false: ~1-3 secondsdeep_search=true: ~5-15 seconds (significantly slower)Authentication Failed
Rate Limiting
No Results
Timeout Errors
deep_search=false (default) for 5-10x faster responses{"query": "..."} - defaults work greatdeep_search=true when you truly need full contentSee the examples/ directory for detailed integration patterns:
basic-search.md - Simple search implementationdeep-research.md - Multi-step research workflowcompetitive-analysis.md - Domain-specific research patternSee references/ directory for detailed documentation:
focus-modes.md - Complete focus mode guidesearch-strategies.md - Advanced search patternsapi-reference.md - Full API documentationThe recommended way to use the Nimble Search API:
./scripts/search.sh '{"query": "your search", "focus": "coding"}'Features:
$NIMBLE_API_KEYjqUsage:
# Basic search
./scripts/search.sh '{"query": "React hooks"}'
# With all options
./scripts/search.sh '{
"query": "AI frameworks",
"focus": "coding",
"max_results": 15,
"include_answer": true,
"include_domains": ["github.com"]
}'Test your API configuration and connectivity:
./scripts/validate-query.sh "test query" generalThis verifies:
Generated Feb 25, 2026
Marketing teams can use the general or news focus modes to gather real-time data on competitors, industry trends, and customer sentiment. By setting deep_search to false, they quickly obtain URLs and summaries for reports, enabling fast decision-making without full content extraction.
Researchers and students leverage the academic focus mode to discover recent papers and scholarly articles. With deep_search set to false, they efficiently compile reference lists and summaries, speeding up literature reviews while maintaining access to source URLs for deeper reading.
Retailers and entrepreneurs use the shopping focus mode to find real-time product listings and price comparisons. By keeping deep_search false, they quickly scan multiple e-commerce sites for sourcing opportunities, optimizing inventory decisions with up-to-date data.
Developers employ the coding focus mode to access real-time documentation and code examples. Setting deep_search to false allows rapid retrieval of relevant URLs and snippets, aiding in debugging and learning without the delay of full page extraction.
Small businesses and analysts use the location or geo focus modes to gather information on local competitors and market conditions. With deep_search false, they obtain quick insights into nearby services and trends, supporting strategic planning and outreach efforts.
Offer tiered subscription plans for the Nimble Search API, providing different usage limits and features like advanced focus modes or priority support. Revenue is generated through monthly or annual fees from developers and businesses integrating the skill into their applications.
License the skill as a white-label solution for large corporations to embed real-time web search into their internal tools or customer-facing platforms. Revenue comes from one-time setup fees and ongoing maintenance contracts tailored to enterprise needs.
Provide a free tier with basic search capabilities and limited queries, while charging for premium features such as deep_search mode, higher result limits, or specialized focus modes. Revenue is driven by upgrades from individual users and small teams seeking enhanced functionality.
💬 Integration Tip
Always set the NIMBLE_API_KEY environment variable first and explicitly specify deep_search as false in requests for faster performance in most use cases.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.