Real-time web intelligence tools — search, extract, map, and crawl the live web via the Nimble CLI. Built on the open-source Agent Skills standard for cross-platform agent compatibility.
| Tool | Description |
|---|
| Search | Accurate, real-time web search — AI Agents search the live web to retrieve precise information. 8 focus modes: general, coding, news, academic, shopping, social, geo, location. |
| Extract | Scalable data collection with stealth unblocking — get clean, real-time HTML and structured data from any URL. Supports JS rendering and browser emulation. |
| Map | Fast URL discovery and site structure mapping — easily plan extraction workflows. |
| Crawl | Extract contents from entire websites in a single request — collect large volumes of web data automatically. |
Quick Install
npx skills add Nimbleway/agent-skills
Prerequisites
1. Nimble CLI
Install the Nimble CLI globally:
npm i -g @nimble-way/nimble-cli
Verify with:
2. Nimble API Key
Get your key at online.nimbleway.com.
Set the NIMBLE_API_KEY environment variable using your platform’s method:
Claude Code
Shell / Terminal
VS Code / GitHub Copilot
Add to ~/.claude/settings.json:{
"env": {
"NIMBLE_API_KEY": "your-api-key-here"
}
}
export NIMBLE_API_KEY="your-api-key-here"
Or add to your shell profile (~/.bashrc, ~/.zshrc):echo 'export NIMBLE_API_KEY="your-api-key-here"' >> ~/.zshrc
- Add skills to
.github/skills/ in your repository
- Configure API key using GitHub Actions secrets in the copilot environment
- Or set as environment variable in your shell
Quick Start
The nimble-web-tools skill activates automatically when you ask relevant questions:
"Search for recent AI developments"
-> nimble search --query "recent AI developments" --deep-search=false
"Extract the content from this URL"
-> nimble extract --url "https://example.com" --parse --format markdown
"Map all the pages on this docs site"
-> nimble map --url "https://docs.example.com" --limit 100
"Crawl the API docs section"
-> nimble crawl run --url "https://docs.example.com/api" --limit 50
Command Examples
Search
Accurate, real-time web search with 8 focus modes (general, coding, news, academic, shopping, social, geo, location).
# Fast search (recommended — always use --deep-search=false)
nimble search --query "React hooks tutorial" --topic coding --deep-search=false
# Search with AI-generated answer summary
nimble search --query "what is WebAssembly" --include-answer --deep-search=false
# News search with time filter
nimble search --query "AI developments" --topic news --time-range week --deep-search=false
# Domain-filtered search
nimble search --query "auth best practices" \
--include-domain github.com \
--include-domain stackoverflow.com \
--deep-search=false
Use --deep-search=false for fast responses (1-3s). The default deep mode fetches full page content and is 5-10x slower — only needed for archiving or full-text analysis.
Get clean, structured data from any URL with stealth unblocking and JS rendering.
# Standard extraction (always use --parse --format markdown)
nimble extract --url "https://example.com/article" --parse --format markdown
# Render JavaScript for SPAs and dynamic content
nimble extract --url "https://example.com/app" --render --parse --format markdown
# Extract with geolocation
nimble extract --url "https://example.com" --country US --city "New York" --parse --format markdown
Map
Discover all URLs on a site to plan extraction workflows.
# Map URLs on a site
nimble map --url "https://docs.example.com" --limit 100
# Include subdomains
nimble map --url "https://example.com" --domain-filter subdomains
Crawl
Extract content from entire websites asynchronously.
# Start a crawl (always set --limit)
nimble crawl run --url "https://docs.example.com" --limit 50
# Crawl with path filtering
nimble crawl run --url "https://example.com" \
--include-path "/docs" \
--include-path "/api" \
--limit 100
# Check crawl status
nimble crawl status --id "crawl-id"
# List all crawls
nimble crawl list
For LLM-friendly output, prefer map + extract --parse --format markdown on individual pages. Crawl returns raw HTML which can be very large.
About Agent Skills
This skill follows the Agent Skills open-source standard, making it compatible with multiple AI agent platforms. Install using the Skills CLI — the standard package manager for the Agent Skills ecosystem.
Full Command Reference
For the complete list of options, flags, and advanced usage patterns, see the SKILL.md on GitHub.