# Nano Web Search

> AI-powered web search via NanoGPT API with multiple providers (linkup, tavily, exa, kagi, perplexity, valyu, brave). Supports searchResults, sourcedAnswer, and structured output formats.

- Skill: `modbender/nano-web-search` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add modbender/nano-web-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/nano-web-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/nano-web-search

---


# 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](https://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']}")
```