> ## Documentation Index
> Fetch the complete documentation index at: https://noorle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Search

> AI-optimized internet search with relevance scoring. Find current information across the web.

Web Search provides AI-optimized access to current information across the internet with intelligent result ranking and relevance scoring.

## Key Features

* **Real-time Results** - Access latest information, news, and websites
* **Relevance Scoring** - Results ranked by relevance to query
* **Safe Search** - Automatic filtering of inappropriate content
* **Multiple Search Modes** - General, news, images, academic
* **Source Attribution** - Know where results came from

## How to Enable

### For Agents

1. **Agents** > Select Agent > **Settings**
2. **Capabilities** tab > **Attach Capability**
3. Search for **Web Search**
4. Click **Attach**
5. **Save**

### For MCP Gateways

1. **Gateways** > Select Gateway
2. **Capabilities** tab > **Attach Capability**
3. Search for **Web Search**
4. Click **Attach**
5. **Save**

## Configuration

Web Search has no required configuration. Optional settings in specifications:

```json theme={null}
{
  "web_search": {
    "safe_search": true,
    "results_limit": 10,
    "language": "en"
  }
}
```

### Available Options

| Option          | Default | Effect                       |
| --------------- | ------- | ---------------------------- |
| `safe_search`   | true    | Filter explicit content      |
| `results_limit` | 10      | Max results returned         |
| `language`      | "en"    | Search language              |
| `region`        | "US"    | Region for localized results |

## Usage Examples

### Simple Search

```
"Search for the latest AI research papers"
```

Returns:

```json theme={null}
{
  "results": [
    {
      "title": "...",
      "url": "...",
      "snippet": "...",
      "relevance_score": 0.95,
      "published": "2025-03-20"
    }
  ]
}
```

### News Search

```
"Find recent news about quantum computing"
```

Focuses on news sources with publishing dates and relevance scores.

### Academic Search

```
"Search academic papers on neural networks"
```

Returns peer-reviewed sources and citations.

## Search Modes

<Tabs>
  <Tab title="General">
    Standard web search across all sources.

    ```
    "Search for Python tutorial"
    ```
  </Tab>

  <Tab title="News">
    Recent news and articles with timestamps.

    ```
    "What's the latest in AI safety?"
    ```
  </Tab>

  <Tab title="Images">
    Image search with descriptions and sources.

    ```
    "Find images of machine learning"
    ```
  </Tab>

  <Tab title="Academic">
    Scholarly articles and research papers.

    ```
    "Search academic papers on transformers"
    ```
  </Tab>
</Tabs>

## Resource Limits

| Limit       | Value      | Notes                      |
| ----------- | ---------- | -------------------------- |
| Timeout     | 30 seconds | Per request                |
| Max Results | 10         | Per query                  |
| Max Retries | 3          | Automatic retry on failure |

## Limitations

* Cannot search private sites (login required)
* Rate-limited by search provider
* Some sources may block automated searches
* Results vary by region and language

## Cost

For current pricing details, see [Pricing](https://noorle.com/pricing/).

Monitor in **Account** > **Usage** dashboard.

## Best Practices

### Be Specific

* Good: "Latest PyTorch releases 2025"
* Bad: "Python"

### Use Multiple Queries

Break complex questions into focused searches:

```
Search 1: "Kubernetes deployment best practices"
Search 2: "Kubernetes monitoring tools 2025"
Search 3: "Kubernetes security hardening"
```

### Combine with Code Runner

Use search results with Python to:

* Parse and analyze results
* Extract structured data
* Create summaries
* Generate reports

### Cache Results

For frequently searched topics, consider caching results in Files to avoid repeated queries.

## Troubleshooting

### No Results Found

**Check:**

* Query is specific enough
* Not searching for private/paywalled content
* Try different keywords

### Slow Responses

* Results being processed through AI ranking
* Network latency
* Large result set being filtered

### Missing Recent Results

* Search index may be 24-48 hours behind
* Check different search terms
* Try News mode for very recent information

## Next Steps

* [Code Runner](/use/capabilities/code-runner)
* [Browser - Visual Web Scraping](/use/capabilities/browser)
* [HTTP Client - API Access](/use/capabilities/http-client)