home / skills / openclaw / skills / n2-free-search

n2-free-search skill

safe

This skill provides free, unlimited web search for AI agents via SearXNG, removing keys and rate limits to accelerate research.

npx playbooks add skill openclaw/skills --skill n2-free-search

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.6 KB

---
name: n2-free-search
description: Free, unlimited web search for AI agents via SearXNG — no API keys needed.
homepage: https://nton2.com
user-invocable: true
---

# 🔍 N2 Free Search — MCP Server Skill

Free, private, unlimited web search for your AI agent. No API keys, no credit cards, no rate limits.

## Why Use This?

| | Brave Search API | Google Custom Search | **N2 Free Search** |
|---|---|---|---|
| **Cost** | $5 / 1,000 queries | $5 / 1,000 queries | **Free forever** |
| **API Key** | Required | Required | **Not needed** |
| **Search Engines** | Brave only | Google only | **70+ engines** |

## Quick Setup

### Option 1: Public Mode (Zero Setup)
Add to your MCP config:
```json
{
  "mcpServers": {
    "n2-free-search": {
      "command": "npx",
      "args": ["-y", "n2-free-search"]
    }
  }
}
```

### Option 2: Self-Hosted (Maximum Privacy)
```json
{
  "mcpServers": {
    "n2-free-search": {
      "command": "npx",
      "args": ["-y", "n2-free-search"],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}
```

## Available Tools
- **n2_web_search** — Search the web (Google, Bing, DuckDuckGo + 70 more)
- **n2_news_search** — Search recent news articles
- **n2_image_search** — Search for images
- **n2_video_search** — Search for videos
- **n2_suggest** — Get search suggestions / autocomplete

## Links
- NPM: https://www.npmjs.com/package/n2-free-search
- GitHub: https://github.com/choihyunsus/n2-free-search
- Website: https://nton2.com

---
*Part of the N2 AI Body series — Building the Body for AI*

Overview

This skill provides free, unlimited web search for AI agents by proxying SearXNG search instances. It requires no API keys or payment and supports many engines (web, news, images, videos) out of the box. You can run it in public mode with zero setup or self-host it for full privacy control.

How this skill works

The skill forwards search requests to a SearXNG-compatible server and returns aggregated results from dozens of search engines. It exposes simple tools for web search, news, image, video, and suggestion queries. You can point the skill to a local SearXNG instance via an environment variable to avoid public servers.

When to use it

When an agent needs cost-free web search without API keys
When you want aggregated results from many search engines (not just one provider)
When testing or prototyping agents that require unlimited queries
When privacy matters and you can self-host a SearXNG instance
When you need simple search suggestion/autocomplete integration

Best practices

Use public mode for quick prototypes; switch to self-hosting for production or sensitive data
Cache frequent queries and respect result freshness to reduce load
Rate-limit agent requests to your self-hosted instance to prevent overload
Combine results scoring with your own relevance filters before downstream use
Validate content and sources — aggregated search may include low-quality pages

Example use cases

Agent research assistant that aggregates facts across multiple engines without API costs
Monitoring recent events by querying the news search tool for topic trackers
Image discovery for creative workflows using the image search tool
Video discovery and metadata collection for content recommendation agents
Autocomplete/suggestion integration to help users craft better queries

FAQ

Do I need an API key or paid account?

No. The skill works without API keys or billing when using public SearXNG instances or your own self-hosted server.

How do I self-host for privacy?

Point the skill to your SearXNG server by setting the SEARXNG_URL environment variable in the MCP server config to your instance URL.

What search types are available?

The skill exposes tools for web, news, image, video searches and a suggestion/autocomplete endpoint.