# Een webzoektool voor AI-agents die de paginatekst terugbrengt

> Geef een AI-agent een webzoektool met gerangschikte resultaten en pagina's als Markdown, plus toolschema, zoekbudgetten en kosten. Geen KYC, betalen met crypto.

- URL: https://llmwebsearch.com/nl/use-cases/ai-agents/
- Laatst bijgewerkt: 2026-10-22
- Uitgever: LLMWebSearch (https://llmwebsearch.com)

Een agent die kan zoeken maar niet lezen, gokt op basis van snippets. Geef hem één tool die beide doet: hij doorzoekt het live web en geeft de eerste pagina's terug als schone Markdown, genummerd zodat het model ze kan citeren.

**Snel antwoord — Hoe geef ik een AI-agent een webzoektool die paginacontent teruggeeft?**

Verpak een webzoek-API als een tool die een zoekopdracht aanneemt en genummerde bronnen met hun paginatekst teruggeeft. **LLMWebSearch** doet dit in één aanroep: gerangschikte resultaten uit een live zoekopdracht, met de eerste 3 pagina's gelezen als Markdown, voor één credit. Prijzen beginnen bij US$ 9,25 voor 5.000 zoekopdrachten en dalen tot US$ 1,20/1K zoekopdrachten. Zonder KYC; betalen met crypto.

## LLMWebSearch als agenttool

| Attribuut | Waarde |
| --- | --- |
| Tool | `web_search(query, recent)` roept `POST https://llmwebsearch.com/api/v1/search` aan |
| Retourneert | Tot 20 gerangschikte resultaten; de eerste 3 met hun paginatekst in Markdown |
| Lengtebeheer | `max_chars` per pagina, `read` voor het aantal pagina's, `max_results` voor de lijst |
| Kosten | Eén credit betaalt één zoekopdracht: tot 20 gerangschikte resultaten, waarbij de pagina's van de eerste 3 worden gelezen en als Markdown teruggegeven. Het lezen van 4 tot 10 pagina's kost 2 credits. Een call die op een fout eindigt, kost niets |
| Filters | Kies het land en de taal van de resultaten, een tijdsbereik (afgelopen dag, week, maand of jaar), web- of nieuwsresultaten, en domeinen die je wilt opnemen of uitsluiten |
| Kant-en-klare integraties | [MCP-server](https://llmwebsearch.com/nl/docs/mcp/), [OpenAI function calling](https://llmwebsearch.com/nl/docs/openai/), [LangChain en LlamaIndex](https://llmwebsearch.com/nl/docs/langchain/), [n8n](https://llmwebsearch.com/nl/docs/n8n/), [OpenClaw](https://llmwebsearch.com/nl/docs/openclaw/) |

## Waarom heeft een agent paginatekst nodig en niet alleen snippets?

Omdat het antwoord zelden in de snippet staat. Een resultatenpagina geeft een titel en een of twee regels die de zoekmachine heeft gekozen. Het getal, de datum of de regel waar je gebruiker naar vroeg, staat verderop op de pagina.

Een agent die alleen snippets ziet, heeft twee slechte opties. Hij kan antwoorden op basis van een fragment en het risico lopen fout te zitten, of hij kan een tweede tool aanroepen om elke pagina op te halen. De tweede optie verdubbelt de round trips en de tool-definities.

Met LLMWebSearch komen de eerste pagina's al gelezen binnen. Navigatie, advertenties en cookiebanners zijn verwijderd, zodat het model zijn tokens aan inhoud besteedt. De overige resultaten behouden hun snippets, die het model helpen beslissen of het opnieuw moet zoeken.

## Hoe moet de zoektool worden gedefinieerd?

Houd het schema klein: één verplichte `query` en hooguit een of twee schakelaars. Modellen roepen eenvoudige tools betrouwbaarder aan. Het onderstaande voorbeeld biedt een `recent`-flag die aan `time_range=month` is gekoppeld; al het overige staat vast in je code.

De functie retourneert platte tekst, geen JSON. Elke bron begint met een nummer, een titel en een URL, gevolgd door de Markdown. Die opbouw maakt citaties zoals [2] natuurlijk voor het model.

Als je agent al een tool met de naam `web_search` meelevert, zoals Claude Code en OpenClaw doen, geef de jouwe dan een andere naam, bijvoorbeeld `search_web`. Twee tools met dezelfde naam verwarren het model.

*Python: een web_search-tool voor OpenAI-style function calling*

```python
import json
import os

import requests

API = "https://llmwebsearch.com/api/v1/search"
HEADERS = {"Authorization": "Bearer " + os.environ["LLMWEBSEARCH_API_KEY"]}

# Tool definition in the OpenAI function-calling format; most agent frameworks accept the same JSON schema.
WEB_SEARCH_TOOL = {
    "type": "function",
    "function": {
        "name": "web_search",
        "description": "Search the live web. Returns numbered sources; the first ones include the page text in Markdown.",
        "parameters": {
            "type": "object",
            "properties": {
                "query": {"type": "string", "description": "A short search query, 3 to 8 words"},
                "recent": {"type": "boolean", "description": "True to keep only results from the past month"},
            },
            "required": ["query"],
        },
    },
}


def web_search(query, recent=False, read=3, max_chars=4000):
    """Run one search (1 credit with read <= 3) and return compact text the model can cite."""
    body = {"q": query, "max_results": 5, "read": read, "max_chars": max_chars}
    if recent:
        body["time_range"] = "month"
    resp = requests.post(API, headers=HEADERS, json=body, timeout=60)
    resp.raise_for_status()
    lines = []
    for r in resp.json()["results"]:
        lines.append(f"[{r['position']}] {r['title']} — {r['url']}")
        if r.get("content_status") == "ok":
            lines.append(r["content"])
        else:
            lines.append(r.get("snippet", ""))
        lines.append("")
    return "\n".join(lines)


def run_tool_call(call):
    """Execute a tool call returned by the model and give back the text for the tool message."""
    args = json.loads(call["function"]["arguments"])
    return web_search(args["query"], recent=args.get("recent", False))
```

## Wanneer moet een agent zoeken, en hoe vaak?

Zoek wanneer het antwoord afhangt van feiten die veranderen of die het model niet kan weten. Prijzen, versies, wetten, dienstregelingen en recente gebeurtenissen komen in aanmerking. Definities en stabiele kennis meestal niet.

Schrijf die regel in de system prompt en voeg een budget toe. Drie gewoonten helpen:

- **Plan voordat je zoekt.** Vraag het model eerst zijn zoekopdrachten te formuleren. Twee precieze zoekopdrachten verslaan vijf vage.
- **Beperk het aantal aanroepen.** Sta bijvoorbeeld vier zoekopdrachten per beurt van de gebruiker toe. Verhoog de limiet alleen voor onderzoekstaken.
- **Stop wanneer bronnen het eens zijn.** Als drie onafhankelijke pagina's hetzelfde zeggen, kan de agent antwoorden.

## Hoe houd ik het contextvenster onder controle?

Drie parameters bepalen hoeveel tekst het model bereikt. `read` stelt in hoeveel pagina's worden gelezen, van 0 tot 10. `max_chars` begrenst elke pagina, van 500 tot 50.000 tekens. `max_results` stelt in hoeveel resultaten worden vermeld, van 1 tot 20.

Voor een chat-agent levert `read=3` met `max_chars=4000` ongeveer 12.000 tekens paginatekst per zoekopdracht op. Dat laat ruimte voor meerdere zoekopdrachten in één gesprek. Voor een onderzoekstaak die gaandeweg samenvat, zijn langere pagina's prima.

Het veld `word_count` vertelt hoe lang de volledige pagina was voordat deze werd afgekapt. De agent kan daarmee beslissen of hij meer ophaalt met het [extract endpoint](https://llmwebsearch.com/nl/docs/extract/).

## Wat gebeurt er als een pagina niet kan worden gelezen?

Het resultaat komt nog steeds terug, met titel, URL en snippet, maar zonder inhoud. Een veld `content_status` vermeldt waarom.

- `blocked_by_robots`: de robots.txt van de site staat onze reader niet toe.
- `blocked_by_site_policy`: Een site die Content-Signal: ai-input=no in zijn robots.txt zet, houdt zijn pagina's buiten de inhoud van je resultaten.
- `target_refused`: de site antwoordde met een weigering; de status staat in `target_status`.
- `fetch_failed` of `fetch_timeout`: de pagina laadde niet op tijd.

Wanneer een site onze reader weert, komt het resultaat terug zonder inhoud en met de status van de site: we lossen nooit CAPTCHA's op, loggen nooit in op accounts en werken nooit om een blokkade of een paywall heen. Zeg de agent de snippet of een andere bron te gebruiken wanneer een pagina leeg terugkomt. De zoekopdracht zelf kost nog steeds één credit, wat er ook met elke pagina is gebeurd.

## Waarom niet de zoektool gebruiken die in het model is ingebouwd?

Ingebouwde tools zijn handig, maar geven je minder controle. Op 22 oktober 2026 kost OpenAI's tool `web_search` $10 per 1.000 aanroepen plus de zoekinhoud die als input-tokens wordt gefactureerd. De web search van Anthropic's Claude kost ook $10 per 1.000 zoekopdrachten plus tokenkosten. Gemini 3 grounding bevat 5.000 gratis zoekopdrachten per maand op het betaalde abonnement, daarna kost het $14 per 1.000.

Deze tools retourneren meestal een geschreven antwoord met citaties, niet de ruwe pagina's. Ze binden je zoekopdracht ook aan één modelleverancier. Een losstaande tool werkt met elk model en laat je de lengte van elke pagina instellen. De [vergelijking van ingebouwde tools](https://llmwebsearch.com/nl/compare/built-in-web-search-tools/) bevat de volledige tabel.

## Wat kost het om een agent op LLMWebSearch te draaien?

Eén credit per zoekopdracht wanneer `read` 3 of minder is. Een assistent die door een team wordt gebruikt en 100 vragen per dag beantwoordt met 4 zoekopdrachten per vraag, draait ongeveer 12.000 zoekopdrachten per maand. 25.000 zoekopdrachten voor US$ 41,25 dekt die maand en het grootste deel van de volgende.

Een coding agent die door één developer wordt gebruikt, zoekt misschien 20 keer per dag, of ongeveer 600 keer per maand. 5.000 zoekopdrachten voor US$ 9,25 gaat dan meerdere maanden mee, omdat credits nooit verlopen. De [kostengids](https://llmwebsearch.com/nl/guides/ai-agent-web-search-cost/) toont de rekensom voor grotere workloads.

## Welke pack past bij een agent?

Prototype op 5.000 zoekopdrachten; stap over naar 25.000 zoekopdrachten of 100.000 zoekopdrachten zodra de agent dagelijks in gebruik is.

| Plan | Aantal | Prijs | Prijs per eenheid |
| --- | --- | --- | --- |
| Probeer | 5.000 zoekopdrachten | US$ 9,25 | US$ 1,85/1K zoekopdrachten |
| Builder | 25.000 zoekopdrachten | US$ 41,25 | US$ 1,65/1K zoekopdrachten |
| Productie | 100.000 zoekopdrachten | US$ 145 | US$ 1,45/1K zoekopdrachten |

In elk plan: Top 3 pagina's gelezen als Markdown · Filters voor land, taal, tijd en domein · Mislukte calls worden niet in rekening gebracht · Credits verlopen nooit

**Voordat je betaalt**

- Minimale storting US$ 25. Stort één keer in crypto en koop daarna elk plan vanuit je saldo.
- Saldo op je account verloopt niet en koopt zoekcredits wanneer je maar wilt. Wanneer een pack goedkoper is dan de minimale top-up, krijg je het deel dat je alleen hebt betaald om dat minimum te bereiken op verzoek terug binnen 30 dagen na betaling, in USDT of USDC, mits het nog niet is besteed. De rest van een saldo wordt niet terugbetaald, tenzij de wet dat vereist.
- Bijgeschreven zodra je betaling op de blockchain is gecontroleerd. Gebruikelijke bevestigingstijd van het netwerk: BTC ≈ 20 min · USDT TRC-20 ≈ 1 min · USDT ERC-20 ≈ 5 min · USDC ERC-20 ≈ 5 min · ETH ≈ 5 min · SOL ≈ 1 min · LTC ≈ 15 min

## AI-agents: veelgestelde vragen

### Kan ik LLMWebSearch toevoegen aan Claude Desktop, Cursor of Claude Code?

Ja, via een kleine MCP-server die de zoekopdracht als tool aanbiedt. De [MCP-pagina](https://llmwebsearch.com/nl/docs/mcp/) bevat de code en de clientconfiguratie.

### Werkt de tool met andere modellen dan die van OpenAI?

Ja. Het bovenstaande schema is gewoon JSON Schema, dat Anthropic, Google, Mistral en opensource-frameworks met kleine wijzigingen accepteren. De tool roept alleen ons HTTPS-endpoint aan.

### Hoe voorkom ik dat een agent te veel zoekt?

Tel de aanroepen in je tool-wrapper en retourneer een korte melding zodra het budget op is. Zet het budget ook in de system prompt, zodat het model erop plant.

### Kan de tekst van een pagina instructies aan mijn agent geven?

Het kan het proberen. Behandel paginatekst als data: zeg het model in de system prompt instructies in bronnen te negeren, en laat een bron nooit zelfstandig acties starten.

## Bronnen

1. [API-prijzen (web search tool)](https://developers.openai.com/api/docs/pricing) — OpenAI (read 2026-10-22)
2. [Prijzen (web search tool)](https://platform.claude.com/docs/en/about-claude/pricing) — Anthropic (read 2026-10-22)
3. [Prijzen van de Gemini Developer API](https://ai.google.dev/gemini-api/docs/pricing) — Google (read 2026-10-22)

---

LLMWebSearch: LLMWebSearch is een webzoek-API voor AI-agents die gerangschikte resultaten teruggeeft met de inhoud van de belangrijkste pagina's als Markdown, betaald met crypto zonder ID-upload. Voorafbetaalde credits vanaf US$ 1,20/1K zoekopdrachten verlopen nooit. Zonder KYC — geen ID, geen selfie, geen documenten. Betalen met crypto.
