So verwenden Sie die Claude Web Search API

```html

Large Language Models (LLMs) wie Anthropic's Claude haben verändert, wie wir mit Informationen und Technologie interagieren. Ihre Fähigkeit, Text zu verstehen, zu generieren und zu verarbeiten, hat Türen zu unzähligen Anwendungen geöffnet. Eine häufige Einschränkung vieler LLMs ist jedoch ihre Abhängigkeit von statischen Trainingsdaten, was bedeutet, dass ihr Wissen zu einem bestimmten Zeitpunkt eingefroren ist. In einer Welt, in der sich Informationen im Sekundentakt ändern, kann dieser "Knowledge Cutoff" eine erhebliche Hürde darstellen. Hier kommt Claude's Web Search API ins Spiel – ein leistungsstarkes Tool, das diese Lücke schließen soll, indem es Claude die Fähigkeit verleiht, in Echtzeit auf Informationen aus dem Internet zuzugreifen und diese direkt in seine Antworten einzubeziehen.

Dieser Artikel bietet eine umfassende Anleitung zum Verständnis und zur Nutzung der Web Search API von Claude. Wir werden ihre Bedeutung, Funktionsweise, praktische Implementierungsschritte, erweiterte Funktionen, überzeugende Anwendungsfälle und Best Practices für Entwickler untersuchen, die KI-Anwendungen der nächsten Generation entwickeln möchten, die nicht nur intelligent, sondern auch aktuell und kontextbezogen sind.

💡

Want a great API Testing tool that generates beautiful API Documentation?

Want an integrated, All-in-One platform for your Developer Team to work together with maximum productivity?

Apidog delivers all your demans, and replaces Postman at a much more affordable price!

button

Claude Web Search API: Ein kurzer Überblick

Die digitale Welt befindet sich in einem ständigen Wandel. Nachrichten werden veröffentlicht, Markttrends verschieben sich, wissenschaftliche Entdeckungen werden veröffentlicht und Softwaredokumentationen werden kontinuierlich aktualisiert. LLMs, die auf Datensätzen trainiert wurden, die vor diesen Änderungen liegen, können versehentlich veraltete oder unvollständige Informationen liefern, was ihren Nutzen in Szenarien einschränkt, die eine minutengenaue Genauigkeit erfordern.

Der Echtzeit-Webzugriff behebt diese grundlegende Einschränkung auf verschiedene wichtige Arten:

Überwindung von Knowledge Cutoffs: Der offensichtlichste Vorteil ist die Möglichkeit, auf Informationen zuzugreifen, die nach dem letzten Trainingszyklus des LLM erstellt oder aktualisiert wurden. Dies bedeutet, dass Claude Fragen zu aktuellen Ereignissen, aktuellen Angelegenheiten oder den neuesten Entwicklungen in einem beliebigen Bereich beantworten kann.
Verbesserte Genauigkeit und Relevanz: Durch das Abrufen von Live-Daten können LLMs Antworten liefern, die nicht nur aktuell, sondern auch relevanter für den unmittelbaren Kontext des Benutzers sind. Ob es sich um das aktuelle Wetter, die neuesten Aktienkurse oder aktuelle Nachrichten handelt, die Informationen sind zeitnah und umsetzbar.
Dynamische Problemlösung: Viele reale Probleme erfordern Informationen, die von Natur aus dynamisch sind. Beispielsweise kann die Fehlerbehebung bei einem Softwareproblem die neuesten Fehlerberichte oder Forendiskussionen erfordern, während Marktforschung aktuelle Wettbewerbsdaten benötigt. Die Websuche ermöglicht es LLMs, diese dynamischen Herausforderungen effektiver zu bewältigen.
Neue Grenzen für KI-Anwendungen: Der Zugriff auf Echtzeitdaten eröffnet eine Fülle neuer Anwendungen. Stellen Sie sich KI-Assistenten vor, die Live-Sportergebnisse liefern können, Finanzberater, die Einblicke auf der Grundlage aktueller Marktbewegungen bieten, oder Forschungstools, die die neuesten wissenschaftlichen Arbeiten synthetisieren können.
Aufbau von Vertrauen durch Überprüfbarkeit: Wenn ein LLM seine Quellen aus dem Live-Web zitieren kann, erhöht dies das Vertrauen der Benutzer erheblich. Benutzer können die Informationen selbst überprüfen und so Transparenz und Vertrauen in die Antworten der KI fördern.

Claude's Web Search API ist die Antwort von Anthropic auf diese Bedürfnisse und bietet eine robuste und integrierte Lösung für Entwickler, um Anwendungen zu erstellen, die die riesige, sich ständig weiterentwickelnde Wissensbasis des Internets nutzen.

So verwenden Sie die Claude Web Search API

Im Kern ist die Web Search API für Claude ein "Tool", das Claude verwenden kann, wenn er feststellt, dass eine Benutzerabfrage von externen, aktuellen Informationen profitieren würde. Dies ist keine einfache Stichwortsuche; Claude nutzt seine ausgefeilten Denkfähigkeiten, um zu verstehen, wann und wie effektiv gesucht werden soll.

Unterstützte Claude-Modelle:

Zum Zeitpunkt der Einführung und der nachfolgenden Aktualisierungen ist die Websuchfunktion auf mehreren leistungsstarken Claude-Modellen verfügbar, darunter:

Claude 3.7 Sonnet (claude-3-7-sonnet-20250219 oder claude-3-7-sonnet-latest)
Das aktualisierte Claude 3.5 Sonnet (claude-3-5-sonnet-latest)
Claude 3.5 Haiku (claude-3-5-haiku-latest)

Beziehen Sie sich immer auf die offizielle Anthropic-Dokumentation, um die aktuellste Liste der unterstützten Modelle zu erhalten.

So funktioniert die Claude Web Search API

Intelligente Aufruf: Wenn ein Benutzer eine Eingabeaufforderung an ein unterstütztes Claude-Modell mit aktiviertem Websuch-Tool sendet, analysiert Claude zuerst die Abfrage. Wenn er ableitet, dass sein internes Wissen für die gegebene Abfrage unzureichend ist oder veraltet sein könnte, beschließt er, eine Websuche zu initiieren.
Generierung und Ausführung von Abfragen: Claude formuliert eine gezielte Suchanfrage basierend auf seinem Verständnis der Bedürfnisse des Benutzers. Die Anthropic API führt dann diese Suche aus und ruft relevante Webseiten ab.
Agentenbasierte Suche und Verfeinerung: Claude kann "agentenhaft" arbeiten, was bedeutet, dass er mehrere progressive Suchen durchführen kann. Er kann die Ergebnisse einer ersten Suche verwenden, um nachfolgende Abfragen zu informieren und zu verfeinern, sodass er leichte Recherchen durchführen und umfassendere Informationen sammeln kann. Dieser iterative Prozess wird fortgesetzt, bis Claude glaubt, dass er über ausreichende Informationen verfügt oder ein voreingestelltes Limit erreicht (z. B. max_uses).
Analyse und Synthese: Claude analysiert die abgerufenen Suchergebnisse, extrahiert Schlüsselinformationen und synthetisiert sie, um eine kohärente und umfassende Antwort zu bilden.
Zitierte Antworten: Entscheidend ist, dass Claude seine endgültige Antwort mit Zitaten zum Quellmaterial liefert. Dies ermöglicht es den Benutzern, die Informationen zu überprüfen und ihren Ursprung zu verstehen, wodurch Transparenz und Vertrauen gefördert werden.

Dieser gesamte Prozess ist so konzipiert, dass er für den Entwickler nahtlos abläuft. Anstatt eine eigene Web-Scraping- und Suchinfrastruktur aufzubauen und zu verwalten, können Entwickler das Tool einfach aktivieren und Claude die Komplexität der Echtzeit-Informationsbeschaffung überlassen.

Was ist mit der Preisgestaltung für die Claude Web Search API?

In Bezug auf die Preisgestaltung für die Web Search API von Claude hat Anthropic ein unkompliziertes Modell. Die Nutzung des Websuch-Tools selbst wird mit einem Satz von 10 US-Dollar für jeweils 1.000 durchgeführte Suchvorgänge abgerechnet. Es ist wichtig zu beachten, dass diese Kosten spezifisch für die Suchvorgänge sind, die von dem Tool ausgeführt werden.

Diese Gebühr ist getrennt von und zusätzlich zu den Standardkosten, die mit der Verarbeitung der Anfrage verbunden sind, zu denen die regulären Gebühren für Eingabe- und Ausgabetoken gehören, die vom Claude-Modell verbraucht werden, um die Abfrage zu verstehen, die Suchergebnisse zu verarbeiten und die endgültige Antwort zu generieren.

So verwenden Sie die Claude Web Search API

Die Integration der Websuche in Ihre Claude-basierte Anwendung umfasst ein paar einfache Schritte.

Voraussetzungen

Bevor Sie das Websuch-Tool verwenden können, muss der Administrator Ihrer Organisation es in der Anthropic Console aktivieren (in der Regel unter Einstellungen im Zusammenhang mit Datenschutz oder Tool-Nutzung).

Erstellen einer API-Anfrage

Um das Websuch-Tool zu verwenden, müssen Sie es in das tools-Array Ihrer API-Anfrage an die Messages API aufnehmen. Hier ist ein konzeptioneller Blick darauf, wie dies strukturiert ist:

Tool-Definition

Die grundlegende Tool-Definition, die Sie verwenden werden, lautet:

{
  "type": "web_search_20250305",
  "name": "web_search"
}

type: Diese spezifische Zeichenfolge identifiziert die Websuch-Tool-Version.
name: Ein beschreibender Name für das Tool, typischerweise "web_search".

Hier ist ein Beispiel für einen Curl-Aufruf:

curl https://api.anthropic.com/v1/messages \\
    --header "x-api-key: $ANTHROPIC_API_KEY" \\
    --header "anthropic-version: 2023-06-01" \\ # Oder die neueste empfohlene Version
    --header "content-type: application/json" \\
    --data '{
        "model": "claude-3.5-sonnet-latest",    # Oder ein anderes unterstütztes Modell
        "max_tokens": 1024,
        "messages": [
            {
                "role": "user",
                "content": "What are the latest developments in quantum computing this year?"
            }
        ],
        "tools": [{
            "type": "web_search_20250305",
            "name": "web_search",
            "max_uses": 5 # Optional: Limit search iterations
        }]
    }'

Das Websuch-Tool bietet mehrere optionale Parameter, um sein Verhalten anzupassen:

max_uses (ganzzahlig, optional):

Dieser Parameter begrenzt die Anzahl der eindeutigen Suchvorgänge, die Claude innerhalb einer einzelnen API-Anfrage ausführen kann.
Es ist eine nützliche Kontrolle zur Verwaltung sowohl der Tiefe der Recherche als auch der potenziellen Kosten, die mit Suchen verbunden sind.
Wenn Claude versucht, dieses Limit zu überschreiten, weist das web_search_tool_result einen Fehler mit dem Code max_uses_exceeded aus.
Standardverhalten, wenn nicht angegeben, ermöglicht es Claude, die Anzahl der Suchvorgänge basierend auf seiner Argumentation zu bestimmen.

allowed_domains (Array von Zeichenfolgen, optional):

Geben Sie eine Liste von Domänen an, von denen Claude Suchergebnisse abrufen darf. Dies ist hervorragend geeignet, um sicherzustellen, dass Informationen nur aus vorab genehmigten, vertrauenswürdigen Quellen stammen.
Wichtig:
Schließen Sie das HTTP/HTTPS-Schema nicht ein (z. B. verwenden Sie example.com, nicht https://example.com).
Subdomains sind automatisch enthalten (z. B. example.com deckt auch docs.example.com ab).
Subpfade werden unterstützt (z. B. example.com/blog).
Sie können entweder allowed_domains oder blocked_domains in einer einzigen Anfrage verwenden, aber nicht beides.

blocked_domains (Array von Zeichenfolgen, optional):

Geben Sie eine Liste von Domänen an, auf die Claude niemals zugreifen soll. Dies ist nützlich, um den Zugriff auf Websites von Wettbewerbern, irrelevante Quellen oder Domänen zu verhindern, die für Fehlinformationen bekannt sind.
Es gelten die gleichen Formatierungsregeln wie für allowed_domains.
Kann nicht gleichzeitig mit allowed_domains verwendet werden.

user_location (Objekt, optional):

Mit diesem Parameter können Sie Suchergebnisse lokalisieren, wodurch sie für den geografischen Kontext eines Benutzers relevanter werden.
Die Struktur lautet:

"user_location": {
  "type": "approximate", // Derzeit wird nur "approximate" unterstützt
  "city": "San Francisco",
  "region": "California",
  "country": "US",
  "timezone": "America/Los_Angeles" // IANA timezone ID
}

Dies hilft Claude, Ergebnisse abzurufen, die geografisch relevant sind, z. B. lokale Nachrichten, Dienste oder Wetter.

So verarbeiten Sie Claude Web Search API-Antworten

Wenn Claude das Websuch-Tool verwendet, enthält die API-Antwort bestimmte Informationsblöcke, die den Suchprozess und die Ergebnisse detailliert beschreiben. Das Verständnis dieser Struktur ist der Schlüssel zur effektiven Nutzung des Tools.

Typische Antwortstruktur:

Das content-Array in der Nachricht des Assistenten enthält:

Claude's Entscheidung zur Suche (Typ: "text"): Oft gibt Claude einen kurzen Text aus, der seine Absicht zur Suche anzeigt, z. B. "Ich suche nach den neuesten Nachrichten zu diesem Thema."

Server Tool Use Block (Typ: "server_tool_use"):

Dieser Block signalisiert, dass Claude beschlossen hat, ein serverseitiges Tool (wie die Websuche) zu verwenden.
Es enthält eine id (z. B. srvtoolu_01WYG3ziw53XMcoyKL4XcZmE), den name des Tools ("web_search") und ein input-Objekt.
Das input-Objekt enthält die tatsächliche query, die Claude an die Suchmaschine gesendet hat (z. B. {"query": "claude shannon birth date"}).

Web Search Tool Result Block (Typ: "web_search_tool_result"):

Dieser Block enthält das Ergebnis der Suche. Es verweist auf die tool_use_id aus dem server_tool_use-Block.
Der content innerhalb dieses Blocks ist ein Array von web_search_result-Objekten, wenn die Suche erfolgreich war.
Jedes web_search_result-Objekt enthält:
url: Die URL der Quellseite.
title: Der Titel der Quellseite.
encrypted_content: Verschlüsselter Inhalt von der Seite. Dies muss in nachfolgenden Runden einer Multi-Turn-Konversation zurückgegeben werden, wenn Sie möchten, dass Claude diesen spezifischen Inhalt genau zitieren kann.
page_age: Ein Indikator dafür, wann die Website zuletzt aktualisiert oder gecrawlt wurde (z. B. "30. April 2025").

Claude's Synthetisierte Antwort (Typ: "text" mit Zitaten):

Nach den Suchergebnissen liefert Claude seine textuelle Antwort und integriert die gefundenen Informationen.
Entscheidend ist, dass Teile dieses Textes zugeordnete citations haben.
Jedes citation-Objekt (vom Typ web_search_result_location) enthält:
url: Die URL der zitierten Quelle.
title: Der Titel der zitierten Quelle.
encrypted_index: Ein Verweis auf den spezifischen Teil des encrypted_content, der diese Zitation unterstützt. Dies muss auch in Multi-Turn-Konversationen zurückgegeben werden.
cited_text: Ein Snippet (bis zu 150 Zeichen) des Textes aus der Quelle, die zitiert wird.

Wichtiger Hinweis zu Zitaten: Zitationsfelder (cited_text, title, url) werden nicht für Ihre Eingabe- oder Ausgabetoken-Nutzung gezählt, was sie zu einer kostengünstigen Möglichkeit macht, überprüfbare Informationen bereitzustellen.

Fehlerbehandlung:
Wenn während des Websuchvorgangs ein Fehler auftritt, enthält der web_search_tool_result-Block ein Fehlerobjekt anstelle von Ergebnissen.

{
  "type": "web_search_tool_result",
  "tool_use_id": "servertoolu_a93jad",
  "content": {
    "type": "web_search_tool_result_error",
    "error_code": "max_uses_exceeded" // Beispiel Fehler
  }
}

Häufige Fehlercodes sind:

too_many_requests: Rate Limit für Suchvorgänge überschritten.
invalid_input: Ein Problem mit einem Suchabfrageparameter (z. B. fehlerhafter Domänenfilter).
max_uses_exceeded: Claude versuchte, mehr Suchvorgänge durchzuführen, als durch den Parameter max_uses erlaubt.
query_too_long: Die von Claude generierte Suchabfrage war zu lang.
unavailable: Ein interner Fehler ist innerhalb des Suchdienstes aufgetreten.

pause_turn Stop Reason:
Für potenziell lange Runden mit mehreren Suchvorgängen kann die API-Antwort einen stop_reason von pause_turn enthalten. Dies weist darauf hin, dass die API die Runde angehalten hat. Sie können die Runde fortsetzen, indem Sie den gesamten Antwortinhalt in einer nachfolgenden Anfrage zurücksenden, sodass Claude seine Arbeit fortsetzen kann.

Okay, ich werde einen neuen Abschnitt über "Testing Claude Web Search API with Apidog" schreiben, der sich auf die beteiligten Schritte konzentriert und ihn auf etwa 150 Wörter beschränkt.

Testen der Claude Web Search API mit Apidog

Apidog bietet eine robuste Umgebung zum Testen von APIs wie der Web Search von Claude. So können Sie vorgehen:

Richten Sie Ihr Projekt ein: Erstellen Sie in Apidog ein neues Projekt oder verwenden Sie ein vorhandenes. Sie können den Claude API-Endpunkt manuell definieren oder eine OpenAPI-Spezifikation importieren, falls Anthropic eine bereitstellt.

Definieren Sie die Anfrage:

Navigieren Sie zum Modus "Anfrage" oder "Design". Erstellen Sie eine neue API-Anfrage.
Methode: Setzen Sie die HTTP-Methode auf POST.
URL: Geben Sie den Claude Messages API-Endpunkt ein (z. B. https://api.anthropic.com/v1/messages).
Header: Fügen Sie die erforderlichen Header hinzu:
x-api-key: Ihr Anthropic API-Schlüssel.
anthropic-version: Die erforderliche API-Version (z. B. 2023-06-01).
content-type: application/json.

Add auth for the endpoint test in Apidog

Konstruieren Sie den Anfragetext:

Geben Sie im Tab "Body" (wählen Sie "raw" und dann "JSON") die JSON-Nutzlast ein. Dies beinhaltet Ihr model, max_tokens, das messages-Array (mit Benutzerrolle und Inhalt) und das tools-Array, das das web_search-Tool angibt.

Setting up the endpoint request body at Apidog

Senden und inspizieren: Klicken Sie auf "Senden". Apidog zeigt die Antwort an, sodass Sie den Statuscode, die Header und den Text, einschließlich aller Websuchergebnisse und Zitate von Claude, untersuchen können.

Assertions (Optional): Verwenden Sie die Assertions-Funktionen von Apidog, um Antwortelemente automatisch zu validieren, z. B. das Vorhandensein eines web_search_tool_result-Blocks oder bestimmter Zitationsdetails.

Dieser optimierte Prozess in Apidog hilft Ihnen, die Funktionalität der Claude Web Search API schnell zu wiederholen und zu bestätigen.

💡

button

Erweiterte Funktionen & Best Practices für die Claude Web Search API

Über die Grundlagen hinaus bietet die Web Search API von Claude Funktionen zur Optimierung von Leistung, Kosten und Benutzererfahrung.

Prompt-Caching:

Die Websuche lässt sich in die Prompt-Caching-Funktion von Anthropic integrieren.
Durch strategisches Platzieren von cache_control-Haltepunkten in Ihren Anfragen (insbesondere in Multi-Turn-Konversationen) können Sie die Ergebnisse von Websuchen zwischenspeichern.
Wenn Sie beispielsweise nach dem Empfang eines web_search_tool_result diese zu Ihrem Nachrichtenverlauf hinzufügen und dann eine neue Benutzernachricht mit cache_control: {"type": "ephemeral"} hinzufügen, können nachfolgende Aufrufe die zwischengespeicherten Suchergebnisse wiederverwenden, wodurch die Latenz und die Tokenkosten für den zwischengespeicherten Teil reduziert werden, während gleichzeitig neue Suchvorgänge bei Bedarf zugelassen werden.

Streaming:

Wenn das Streaming für Ihre API-Anfrage aktiviert ist, erhalten Sie Ereignisse im Zusammenhang mit dem Websuchprozess in Echtzeit.
Dies umfasst Ereignisse für content_block_start, wenn Claude sich für die Suche entscheidet, content_block_delta, wenn die Suchabfrage gestreamt wird, eine natürliche Pause während der Ausführung der Suche und dann weitere Ereignisse, wenn die Suchergebnisse (web_search_tool_result) zurückgestreamt werden.
Streaming bietet eine reaktionsschnellere Benutzererfahrung, da Benutzer sehen können, dass die KI aktiv an der Abfrage von Informationen arbeitet.

Batch-Anfragen:

Das Websuch-Tool kann in Anfragen an die Messages Batches API aufgenommen werden. Dies ist nützlich für die Verarbeitung mehrerer Abfragen, die möglicherweise Websuchen in asynchroner Weise erfordern.
Die Preise für Websuchen über die Batches API sind die gleichen wie für reguläre Messages API-Anfragen.

Aufbau mit Vertrauen und Kontrolle:

Nutzen Sie Zitate: Gestalten Sie Ihre Benutzeroberfläche immer so, dass die von Claude bereitgestellten Zitate angezeigt werden. Diese Transparenz ist der Schlüssel zum Vertrauen der Benutzer und ermöglicht es den Benutzern, Informationen zu überprüfen.
Verwenden Sie die Domänenfilterung: Verwenden Sie für Anwendungen, bei denen die Zuverlässigkeit der Quelle von größter Bedeutung ist (z. B. Finanz- oder medizinische Beratung), allowed_domains, um Suchvorgänge auf maßgebliche Quellen zu beschränken. Verwenden Sie blocked_domains, um den Zugriff auf unangemessene oder unerwünschte Inhalte zu verhindern.
Einstellungen auf Organisationsebene: Denken Sie daran, dass Administratoren die Websuche auf Organisationsebene aktivieren oder deaktivieren können, was einen übergreifenden Kontrollmechanismus bietet.

Kostenmanagement:

Die Websuchnutzung wird separat von der Tokennutzung abgerechnet. Nach den neuesten Informationen betragen die Kosten 10 US-Dollar pro 1.000 Suchvorgänge. Die Standard-Tokenkosten für die von Claude auf der Grundlage der Suchergebnisse generierten Inhalte gelten weiterhin.
Jeder Websuchaufruf zählt als eine Verwendung, unabhängig von der Anzahl der zurückgegebenen Ergebnisse. Fehler während eines Suchversuchs werden in der Regel nicht berechnet.
Verwenden Sie den Parameter max_uses mit Bedacht, um die potenzielle Anzahl der Suchvorgänge pro Benutzerabfrage zu steuern, insbesondere in agentenbasierten Szenarien, in denen Claude möglicherweise mehrere Suchvorgänge durchführt.

Fazit

Claude's Web Search API stellt einen bedeutenden Schritt nach vorn dar, um LLMs praktischer, zuverlässiger und intelligenter zu machen. Indem Claude sich von den Einschränkungen statischer Trainingsdaten befreit, kann er jetzt an Gesprächen teilnehmen und Inhalte generieren, die die Welt so widerspiegeln, wie sie heute ist. Für Entwickler bedeutet dies die Fähigkeit, leistungsfähigere, genauere und vertrauenswürdigere KI-Anwendungen zu erstellen, die wirklich mit der dynamischen Natur der Informationen Schritt halten können.

Da sich LLMs weiterentwickeln, werden integrierte Tools wie die Websuche zunehmend zum Standard, wodurch sich diese Modelle von beeindruckenden Wissensspeichern in dynamische, interaktive Partner bei der Informationsfindung und Problemlösung verwandeln. Durch das Verständnis und die Nutzung der Fähigkeiten der Web Search API von Claude können Entwickler an vorderster Front dieser aufregenden Entwicklung stehen und KI-Lösungen schaffen, die nicht nur intelligent, sondern auch kontinuierlich vom Puls des Webs informiert werden.

💡

button

```