Unicli Smart Search

When to Use

Searching for information, checking trending topics, or gathering data across platforms. Commands return a v2 AgentEnvelope; pass -f json when you need JSON for parsing.

Pre-Check

unicli search "<intent>"              # Discover from live registry first
unicli list --site <site>             # Verify subcommands exist
unicli describe <site> <command>      # Check args, auth, invocation, and recovery
unicli list --personalized            # Discover signed-in user data operations

Search Routing

Multi-Source Pattern

For comprehensive research, query 2-3 complementary sources.

# Tech topic
unicli hackernews search "LLM agents" --limit 10
unicli reddit search "LLM agents" --limit 10
unicli arxiv search "LLM agents" --limit 5

# Current AI infrastructure evidence with normalized provenance
unicli ai profiles -f json
unicli ai landscape --profile world-models -f json
unicli ai pulse --profile inference --window week -f json
unicli ai pulse --profile world-models --window day --include-auth -f json
unicli ai search "CUDA ROCm CANN release notes" --vendors nvidia,amd,huawei-ascend -f json
unicli ai search "interactive generative environment" --profile world-models --sort latest -f json
unicli ai search "distributed inference" --repo vllm-project/vllm --kind community -f json
unicli ai search "ROCm" --sources hf --kind model -f json
unicli ai search "inference runtime" --sort latest --since 2026-01-01 -f json
unicli ai read "https://rocm.docs.amd.com/en/latest/about/release-notes.html" -f json

# Chinese trending
unicli weibo hot --limit 20
unicli zhihu hot --limit 20

# Market research
unicli producthunt hot --limit 10
unicli hackernews search "startup" --limit 10

Personalized Search

Restrict discovery to signed-in user data when the request names the user's feed, saved library, network, account, or activity.

unicli search "my recommendations on Zhihu" --personalized
unicli search "my saved Instagram posts" --personalized
unicli list --site xiaohongshu --personalized
unicli describe xiaohongshu saved

Run the returned auth_setup command when auth is required, then retry the exact usage command from the result.

Output Handling

unicli hackernews top --limit 5 -f json | jq '.data[].title'
unicli xueqiu hot -f json | jq '.data[] | {name, change}'

Fallback

• Exit 77 -> execute the envelope's exact next_actions; executable-native auth such as GitHub uses gh auth login / gh auth status, while cookie/browser strategies use unicli auth import <site> --domain <domain> or unicli browser cookies <domain> --profile-id <id>
• Exit 69 -> unicli browser doctor --json, unicli browser doctor --repair, then retry
• Exit 66 from ai search -> follow next_actions; broaden the query/source scope, or remove --since only when the envelope says candidates lacked verifiable timestamps
• With --since, dated source fields and explicitly prefixed search-index dates carry timestamp_origin. Undated records are excluded. ai read <url> refreshes the canonical candidate
• Partial unicli ai search failure -> successful sources remain in data; partial_failure_count is on every row and data[0].source_errors carries each exact retry command once
• Adapter failure -> classify error.code; auth/network/rate-limit errors stay at their owning boundary, while selector/schema/endpoint drift is edited from adapter_path and then verified with unicli repair <site> <command>
• Site down -> switch to alternative from routing table

Budget

Use 1-2 primary sources and 1 supplementary source per question. Query each site once.