Search1API CLI

Web search and content retrieval via the s1 command-line tool (search1api-cli).

Prerequisites

Before using any command, check if s1 is available. If not, guide the user to install it:

npm install -g search1api-cli

An API key is also required. Get one at https://search1api.com, then configure:

s1 config set-key <your-api-key>

Or set the environment variable SEARCH1API_KEY.

If a command fails with "command not found" or an auth error, remind the user to complete these setup steps before retrying.

When to use

| User intent | Command | |---|---| | Shares a URL / link → read and summarize | s1 crawl <url> | | Wants to search the web | s1 search "<query>" | | Wants news | s1 news "<query>" | | Wants to explore a site's links | s1 sitemap <url> | | Wants trending topics | s1 trending <service> | | Wants deep thinking on a problem | s1 reasoning "<content>" | | Wants to check remaining credits | s1 balance |

Dynamic tuning

Adapt parameters to user intent — don't just use defaults:

Quick lookup ("search for X", "what is X") → -n 5, no crawl
Deep research ("research X thoroughly", "comprehensive analysis") → -n 15, then crawl top 3–5 results with separate s1 crawl calls
User specifies a number ("find 10 articles") → match it with -n
Recency signals ("latest", "recent", "this week") → -t day or -t month
Domain-specific ("search on Reddit", "find GitHub repos") → -s reddit, -s github, etc.
Site-scoped ("only from arxiv.org") → --include arxiv.org
Chinese queries → consider -s baidu for better results

Commands

search

s1 search "<query>" [options]

| Option | Description | Default | |---|---|---| | -n, --max-results <N> | Number of results (1–50) | 10 | | -s, --service <engine> | Search engine | google | | -c, --crawl <N> | Crawl N results for full content | 0 | | --include <sites...> | Only include these sites | | | --exclude <sites...> | Exclude these sites | | | -t, --time <range> | day, month, year | | | --json | Raw JSON output | |

Search engines: google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia

news

s1 news "<query>" [options]

Same options as search. News services: google, bing, duckduckgo, yahoo, hackernews. Default service: bing.

When user asks for breaking/latest news, always add -t day.

crawl

s1 crawl <url>

Extracts clean content from a URL. Use this whenever the user shares a link.

sitemap

s1 sitemap <url>

Returns all discovered links on a URL/domain.

reasoning

s1 reasoning "<content>"
# or
s1 reason "<content>"

Deep thinking powered by DeepSeek R1. Use for complex analytical questions.

balance

s1 balance

Shows remaining API credits.

Workflows

Deep research

s1 search "<topic>" -n 15 → get broad results
s1 crawl <url> → crawl the top 3–5 most relevant URLs from results
Synthesize all gathered content into a coherent answer with source citations

URL summarization

s1 crawl <url> → get the page content
Summarize or answer questions based on the content

Trending deep dive

s1 trending github -n 10 → discover hot topics
s1 search "<interesting topic>" -t day → search for details
s1 crawl <url> → read full article if needed

Output handling

By default, commands produce human-readable formatted output
Add --json to any command for raw JSON (useful for programmatic processing)
After retrieving results, always summarize and synthesize the information for the user — don't just dump raw output

References

Usage examples — read for additional patterns