Skip to main content
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.

View on GitHub

Source code for this skill

​
Tools Overview

ToolDescription
SearchAccurate, real-time web search. 8 focus modes: general, coding, news, academic, shopping, social, geo, location.
ExtractScalable data collection with stealth unblocking. Get clean, real-time HTML and structured data from any URL. Supports JS rendering and browser emulation.
MapFast URL discovery and site structure mapping. Plan extraction workflows before running them.
CrawlExtract contents from entire websites in a single request. Collect large volumes of web data automatically.
AgentsRun pre-built extraction agents for structured data from popular websites (Amazon, Google, LinkedIn, and hundreds more).

​
Quick Install

claude plugin marketplace add Nimbleway/agent-skills && \
claude plugin install nimble@nimble-plugin-marketplace

​
Prerequisites

​
1. Nimble CLI

Install the Nimble CLI globally: 
npm i -g @nimble-way/nimble-cli
Verify with: 
nimble --version

​
2. Nimble API Key

Get your key at online.nimbleway.com. Set the NIMBLE_API_KEY environment variable using your platform’s method:
Add to ~/.claude/settings.json:
{
  "env": {
    "NIMBLE_API_KEY": "your-api-key-here"
  }
}

​
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

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.

​
Extract

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.

​
Web Expert vs Agent Builder

agent-builderweb-expert
GoalReusable workflowImmediate data
SpeedSlower (build/test/refine cycle)Fast, direct
OutputPublished agentExtracted 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.