
search-plus
Enhanced web search with multi-service fallback (TinyFish, Tavily, Brave, Exa, Jina, plus keyless Firecrawl/Defuddle) — works without API keys
- version
- 3.5.3
- GitHub stars
- 7
Install
/plugin install search-plus@vibekitRun it inside Claude Code after adding the marketplace with /plugin marketplace add shrwnsan/vibekit-claude-plugins.
Contents
Discovered from sourceSkills 1
Meta Search
Recover web content when standard tools fail. Orchestrates multi-service search and extraction via a bundled script, with manual fallback strategies.
Recovery workflow
Step 1: Run the recovery script
node "${CLAUDE_SKILL_DIR}/scripts/search.mjs" "<query-or-url>"
- Query → SearXNG (if
SEARCH_PLUS_SEARXNG_URLis set) → TinyFish → Tavily → Brave → Exa → Jina Search (each only if its key is set) → Firecrawl (keyless). Prints a markdown list of results. - URL → Direct markdown fetch (asks the origin for
Accept: text/markdown; only used when it actually serves markdown) → Tavily Extract (if key) → Jina Reader → TinyFish Fetch (if key) → Firecrawl → Defuddle → Wayback Machine snapshot. Prints the page as markdown.
Exit code 0: use the stdout directly. Non-zero: stderr lists each service tried and why it failed; proceed to Step 2.
Step 2: Manual recovery with built-in tools
Apply the strategy matching the error type:
403 Forbidden
- Retry with
web_fetchusing the URL directly - Search for the page title or key terms instead
- Try the archived copy:
https://web.archive.org/web/2/<URL>
429 Rate Limited
- Wait briefly, then retry
- Simplify the query to essential keywords
- Switch approach: if searching, try fetching a known URL instead
422 Validation / "Did 0 searches..."
- Remove special characters and quotes from the query
- Shorten to essential keywords only
- Split compound queries into separate searches
451 / blocked domain
- Search with domain exclusion:
"<query> -site:<blocked-domain>" - Search for alternatives:
"<query>" alternative OR mirror
ECONNREFUSED / Timeout
- Retry after a brief pause
- Try
web_fetchwith a different URL for the same content
Empty Results
- Broaden the query — remove restrictive terms
- Try different phrasing or synonyms
Step 3: Report results
- On success: return the recovered content
- On partial success: return what was found, note what remains inaccessible
- On failure: report which strategies were tried and why they failed
Sandbox compatibility
The extraction script makes outbound requests to external services. If Claude Code's sandbox is enabled, these domains must be in the allowedDomains list:
// ~/.claude/settings.json
{
"sandbox": {
"network": {
"allowedDomains": [
"api.tavily.com",
"api.search.brave.com",
"api.exa.ai",
"s.jina.ai",
"r.jina.ai",
"api.jina.ai",
"api.firecrawl.dev",
"api.search.tinyfish.ai",
"api.fetch.tinyfish.ai",
"defuddle.md",
"archive.org"
]
}
}
}
Without these, all extraction services will fail with fetch failed and the script will fall through to Step 2 (manual recovery).
Keyless services (Jina Reader, Firecrawl, Defuddle, Wayback) are included in the list above.
The direct markdown fetch (first step for URLs) connects to the target site itself and ignores proxy settings, because its SSRF guard must check DNS answers at connect time. In a proxied sandbox that step always fails (direct: in the Tried: list) and the chain continues with the providers above; this is expected.
Limitations
- Cannot bypass CAPTCHA or advanced bot protection
- Some paywalled content remains inaccessible
- Cache/archive services may have stale content
- Without API keys, web search depends on Firecrawl's keyless tier (rate-limited per IP); set any provider key for reliability
Agents 1
Search Plus Agent
Purpose-built subagent for reliable web research and URL extraction. It interprets a query or URL, selects an extraction/search path, applies robust retries, and returns validated, cited results.
Inputs
- Query: natural language research question
- URL(s): one or more explicit links to extract
- Constraints (optional): cost/speed preference, max tokens, domains to avoid
Outputs
The agent runs the skill CLI (scripts/search.mjs <query-or-url>), which reports:
- Success (exit 0): compact markdown on stdout. The header line names the service that served the result, e.g.
Source: <url> (via tavily)for URL extraction orSearch results for "<query>" (via tavily)for search. - Failure (exit 1): nothing on stdout; a structured summary of every service tried on stderr. URL extraction failures additionally include a
Tried:list of each provider and its error.
Relay results to the user as a concise summary with inline citations, noting which service served the content and any remaining gaps.
Operating Procedure (Runbook)
- Interpret intent
- Detect if input is URL extraction vs open-ended research; extract all URLs present.
- Identify domain class (docs, news, forums, APIs) and sensitivity (likely to block/captcha).
- Choose path
- URL present → Extraction mode
- No URL → Research mode (search → fetch top candidates → extract)
- Primary attempt
- Perform search/fetch using default project tools; prioritize fast/reliable provider.
- Normalize and clean content (strip boilerplate, preserve headings/code/links).
- Fallback gating (trigger if any):
- HTTP ≥400 (403/404/422/429), empty/near-empty content, obvious paywall/captcha, or target domain in “problematic sites”.
- Fallback sequence
- Wait briefly, then retry (pace yourself; a few seconds, not minutes).
- Switch service/provider; vary request params and user-agent where supported.
- Prefer documentation-friendly readers for docs.*, readthedocs, github raw, etc.
- Cap retries: 2 attempts primary + 2 attempts fallback; stop early on strong success.
- Validation and dedupe
- Require non-empty content with ≥ N characters/tokens; dedupe by canonical URL.
- If multiple candidates, rank by relevance, freshness, and completeness.
- Summarize and cite
- Produce concise summary with inline citations; include brief methodology only if helpful.
- Return structured output
- Include sources with statuses and any errors encountered for transparency.
Error Handling Policy
- 403 Forbidden: wait briefly, then try an alternate service; prefer doc-friendly readers for docs/public sites.
- 429 Rate Limited: slow down and space out retries; run one request at a time.
- 422 Validation: simplify query/params; alternate request shape; reattempt search then fetch.
- ECONNREFUSED/ETIMEDOUT: alternate resolver/service; short cooldown before retry.
- Circuit breaker: abort after capped attempts and report best partial results.
Decision Heuristics
- docs.*, readthedocs, .api., github content → prefer documentation readers.
- news/finance (e.g., finance.yahoo.com) → prioritize services with high success on dynamic pages.
- forums/reddit → use readers tolerant of anti-bot measures.
- If page text < threshold or only nav captured → try alternate extractor immediately.
Stop Conditions
- High-quality content acquired and summarized; or
- Capped retries reached; or
- Repeated non-retryable errors (4xx except 429) with no viable alternative.
Escalation
- Ask for alternate URL or narrower query if content is explicitly paywalled/private.
- Provide top N alternative sources when primary fails.
- Return partial findings with clear caveats and next steps.
Do / Don’t
- Do confirm intent briefly, cite all sources, chunk long docs logically.
- Do minimize calls; avoid redundant fetches; cache awareness where available.
- Don’t hallucinate unseen content; don’t loop beyond caps; don’t ignore Retry-After.
Examples
- Research: “Compare Claude Code plugin marketplaces and list key differences.”
- URL extract: “Summarize https://docs.anthropic.com/en/docs/claude-code/plugins.”
- Recovery: “Standard search failed with 429; retry with robust error handling.”
Notes
- Tooling is inherited (no tools listed in frontmatter), allowing this subagent to use the same approved set as the parent context, including plugin skills and MCP tools when available.
Sponsors
Details
- Marketplace
- shrwnsan/vibekit-claude-plugins
- Source
- plugins/search-plus
- Author
- shrwnsan
- Category
- Productivity
- License
- Apache-2.0
- Keywords
- search, web, error-handling, fallback, schema-validation, productivity, url-extraction