nimbleway/nimble-map-reference
skills/web-search-tools/nimble-web-expert/references/nimble-map/SKILL.md
Reference for nimble map command. Load when discovering URLs on a site before bulk extraction. Contains: all flags (limit 1-100000, sitemap include/only/skip, domain_filter), response structure {links[].url/title/description}, map→filter→extract pattern, map vs crawl comparison.
$ install --global
skillsauthnpx skillsauth add nimbleway/agent-skills nimble-map-referenceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 8:39 AM4.6s1 file scanned
SKILL.md
- name:
- nimble-map-reference
- description:
- |
- Contains:
- all flags (limit 1-100000, sitemap include/only/skip, domain_filter),
nimble map — reference
Discovers all URLs on a site in seconds. Returns URL metadata (url, title, description) — run extract on results to get page content. Single synchronous call — no polling required.
Table of Contents
- Parameters
- CLI
- Python SDK
- Response
- Common patterns
- Map vs Crawl
Parameters
| Parameter | CLI flag | Type | Default | Description |
| --------------- | ----------------- | ------ | --------- | ------------------------------------------------------------------------------------ |
| url | --url | string | required | Starting URL |
| limit | --limit | int | 100 | Max URLs returned (1–100,000) |
| sitemap | --sitemap | string | include | include (sitemap + crawl) | only (sitemap only, fastest) | skip (crawl only) |
| domain_filter | --domain-filter | string | — | domain (exact) | subdomain (include subdomains) | all (follow all links) |
| country | --country | string | ALL | ISO Alpha-2 proxy location (e.g. US) |
| locale | --locale | string | — | LCID locale (e.g. en-US) or auto |
CLI
nimble map --url "https://docs.example.com" --limit 100
# Sitemap only (fastest)
nimble map --url "https://example.com" --sitemap only --limit 500
# Extract just the URL list
nimble --transform "links.#.url" map --url "https://docs.example.com" --limit 100
Python SDK
from nimble_python import Nimble
nimble = Nimble(api_key=os.environ["NIMBLE_API_KEY"])
resp = nimble.map(url="https://docs.example.com", limit=100, sitemap="include")
links = resp.links # list of link objects
urls = [l.url for l in links]
Response
| Field | Type | Description |
| --------------------- | ------- | ------------------------------------ |
| task_id | string | Request identifier |
| success | boolean | Whether the request succeeded |
| links | array | Discovered URLs |
| links[].url | string | The discovered URL |
| links[].title | string | Page title (if available) |
| links[].description | string | Page meta description (if available) |
Common patterns
# Map → filter → extract
nimble --transform "links.#.url" map --url "https://docs.stripe.com" --limit 200 > .nimble/urls.txt
grep "charges\|refund" .nimble/urls.txt
# Specific path section
nimble map --url "https://shop.example.com/products/" --limit 200
Map vs Crawl
| | map | crawl |
| -------- | ------------------------------------------- | ------------------------- |
| Speed | Seconds (sync) | Minutes (async) |
| Output | URL list with metadata | Full page content per URL |
| Best for | Discover URLs, then selectively extract | Archive all pages at once |
| LLM use | ✅ Combine with extract --format markdown | ⚠️ Returns raw HTML |
Related Skills
nimbleway/nimble-databricks-data-products
development
VerifiedTrustedCommunity
Builds Databricks data products from live web data, end to end: discovers the right Nimble web-data agents, scrapes into Delta tables, and produces an AI/BI dashboard and/or a deployed Databricks App — a table → dashboard → app workflow, for production data products or quick demos. Use whenever a request pairs live or scraped web data WITH a Databricks destination — e.g. "scrape Amazon/Walmart prices into a Delta table and build a dashboard", "load Zillow/Instagram/Maps/search results into Databricks and build a dashboard or app", "showcase Nimble + Databricks to a prospect". Prefer it over nimble-web-expert or competitor-intel when the data lands in Databricks. Do NOT use for one-off web fetches or CSV exports with no Databricks destination — use nimble-web-expert instead. Do NOT use for competitor or company research briefings — use competitor-intel or company-deep-dive instead. Do NOT use for generic Databricks work with no Nimble/web-data angle — use the official databricks-* skills instead.
46SKILL.mdUpdated Jun 13, 2026
nimbleway/talent-sourcing
development
VerifiedTrustedCommunity
Finds qualified candidates for a role by searching LinkedIn, Indeed, GitHub, and other professional platforms using Nimble Web Search Agents. Accepts a job description, role title, or freeform request and returns a ranked candidate list with profiles, skills, and contact signals. Use this skill when the user wants to find, source, or recruit candidates for a role. Common triggers: "find candidates for", "source engineers in", "who can I hire for", "find me a [role]", "recruiting for", "talent search", "find a [role] in [city]", "build a candidate list", "sourcing for [role]", "who's available for", "find potential hires". Also triggers on a pasted job description followed by a sourcing request. Do NOT use for job market research or salary benchmarking — use market-finder instead. Do NOT use for researching a single known person — use company-deep-dive or meeting-prep instead.
46SKILL.mdUpdated Apr 21, 2026
nimbleway/nimble-web-expert
development
VerifiedTrustedCommunity
Get web data now — fast, incremental, immediately responsive to what the user needs. The only way Claude can access live websites. USE FOR: - Fetching any URL or reading any webpage - Scraping prices, listings, reviews, jobs, stats, docs from any site - Discovering URLs on a site before bulk extraction - Calling public REST/XHR API endpoints - Web search and research (8 focus modes) - Bulk crawling website sections Must be pre-installed and authenticated. Run `nimble --version` to verify. For building reusable extraction workflows to run at scale over time, use nimble-agent-builder instead.
46SKILL.mdUpdated Apr 17, 2026
nimbleway/nimble-agent-builder
development
VerifiedTrustedCommunity
A building experience: create, test, validate, refine, and publish extraction workflows based on existing or new Nimble agents. For users who want to invest in a durable, reusable workflow for a specific domain — not get data immediately. Trigger phrases: "set up extraction for X site", "I need to extract from this site regularly", "build an agent for", "create a reusable scraper", "generate a Nimble agent", "refine my agent", "add a field to my agent", or when the user wants to run extraction at scale. For getting data immediately, use nimble-web-expert instead.
46SKILL.mdUpdated Apr 17, 2026