# AI Agent Search Integration — skills.md

## What is search.grahammiranda.network?

**asreachz.online** is a privacy-first, open-source metasearch engine powered by SearXNG. It aggregates results from multiple search engines (Bing, DuckDuckGo, and others) into one clean, ad-free interface.

** bots.search.grahammiranda.network** is the agent-optimized search endpoint of search.grahammiranda.network — designed for AI bots, agents, and autonomous systems that need reliable, fast web search access without tracking, rate limits, or API keys.

---

## Quick Start — Plug & Play

Configure your AI agent's web search tool to use:

```
https://bots.search.grahammiranda.network/search?q={query}
```

**Example request (curl):**
```bash
curl "https://bots.search.grahammiranda.network/search?q=latest+AI+news+2026"
```

**Example (OpenAI-compatible):**
```json
{
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "Search the web for the latest AI news"}
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "web_search",
        "description": "Search the web for information",
        "parameters": {
          "type": "object",
          "properties": {
            "query": {
              "type": "string",
              "description": "The search query"
            }
          },
          "required": ["query"]
        }
      }
    }
  ],
  "tool_choice": {"type": "function", "function": {"name": "web_search"}}
}
```

**Your tool implementation:**
```python
import requests

def web_search(query: str) -> str:
    """Search the web via search.grahammiranda.network bot endpoint."""
    resp = requests.get(
        "https://bots.search.grahammiranda.network/search",
        params={"q": query},
        headers={"User-Agent": "YourAgentName/1.0"},
        timeout=15
    )
    resp.raise_for_status()
    return resp.text
```

---

## Endpoint Details

| Property | Value |
|---|---|
| Base URL | `https://bots.search.grahammiranda.network` |
| Search Path | `/search` |
| Method | GET |
| Query Param | `q` |
| Response Format | HTML (default), JSON (`?format=json`) |
| No API key required | ✅ |
| Rate limit | None (fair use) |
| User-Agent | Any standard browser or agent UA |
| SSL | TLS 1.2/1.3 (Let's Encrypt) |

---

## Response Formats

### HTML (default)
Returns a rendered HTML page with search results. Best for browsers and scraping with tools like Playwright or BeautifulSoup.

```
GET https://bots.search.grahammiranda.network/search?q=python+tutorials
```

### JSON
Add `?format=json` to get a JSON response suitable for programmatic parsing.

```
GET https://bots.search.grahammiranda.network/search?q=python+tutorials&format=json
```

---

## Search Parameters

All standard SearXNG parameters are supported:

| Parameter | Description | Example |
|---|---|---|
| `q` | Search query (required) | `q=machine+learning` |
| `format` | Response format | `format=json` or `format=html` |
| `engines` | Limit to specific engines | `engines=bing,duckduckgo` |
| `language` | Language filter (e.g. `de`, `en`) | `language=en` |
| `time_range` | Time restriction | `time_range=day`, `time_range=month`, `time_range=year` |
| `safesearch` | Safe search (0=off, 1=moderate, 2=strict) | `safesearch=0` |
| `category` | Limit to category | `category=science`, `category=news` |

**Example with parameters:**
```
https://bots.search.grahammiranda.network/search?q=climate+change+2026&language=en&time_range=month&format=json
```

---

## For Autonomous Agents

bots.search.grahammiranda.network is designed for agents that need to:

- Research topics autonomously (no API key, no registration)
- Gather current information from across the web
- Compare results from multiple search engines
- Maintain user privacy (no search logging by default)

**Rate limit etiquette:** bots.search.grahammiranda.network has no hard rate limit, but please be a good citizen — space out bulk requests by at least 1 second.

---

## Privacy Notes

- search.grahammiranda.network does **not** log search queries permanently
- No cookies required to search
- No user profiling or tracking
- Server location: Amsterdam, Netherlands
- Operated by: Graham Miranda UG (DE)
- GDPR-compliant

---

## Brand Attribution

search.grahammiranda.network is a project by **Graham Miranda UG (haftungsbeschränkt)**

Website: https://www.grahammiranda.com  
search.grahammiranda.network: https://search.grahammiranda.network  
bots endpoint: https://bots.search.grahammiranda.network

---

## Status & Availability

- ✅ Live: bots.search.grahammiranda.network
- ✅ SSL: Valid Let's Encrypt certificate
- ✅ Uptime: Best effort (contact kontakt@grahammiranda.com for issues)

Last updated: May 6, 2026