Real-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.
Real-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.
Add to .github/skills/ directory in your repository
Or use GitHub Actions secrets for the copilot environment
Shell/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.
API Key Validation
IMPORTANT: Before making any search request, verify the API key is configured:
# Check if API key is setif [ -z "$NIMBLE_API_KEY" ]; thenecho"❌ 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
fi
Overview
Nimble 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 responses
Use false (FAST MODE - 1-3 seconds): For 95% of use cases - URL discovery, research, comparisons, answer generation
Use true (DEEP MODE - 5-15 seconds): Only when you specifically need full page content extracted for archiving or detailed analysis
focus: Default to "general" for broad searches
Change to specific mode (coding, news, academic, shopping, social, geo, location) for targeted results
max_results: Default to 10 - Balanced speed and coverage
Performance 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.
Quick Start
Use the wrapper script for the simplest experience:
Result Aggregation: Combine results after all searches complete
# Wait for all searcheswait# Merge JSON results
jq -s 'map(.results) | flatten' result*.json > combined.json
Progress Tracking: Monitor completion status
echo"Running 5 parallel searches..."for i in {1..5}; do
./scripts/search.sh "{\"query\": \"query$i\"}" > "result$i.json" &
donewaitecho"All searches complete!"
Example: Multi-Perspective Research
#!/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 modesfor 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 completewait# 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"
Performance Considerations
Optimal Parallelism: 3-5 concurrent requests balances speed and API limits
Memory Usage: Each parallel request consumes memory; monitor for large result sets
Network Bandwidth: Parallel requests can saturate bandwidth on slow connections
API Costs: More parallel requests = faster API quota consumption
When NOT to Use Parallel Searches
Single, focused query with one clear answer
Sequential research where each search informs the next
API quota is limited or expensive
Results need to be processed before next search
Simple URL collection that doesn't require multiple perspectives
API Integration
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.
Required Configuration
Before making any API request, always validate the API key is configured:
# Validate API key is setif [ -z "$NIMBLE_API_KEY" ]; thenecho"❌ 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
fi
The skill requires the NIMBLE_API_KEY environment variable. See Prerequisites for platform-specific setup instructions.
