✓ Verified 💻 Development ✓ Enhanced Data

Nano Web Search

AI-powered web search via NanoGPT API with multiple providers (linkup, tavily, exa, kagi, perplexity

Rating: 4.5 (302 reviews)
Downloads: 4,770 downloads
Version: 1.0.0

Overview

AI-powered web search via NanoGPT API with multiple providers (linkup, tavily, exa, kagi, perplexity, valyu, brave).

Complete Documentation

View Source →

NanoGPT Web Search

AI-powered web search via NanoGPT API with multiple providers.

Requirements

python3 - For payload building and output formatting
curl - For HTTP requests
requests Python package - For Python API usage

Setup

Install the requests package:

bash

pip install requests

Set your NanoGPT API key as an environment variable:

bash

export NANOGPT_API_KEY="sk-nano-your-key-here"

Get your API key from nano-gpt.com.

Usage

bash

# Basic search
./search.sh "your query"

# With specific provider
./search.sh "AI trends 2025" --provider tavily

# Deep search
./search.sh "quantum computing" --depth deep

# Search with date filter
./search.sh "climate news" --from-date 2025-01-01 --to-date 2025-02-18

# Sourced answer (synthesized response with citations)
./search.sh "what is RAG" --output-type sourcedAnswer

# JSON output (for scripting)
./search.sh "python tutorials" --json

Providers

linkup (default) - $0.006 standard, $0.06 deep
tavily - $0.008 standard, $0.016 deep
exa - $0.005 base + per-page
kagi - $0.002 web/news, $0.025 search
perplexity - $0.005 flat
valyu - ~$0.0015/result
brave - $0.005 flat

Options

--provider - Search provider (default: linkup)
--depth - Search depth: standard or deep
--output-type - Output format: searchResults, sourcedAnswer, structured
--from-date - Start date filter (YYYY-MM-DD)
--to-date - End date filter (YYYY-MM-DD)
--include-domains - Comma-separated domains to include
--exclude-domains - Comma-separated domains to exclude
--max-results - Max results (provider-specific)
--json - Output raw JSON

Python API

python

from search import NanoWebSearch

# Pass API key explicitly (recommended)
search = NanoWebSearch(api_key="sk-nano-your-key")

# Or use NANOGPT_API_KEY environment variable
search = NanoWebSearch()

results = search.search("AI trends", provider="tavily", depth="deep")
for r in results['data']:
    print(f"{r['title']}: {r['url']}")

Installation

Terminal bash


openclaw install nano-web-search

Copied!

💻Code Examples

export NANOGPT_API_KEY="sk-nano-your-key-here"

export-nanogptapikeysk-nano-your-key-here.txt

Get your API key from [nano-gpt.com](https://nano-gpt.com).

## Usage

./search.sh "python tutorials" --json

searchsh-python-tutorials---json.txt

## Providers

- `linkup` (default) - $0.006 standard, $0.06 deep
- `tavily` - $0.008 standard, $0.016 deep
- `exa` - $0.005 base + per-page
- `kagi` - $0.002 web/news, $0.025 search
- `perplexity` - $0.005 flat
- `valyu` - ~$0.0015/result
- `brave` - $0.005 flat

## Options

- `--provider` - Search provider (default: linkup)
- `--depth` - Search depth: standard or deep
- `--output-type` - Output format: searchResults, sourcedAnswer, structured
- `--from-date` - Start date filter (YYYY-MM-DD)
- `--to-date` - End date filter (YYYY-MM-DD)
- `--include-domains` - Comma-separated domains to include
- `--exclude-domains` - Comma-separated domains to exclude
- `--max-results` - Max results (provider-specific)
- `--json` - Output raw JSON

## Python API

example.sh

# Basic search
./search.sh "your query"

# With specific provider
./search.sh "AI trends 2025" --provider tavily

# Deep search
./search.sh "quantum computing" --depth deep

# Search with date filter
./search.sh "climate news" --from-date 2025-01-01 --to-date 2025-02-18

# Sourced answer (synthesized response with citations)
./search.sh "what is RAG" --output-type sourcedAnswer

# JSON output (for scripting)
./search.sh "python tutorials" --json

example.py

from search import NanoWebSearch

# Pass API key explicitly (recommended)
search = NanoWebSearch(api_key="sk-nano-your-key")

# Or use NANOGPT_API_KEY environment variable
search = NanoWebSearch()

results = search.search("AI trends", provider="tavily", depth="deep")
for r in results['data']:
    print(f"{r['title']}: {r['url']}")