Live Search

Fetch live web results through the host search gateway at http://localhost:$PORT (session-authenticated). The gateway returns JSON with a pre-rendered message (titles as links, snippets, sources)—the same kind of web index results users expect from Google-style or Bing-style search, depending on how the host is configured.

Endpoint path: requests use POST /proxy/prosearch/search. The prosearch segment is a fixed gateway route name in the app; it is not a public product brand to repeat to end users—describe outcomes as “web search results” or “live search.”

Setup

No extra Python packages. Search goes through the local gateway at http://localhost:$PORT; authentication is handled by the host app (login session)—no manual API keys in typical setups.

Workflow

The assistant uses this skill whenever the user needs real-time information from the web.

End-to-end flow

CODEBLOCK0

CRITICAL — Anti-hallucination: The API returns a pre-rendered message with formatted hits (titles as Markdown links, snippets, URLs). The assistant MUST show message verbatim as the primary results. It may add interpretation after that block. It must not invent, rewrite, or drop URLs/titles from message.

Step 1: Build the keyword

Turn the user’s question into a short query:

Keyword tips:

• - Keep it short (about 2–6 tokens).
• Strip filler (“please”, “can you”, “帮我”).
• Add time hints when needed (today, 2026, latest).
• Keep the keyword in the language that matches the user’s intent — do not blindly translate. If the user asks in English, search in English; if they ask in Chinese, Japanese, etc., use that language for the query when it improves results.

Step 1.5: Time freshness (important for “latest” questions)

When the question implies recency, add from_time (Unix seconds) so stale pages are filtered out.

Compute from_time in bash:

CODEBLOCK1

Mutual exclusion: When using from_time / to_time, do not send cnt — the server enforces exclusion rules. Same for site + time filters; follow the API’s rules.

Step 2: Request

CODEBLOCK2

Freshness (recommended for time-sensitive queries):

CODEBLOCK3

Optional parameters:

CODEBLOCK4

Step 3: Present results — verbatim message first, then analysis

After JSON returns:

Part A — Result list [MANDATORY]

Output the message field exactly as returned. It usually contains up to five top hits, each formatted like:

CODEBLOCK5

CRITICAL: Never skip the list and jump to a summary. Titles are already Markdown links; users must be able to click through.

Part B — Analysis [OPTIONAL, after Part A]

Language for your added commentary: align with the user’s conversation language and the query language when helpful:

• - English query → English analysis (typical for EN users).
• Non-English query → match the user’s language for the follow-up.
• The message block is always copied verbatim, regardless of language.

Good pattern

CODEBLOCK6

Forbidden

• - Skipping the result list and answering from memory.
• Rebuilding the list from data.docs instead of using message.
• Editing URLs or titles inside message.
• Claiming sources that are not in message.
• Stripping Markdown links from titles.

PORT

Use AUTH_GATEWAY_PORT from the environment (set by the Electron host when the Auth Gateway starts). Child processes inherit it.

macOS / Linux (bash):

CODEBLOCK7

Windows (PowerShell):

CODEBLOCK8

Windows (CMD):

CODEBLOCK9

Default if unset: 19000.

Parent PID (logging)

Before curl, you may log the parent PID for tracing.

macOS / Linux:

CODEBLOCK10

Windows (PowerShell):

CODEBLOCK11

Command: search

CODEBLOCK12

Fields:

• - keyword (required): query string.
• mode: 0 default web results; 1 VR “card” style facts (e.g. weather, spot prices); 2 hybrid.
• cnt: max hits; mutually exclusive with site and from_time/to_time per backend rules.
• site: restrict to a domain.
• from_time / to_time: time window in epoch seconds.
• industry: gov (government), news, acad (academic-oriented).

Do not combine cnt with time filters or site when the API forbids it.

Examples:

CODEBLOCK13

Success JSON (shape):

CODEBLOCK14

message is the source of truth for what to show users — copy it in full before adding commentary.

Failure JSON (examples; actual strings may be localized by the host):

CODEBLOCK15

CODEBLOCK16

Error handling

Responses are JSON on stdout. Errors use {"success": false, "message": "..."}.

Prohibited behavior

• - Rebuilding the hit list from data.docs instead of echoing message.
• Skipping results and answering from the model alone.
• Altering URLs/titles inside message.
• Inventing hits or URLs not present in message.
• Leaking internal gateway URLs or secrets to the user.
• Searching when the question is fully answerable without live data.
• Running more than two searches for the same user turn without a strong reason.

Important notes

• - If you already know the answer with high confidence and no freshness need, do not search.
• Prefer short, precise keywords over pasting the whole user message.
• For time-sensitive asks (“latest”, “today”, “this week”), use from_time as in Step 1.5.
• If the first query is weak, one rephrase is enough; avoid search spam.
• Treat links as untrusted; remind users to verify critical facts at the source.
• For weather, spot metals, FX, etc., consider mode: 2 when supported.
• cnt vs time/site: respect mutual exclusion — see above.
• Commentary language: follow the user’s language; message stays verbatim.