From nimble
Fetches live web data via Nimble CLI: scrape prices/listings/reviews/jobs/docs, call REST APIs, search/research (8 modes), discover/crawl URLs.
npx claudepluginhub nimbleway/agent-skills --plugin nimbleThis skill is limited to using the following tools:
Web extraction, search, and URL discovery using the Nimble CLI. Returns clean structured data from any website.
README.mdreferences/batch-patterns.mdreferences/error-handling.mdreferences/nimble-extract/browser-actions.mdreferences/nimble-extract/browser-investigation.mdreferences/nimble-extract/network-capture.mdreferences/nimble-extract/parsing-schema.mdreferences/nimble-search/search-focus-modes.mdreferences/recipes.mdrules/nimble-web-expert.mdcrules/output.mdrules/setup.mdBuilds, tests, validates, refines, and publishes reusable Nimble extraction agents for domain-specific web data workflows. For scalable recurring extractions, not one-off data needs.
Scrapes web pages, SERPs, e-commerce, YouTube, and ChatGPT via ScrapingBee CLI with smart path extraction and AI rules for LLMs. Handles JS, CAPTCHAs, anti-bot automatically.
Extracts structured data like tables, lists, and prices from web pages using multi-strategy scraping with pagination, validation, transforms, and CSV/JSON export.
Share bugs, ideas, or general feedback.
Web extraction, search, and URL discovery using the Nimble CLI. Returns clean structured data from any website.
User request: $ARGUMENTS
nimble extract. Research/topic → nimble search. Discover/crawl URLs → nimble map or nimble crawl.--transform "data.parsing" for agents. Show the data immediately as a table. Do NOT experiment, loop, or write Python to parse output.&+wait. 6–20 → xargs -P. 20+ → Python asyncio script. See references/batch-patterns.md..nimble/. Never leave extraction results in memory only.dangerouslyDisableSandbox.| Skill | Best for | Key commands |
|---|---|---|
| nimble-web-expert (this skill) | Real-time data — fetch any URL, search, map, crawl, run existing agents | extract, search, map, crawl, agent run |
| nimble-agent-builder | Build reusable agents — create, refine, publish named extraction templates | CLI: generate, get-generation, publish |
Hand off to nimble-agent-builder only when all of these are true: the user has signalled a recurring/scheduled need, the pattern is repetitive (same site, same fields), and they've seen and approved the results. Don't ask after every extract — only when language clearly signals a recurring workflow ("I want to do this every day", "build me a pipeline", "make this reusable").
For agent refinement: "Agent updates are handled by nimble-agent-builder — it can refine the existing agent without rebuilding from scratch."
AskUserQuestion at every meaningful choice — never guess, never ask in prose.which browser-use, python3 -c "from playwright.sync_api...") and ask whether to investigate with browser-use, Playwright, or skip.Looks great! / Mostly good / Not quite / Skip feedbackQuick check:
nimble --version && echo "${NIMBLE_API_KEY:+API key: set}"
If CLI version and API key: set both print → proceed to Step 0.
If anything is missing, load rules/setup.md for one-time setup instructions (CLI install, API key, Docs MCP).
If bash is denied: Stop. Show the command as text. Do not substitute WebFetch for Nimble tasks.
| User signal | Command | Notes |
|---|---|---|
| Names a specific site or domain | nimble agent → nimble extract if no agent | Always check for agent first — announce it |
| Provides a direct URL | nimble extract | Skip agent check |
| Research, topic, or vertical query | nimble search | Use focus modes for news, jobs, shopping, etc. |
| "Find URLs / sitemap / all pages" | nimble map | Returns URL list + metadata |
| "Crawl / archive a whole section" | nimble crawl | Async bulk extraction |
Pre-built agents return clean structured data with zero selector work. Always check first.
Always verbalize — never silently:
<agent_name> — using it now." or "No pre-built agent — falling back to extraction."Lookup order:
~/.claude/skills/nimble-web-expert/learned/examples.json → agents[] arrayreferences/nimble-agents/SKILL.md → baked-in table (50+ sites)nimble agent list --limit 100 --search "<domain or vertical>" → show table, confirm with userRun with --transform "data.parsing" — always:
nimble --transform "data.parsing" agent run --agent <name> --params '{"keyword": "..."}'
Do NOT run without --transform "data.parsing" and then parse raw output. The raw response contains html (useless), headers, and parsing (what you want). The transform flag extracts parsing in one shot.
For the full agent list (50+ sites), see references/nimble-agents/SKILL.md.
⚠️ google_search is for SEO/SERP rank analysis only — not general information retrieval. For finding information, use nimble search.
| Situation | Command | Reference |
|---|---|---|
| Site/domain → check agent first | nimble agent list → nimble agent run | references/nimble-agents/SKILL.md |
| Direct URL | nimble extract | references/nimble-extract/SKILL.md |
| Search the live web | nimble search | references/nimble-search/SKILL.md |
| Discover URLs on a site | nimble map | references/nimble-map/SKILL.md |
| Bulk crawl a section | nimble crawl run | references/nimble-crawl/SKILL.md |
| Batch agents (up to 1,000) | nimble agent run-batch | references/nimble-agents/SKILL.md |
| Batch extract (up to 1,000) | nimble extract-batch | references/nimble-extract/SKILL.md |
| Poll tasks / batches / results | nimble tasks / nimble batches | references/nimble-tasks/SKILL.md |
| Unknown selectors or XHR path | browser-use or Playwright investigation | references/nimble-extract/browser-investigation.md |
| Proven site patterns | copy a recipe | references/recipes.md |
| 2+ inputs | parallel bash &+wait or generated script | references/batch-patterns.md |
For the full extract waterfall (tiers, flags, browser actions, network capture), see references/nimble-extract/SKILL.md.
| Command | Output |
|---|---|
nimble agent | Structured data in data.parsing — array (SERP/list) or dict (PDP/product) |
nimble extract | HTML, Markdown, or parsed JSON — depends on --format and --parse |
nimble search | Structured results array (title, URL, description) |
nimble map | URL list + metadata |
nimble crawl | Async job — poll with nimble crawl status <job_id> |
Agent runs always need --transform "data.parsing". If the agent name suggests a list (serp, search, plp), expect an array. If it suggests a single item (pdp, product, profile), expect a dict.
mkdir -p .nimble # save all outputs here
Naming: .nimble/<site>-<task>.md (e.g. .nimble/amazon-airpods.md, .nimble/yelp-sf-italian.json)
Working with saved files:
wc -l .nimble/page.md && head -100 .nimble/page.md
grep -n "price\|rating" .nimble/page.md | head -30
End every response with: Source: [URL] — fetched live via Nimble CLI
The skill maintains ~/.claude/skills/nimble-web-expert/learned/examples.json.
good[] for url_pattern matches → use documented command/tier as starting point. Scan bad[] → avoid documented pitfalls.good[] with url_pattern, task, command, tier, notes. On negative feedback, ask "What went wrong?" and append to bad[] with url_pattern, task, issue, avoid, better.run_in_background=False. See nimble-agent-builder delegation model for the why.Load only when needed:
| File | Load when |
|---|---|
references/recipes.md | Need a proven command for a common site (Amazon, Yelp, LinkedIn…) |
references/nimble-agents/SKILL.md | Step 0 lookup — full agent table (50+ sites) |
references/nimble-extract/SKILL.md | Extract flags, render tiers, browser actions, network capture, parser schemas |
references/nimble-search/SKILL.md | Search flags, all 8 focus modes |
references/nimble-map/SKILL.md | Map flags, response structure |
references/nimble-crawl/SKILL.md | Full async crawl workflow |
references/nimble-tasks/SKILL.md | Poll tasks/batches, fetch results — for async, batch, and crawl operations |
references/nimble-extract/browser-investigation.md | Tier 6 — CSS selector/XHR discovery with browser-use or Playwright |
references/nimble-extract/parsing-schema.md | Parser types, selectors, extractors, post-processors |
references/nimble-extract/browser-actions.md | Full browser action types and parameters |
references/nimble-extract/network-capture.md | Filter syntax, XHR mode, capture+parse patterns |
references/nimble-search/search-focus-modes.md | Decision tree, mode details, combination strategies |
references/batch-patterns.md | Parallel bash patterns for 2–5, 6–20, and 20+ inputs |
references/error-handling.md | Error codes, known site issues, troubleshooting |