Unifuncs Deep Research

UniFuncs Deep Research Skill

Use this tool for in-depth analysis and long-form report generation (10,000 words or more). It is suitable when the task requires multiple rounds of searching and reading, or when the user explicitly asks for deep research/deep digging. This is a relatively expensive operation and usually takes 3-10 minutes.

Mandatory second confirmation: Before invoking any Deep Research script (deep-research-report.py, deep-research-create-task.py, etc.), you must pause and get explicit user confirmation in the same conversation after you have summarized the request. In one message, briefly restate: (1) the research topic / question to be sent, (2) that it is long-running (~3–10 minutes) and higher cost than deep search, and (3) any key options you plan to use (e.g. output-type, model) if non-default. Do not run the scripts until the user clearly confirms (e.g. “确认 / 可以 / yes / proceed”). If the user adjusts the topic or options, repeat this confirmation step once more before running.

If the intent is still ambiguous after your summary, ask one short clarifying question before offering the confirmation summary.

First-Time Setup

1. Go to to get your API key. 2. Set the environment variable: export UNIFUNCS_API_KEY="sk-your-api-key"

When to Use

You need deep, structured research on a topic. You want a report-style output instead of search report, if the user has not explicitly requested a deep research, consider using unifuncs-deep-search instead. Typical completion time is around 3-10 minutes, depending on topic complexity.

Usage Guidelines

1. Complete Mandatory second confirmation above. 2. Then use one of the entries below as appropriate.

The skills is split into 3 independent entries:

1) Sync report: deep-research-report.py

python3 deep-research-report.py "query"

2) Async task creation: create_task

python3 deep-research-create-task.py "query"

This returns task_id.

3) Async task query: query_task

python3 deep-research-query-task.py "task_id"

Options

usage: deep-research-report.py [-h] [--model {u1,u1-pro,u2,u3}]
                               [--stream | --no-stream]
                               [--timeout TIMEOUT]
                               [--stream-file STREAM_FILE]
                               [--read-stream-file]
                               [--introduction INTRODUCTION]
                               [--plan-approval]
                               [--reference-style {link,character,hidden}]
                               [--max-depth MAX_DEPTH]
                               [--domain-scope DOMAIN_SCOPE]
                               [--domain-blacklist DOMAIN_BLACKLIST]
                               [--output-type {report,summary,wechat-article,xiaohongshu-article,toutiao-article,zhihu-article,zhihu-answer,weibo-article}]
                               [--output-prompt OUTPUT_PROMPT]
                               [--output-length OUTPUT_LENGTH]
                               [--raw-response]
                               [query]
UniFuncs Deep Research client
positional arguments:
  query                 User query sent to Deep Research.
options:
  -h, --help            show this help message and exit
  --model {u1,u1-pro,u2,u3}
                        Model to use (default: u3).
  --stream              Enable streaming output (default).
  --no-stream           Disable streaming and wait for full response.
  --timeout TIMEOUT     Max streaming wait time in seconds (default:
                        1800).
  --stream-file STREAM_FILE
                        Path to persist/read stream chunks. If omitted,
                        temp file is auto-created when writable.
  --read-stream-file    Read and render already received content from
                        --stream-file, without calling API.
  --introduction INTRODUCTION
                        Researcher role/tone introduction.
  --plan-approval       Generate research plan and wait for approval
                        before execution.
  --reference-style {link,character,hidden}
                        Reference marker style.
  --max-depth MAX_DEPTH
                        Maximum research depth.
  --domain-scope DOMAIN_SCOPE
                        Comma-separated domain allowlist.
  --domain-blacklist DOMAIN_BLACKLIST
                        Comma-separated domain blocklist.
  --output-type {report,summary,wechat-article,xiaohongshu-article,toutiao-article,zhihu-article,zhihu-answer,weibo-article}
                        Desired output style (default: report).
  --output-prompt OUTPUT_PROMPT
                        Custom output prompt template.
  --output-length OUTPUT_LENGTH
                        Expected output length hint (default: 10000).
  --raw-response        Print full API response JSON.

Output Types

usage: deep-research-report.py [-h] [--model {u1,u1-pro,u2,u3}]
                               [--stream | --no-stream]
                               [--timeout TIMEOUT]
                               [--stream-file STREAM_FILE]
                               [--read-stream-file]
                               [--introduction INTRODUCTION]
                               [--plan-approval]
                               [--reference-style {link,character,hidden}]
                               [--max-depth MAX_DEPTH]
                               [--domain-scope DOMAIN_SCOPE]
                               [--domain-blacklist DOMAIN_BLACKLIST]
                               [--output-type {report,summary,wechat-article,xiaohongshu-article,toutiao-article,zhihu-article,zhihu-answer,weibo-article}]
                               [--output-prompt OUTPUT_PROMPT]
                               [--output-length OUTPUT_LENGTH]
                               [--raw-response]
                               [query]
UniFuncs Deep Research client
positional arguments:
  query                 User query sent to Deep Research.
options:
  -h, --help            show this help message and exit
  --model {u1,u1-pro,u2,u3}
                        Model to use (default: u3).
  --stream              Enable streaming output (default).
  --no-stream           Disable streaming and wait for full response.
  --timeout TIMEOUT     Max streaming wait time in seconds (default:
                        1800).
  --stream-file STREAM_FILE
                        Path to persist/read stream chunks. If omitted,
                        temp file is auto-created when writable.
  --read-stream-file    Read and render already received content from
                        --stream-file, without calling API.
  --introduction INTRODUCTION
                        Researcher role/tone introduction.
  --plan-approval       Generate research plan and wait for approval
                        before execution.
  --reference-style {link,character,hidden}
                        Reference marker style.
  --max-depth MAX_DEPTH
                        Maximum research depth.
  --domain-scope DOMAIN_SCOPE
                        Comma-separated domain allowlist.
  --domain-blacklist DOMAIN_BLACKLIST
                        Comma-separated domain blocklist.
  --output-type {report,summary,wechat-article,xiaohongshu-article,toutiao-article,zhihu-article,zhihu-answer,weibo-article}
                        Desired output style (default: report).
  --output-prompt OUTPUT_PROMPT
                        Custom output prompt template.
  --output-length OUTPUT_LENGTH
                        Expected output length hint (default: 10000).
  --raw-response        Print full API response JSON.