nimble

Nimble Web Search Skills & Plugin

 

Unlock the web for your AI agents — search, scrape, extract structured data, and run business intelligence workflows, all powered by Nimble's web data infrastructure. One plugin for Claude Code, Cursor, and any platform that supports the Agent Skills spec.

Agent credential protocol: see AUTH.md — the file agents read to authenticate to the Nimble API. Served live at https://nimbleway.com/auth.md.

Skills

| Category | What you get | | -------- | ------------ | | Business Research | Competitor monitoring, 360° company research, and market discovery — find all businesses of a given type in any geography with multi-source verification | | Marketing | Track how competitors position themselves — messaging shifts, pricing changes, content gaps, battlecard inputs | | SEO | All-in-one SEO intelligence (seo-intel) — keyword research, rank tracking, technical site audits with JS rendering, content gap analysis, competitor on-page teardowns, AI visibility across 5 platforms, and GitHub repo SEO. Single entry point with intent-based routing | | Productivity | Walk into any meeting fully briefed — attendee backgrounds, company context, talking points, relationship mapping. Discover and score local businesses in any neighborhood with interactive maps | | Web Data Toolkit | Search, scrape, extract, map, and crawl any website — run site-specific Extraction Templates for clean structured data, and Web Search Agents for open-ended research with citations | | Data Platforms | Turn live web data into Databricks data products — discover Nimble agents, scrape into Delta tables, and build an AI/BI dashboard and/or a deployed Databricks App (nimble-databricks-data-products) |

Business Research, Marketing, and Productivity skills are one-command workflows. They spawn parallel sub-agents, gather live web data via Nimble APIs, synthesize findings, and deliver structured reports with dates and source URLs. They learn from previous runs and only surface what's new.

These skills also extend into specific industries — starting with Healthcare: extract structured practitioner data from practice websites, enrich provider lists with missing fields, and verify credentials against the NPI registry. The Human Resources vertical covers talent sourcing with more skills (comp analysis, interview prep, onboarding) planned.

Web Data Toolkit skills expose Nimble's raw capabilities for any web task and power the business skills under the hood — search and extract for raw data, Extraction Templates for reusable site-specific scraping, and Web Search Agents for open-ended research, enrichment, and dataset building.

Quick Start

1. Install the Nimble CLI

npm i -g @nimble-way/nimble-cli

2. Set your API key

Sign up and grab your key from Account Settings > API Keys.

export NIMBLE_API_KEY="your-api-key-here"

Or add it permanently to ~/.claude/settings.json:

{ "env": { "NIMBLE_API_KEY": "your-api-key-here" } }

3. Add the skills

Any Claude product (Claude Code, Claude Cowork, claude.ai) — recommended:

/plugin install nimble

One command. The plugin's .mcp.json auto-registers as a Connector pointing at the Nimble MCP server over native HTTP with OAuth — no API key header to manage. On first use, run /mcp and authenticate nimble in your browser.

In claude.ai / Cowork the connector appears under Customize → Connectors as Nimble — click Connect and complete the browser login to activate it (you can create a Nimble account inline if you don't have one).

Cursor:

/add-plugin nimble

Or clone the repo and open it in Cursor — the plugin system auto-discovers skills from .cursor-plugin/plugin.json.

Manual install (Codex CLI, raw MCP clients, or when you'd rather use an API key):

claude mcp add --transport http nimble https://mcp.nimbleway.com/mcp \
  --header "Authorization: Bearer ${NIMBLE_API_KEY}"

> Restart Claude Code after running this — MCP servers added mid-session aren't available until the next launch.

npx skills CLI:

npx skills add Nimbleway/agent-skills

To install a single skill:

npx skills add Nimbleway/agent-skills --skill competitor-intel

To list available skills:

npx skills add Nimbleway/agent-skills --list

4. Try it

# Business intelligence — ask a question, get a sourced report
"What are my competitors doing this week?"
"Prepare me for my meeting with Jane from Acme Corp"

# Web data toolkit — get data from any website
"Scrape the pricing page at example.com"
nimble search --query "AI agent frameworks" --max-results 10

How It Works

Nimble Web Search Skills follow a shared pattern: preflight (check CLI, load profile) → parallel research (spawn sub-agents for concurrent data gathering) → analysis (synthesize findings, deduplicate against previous runs) → report (structured output with sources) → distribute (offer Notion/Slack delivery).

Core skills expose the Nimble CLI directly — search, extract, map, crawl, run Extraction Templates, and run Web Search Agents.

Local Web Knowledge Wiki

Skills maintain a local web knowledge wiki at ~/.nimble/memory/ — live web intelligence that compounds across sessions, so your agent never starts from scratch. Inspired by Karpathy's LLM Wiki: an AI-maintained, human-owned knowledge base that gets smarter with every run.

• Local-first indexes — per-directory entity catalogs for instant lookup, no vector DB needed
• Obsidian-compatible — [[wiki links]] cross-reference people, companies, and competitors. Open ~/.nimble/memory/ in Obsidian to browse your intelligence graph
• Cross-entity synthesis — patterns across competitors, pricing trends, and market signals are surfaced automatically
• Ad-hoc insights — say "remember this" mid-conversation and it compounds into the right entity page
• Activity log — grep-friendly record of what was learned, when, and by which skill

Every finding carries a verified event date and source URL. Stale signals are dropped, not reported — your context is always current.

Platform Compatibility

| Aspect | Claude Code | Cursor | npx skills | | ------ | ----------- | ------ | ---------- | | Plugin config | .claude-plugin/ | .cursor-plugin/ | N/A (reads skills/) | | MCP config | .mcp.json | mcp.json | Manual setup | | Rules | N/A | rules/*.mdc | N/A | | Skills | skills/ (shared) | skills/ (shared) | skills/ (shared) |

All platforms read the same skills/ directory. Platform-specific files coexist without interference.

CLI Commands

| Command | Description | | ------- | ----------- | | nimble search --query "<q>" | Real-time web search | | nimble extract --url "<url>" --format markdown | Extract content from a URL | | nimble map --url "<url>" --limit 20 | Discover URLs on a site | | nimble crawl run --url "<url>" --limit 50 | Crawl a website section | | nimble extract:templates list --limit 100 | Browse Extraction Templates for known sites | | nimble extract:templates run --template <name> --params '{...}' | Run an Extraction Template | | nimble agents run --agent-name <name> --input "<task>" | Start a Web Search Agent run — creates the named agent, or reuses it on repeat calls | | nimble agents:runs create --agent-id <id> --input "<task>" | Start a run against an agent you already hold the ID for | | nimble agents:runs get / result --agent-id <id> --run-id <id> | Poll a run to a terminal state, then fetch its output and citations |

Contributing

Have a web data workflow that should be one command? We'd love new skills — whether it's sales prospecting, lead enrichment, or anything that turns web data into action. See CONTRIBUTING.md for how to build and publish your own.

Links

• Nimble: nimbleway.com
• Documentation: docs.nimbleway.com
• Issues: github.com/Nimbleway/agent-skills/issues
• Email: support@nimbleway.com

License

MIT License — see LICENSE for details.