The Nimble Web Expert skill gives your agent the ability to search, extract, scrape, map, crawl, and run pre-built extraction agents across any website. Fast, incremental, and immediately responsive. This is the only way your AI assistant can access live websites.
Powered by the Nimble CLI and built on the open-source Agent Skills standard for cross-platform agent compatibility.
| Tool | Description |
|---|
| Search | Accurate, real-time web search. 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. Plan extraction workflows before running them. |
| Crawl | Extract contents from entire websites in a single request. Collect large volumes of web data automatically. |
| Agents | Run pre-built extraction agents for structured data from popular websites (Amazon, Google, LinkedIn, and hundreds more). |
Quick Install
Claude Code
Cursor
Vercel Agent Skills CLI
claude plugin marketplace add Nimbleway/agent-skills && \
claude plugin install nimble@nimble-plugin-marketplace
npx skills add Nimbleway/agent-skills -a cursor
npx skills add Nimbleway/agent-skills
Prerequisites
1. Nimble CLI
Install the Nimble CLI globally:
npm i -g @nimble-way/nimble-cli
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"
~/.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 Expert skill activates automatically when you ask for live web data:
"Search for recent AI developments"
-> nimble search --query "recent AI developments" --search-depth lite
"Extract the content from this URL"
-> nimble extract --url "https://example.com" --parse --format markdown
"Scrape prices from this product page"
-> nimble extract --url "https://example.com/product" --render --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
Use this skill for immediate, one-off data needs. For building reusable
extraction workflows, use the Nimble Agent
Builder instead. Command Examples
Search
Accurate, real-time web search with 8 focus modes (general, coding, news, academic, shopping, social, geo, location).
# Lite search (default, fast, token-efficient)
nimble search --query "React hooks tutorial" --topic coding --search-depth lite
# Search with AI-generated answer summary
nimble search --query "what is WebAssembly" --include-answer --search-depth lite
# News search with time filter
nimble search --query "AI developments" --topic news --time-range week --search-depth lite
# Domain-filtered search
nimble search --query "auth best practices" \
--include-domain github.com \
--include-domain stackoverflow.com \
--search-depth lite
Use --search-depth lite (default) for fast responses (1-3s). Use
--search-depth deep when you need full page content for archiving or
full-text analysis.
# 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.
Web Expert vs Agent Builder
| agent-builder | web-expert |
|---|
| Goal | Reusable workflow | Immediate data |
| Speed | Slower (build/test/refine cycle) | Fast, direct |
| Output | Published agent | Extracted data |
| Use when | ”I’ll need this repeatedly" | "Get me this data now” |
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. 
