Anysearch

anysearch

Probe first. Extract only what earns the context.

<cmd> = python3 <skill-dir>/scripts/anysearch.py

Core loop

1. Choose the smallest rung in the effort ladder that can satisfy the user.
2. Run the probe in compact form unless the rung says otherwise.
3. Stop when the completion column is met; otherwise extract selected URLs or move one rung up.
4. Answer from extracted/source evidence, not from raw result lists, when the user needs supportable claims.
5. If access fails from auth, quota, rate limit, or no active key, run the key recovery branch and then repeat the original smallest suitable probe.

Hard constraints:

• full is not a discovery default. Use it only for extract or a one-result quick answer.
• extract follows selection. Do not deep-read every search result by habit.
• Vertical search starts with live schema: never invent sub_domain or --sdp.

Effort ladder

Commands

# Light probe
<cmd> search "Cloudflare Workers 2026" --format compact --max-results 5

# Standard probe: discover, then deep-read selected winners
<cmd> search "WebGPU browser support 2025" --format compact --max-results 8
<cmd> extract "https://developer.mozilla.org/en-US/docs/Web/API/WebGPU_API"

# Sample probe: peek before committing to extraction
<cmd> search "Rust async runtime comparison" --format snippet --max-results 3 --max-chars 500

# Deep probe: compare several angles without rereading duplicate URLs
<cmd> batch_search \
  --query "Cloudflare Workers deployment" \
  --query "Cloudflare Workers observability" \
  --query "Cloudflare Workers pricing" \
  --format compact --max-results 5

# Quick full: one result, full content
<cmd> search "current US inflation rate" --format full --max-results 1

# Vertical probe: schema first, then structured search
<cmd> get_sub_domains --domains finance,code
<cmd> search "AAPL" --domain finance --sub_domain finance.quote \
  --sdp type=stock,symbol=AAPL,cn_code= --format compact --max-results 3

Options used most often:

• --format compact|snippet|full — search/batch default compact; extract default full.
• --max-results N / --max_results N / -m N — cap results, max 10.
• --max-chars N — snippet character budget, default 500.
• --no-dedup — keep duplicate URLs only when duplicates are meaningful.
• --domain, --sub_domain, --sdp — vertical controls; call get_sub_domains first.
• --reader auto|local|remote|anysearch — extract body backend. auto (default) prefers local readability when installed, else tries remote readers in series, else the AnySearch API; anysearch forces the API. See references/payload-control.md.

--sdp accepts key=value pairs or JSON. Params marked required must all be passed; if a required value is unavailable, pass an empty string (key=) rather than omitting the key.

Key recovery branch

Normal searches use anonymous access or the saved key pool automatically. auto_register is on by default: if no active key can serve a probe, the CLI creates a throwaway account and key for you and stores them locally — so most access failures self-heal without agent action. Step in only when that itself fails or the user wants to manage keys:

1. Run <cmd> keys status to see the pool.
2. If auto-register failed or the user wants explicit control, run <cmd> register, or keys config --auto_register false to turn the default off, then retry.
3. Repeat the original smallest suitable probe.
4. Never print full API keys in the final answer.

For key paths, rotation, manual seeding, and persistent auto-register, read references/keys.md.

References

• Payload controls: references/payload-control.md
• Key pool details: references/keys.md
• Static vertical catalog: references/domains.md

Call get_sub_domains live when vertical precision matters; the static catalog is only a convenience snapshot.