Help Center / api

OSIR mit LangChain, CrewAI, AutoGen und anderen Agenten-Frameworks nutzen

OSIR spricht das Model Context Protocol, daher kann jedes Framework mit einem MCP-Client es als Werkzeugquelle verwenden. Sie richten den Client auf eine einzige URL, und Ihr Agent erhält 105 Werkzeuge für Domains, DNS, VPS, E-Mail und Hosting.

Entscheidend für Agenten: Suchen kostet nichts und erfordert kein Konto. Verfügbarkeit, Preise, Vorschläge und der vollständige Katalog sind anonym abrufbar. Ihr Agent kann schon beim ersten Lauf Namen recherchieren, ohne API-Schlüssel, ohne Registrierung und ohne Konfiguration. Zugangsdaten werden erst nötig, wenn tatsächlich etwas gekauft wird.

Das Einzige, was Sie brauchen

https://be.osir.com/mcp/http

Transport ist Streamable HTTP. Es gibt nichts zu installieren und keinen Schlüssel zu beantragen.

Was ohne Konto funktioniert

60 der 105 Werkzeuge sind schreibgeschützt und tragen readOnlyHint. Ein Framework, das Annotationen auswertet, kann einen Agenten die sicheren Werkzeuge frei nutzen lassen.

Python: LangChain

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

client = MultiServerMCPClient({
    "osir": {
        "transport": "streamable_http",
        "url": "https://be.osir.com/mcp/http",
    }
})

tools = await client.get_tools()
agent = create_react_agent("anthropic:claude-sonnet-5", tools)

Python: CrewAI

from crewai import Agent, Crew, Task
from crewai_tools import MCPServerAdapter

server = {"url": "https://be.osir.com/mcp/http", "transport": "streamable-http"}

with MCPServerAdapter(server) as tools:
    researcher = Agent(
        role="Domain-Rechercheur",
        goal="Kurze, verfügbare Domains finden, die zur Marke passen",
        backstory="Sie prüfen Verfügbarkeit und Preis, bevor Sie etwas empfehlen.",
        tools=tools,
    )

Python: AutoGen

from autogen_ext.tools.mcp import StreamableHttpServerParams, mcp_server_tools
from autogen_agentchat.agents import AssistantAgent

params = StreamableHttpServerParams(url="https://be.osir.com/mcp/http")
tools = await mcp_server_tools(params)

TypeScript: das MCP-SDK direkt

import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"

const client = new Client({ name: "my-agent", version: "1.0.0" })
await client.connect(new StreamableHTTPClientTransport(
  new URL("https://be.osir.com/mcp/http")
))

Kein MCP-Client? Dann einfaches HTTP

Dieselben Abfragen sind öffentliche REST-Endpunkte, alles was ein GET senden kann, kann sie nutzen:

curl https://be.osir.com/v1/public/catalog/domains/fernweh.dev/availability

{
  "domain": "fernweh.dev",
  "available": true,
  "price": 1039,
  "icannFee": 20,
  "registrarFee": 30,
  "totalPrice": 1089
}

Preise sind in Cent, und totalPrice ist der tatsächlich berechnete Betrag: Grundpreis plus ICANN-Gebühr und Zahlungsabwicklung. Nennen Sie Nutzern immer totalPrice, nie price allein.

Vom Suchen zum Registrieren

Für die Registrierung braucht es ein Konto und Guthaben. Es gibt drei Wege dorthin, und für keinen davon muss ein Mensch mitten im Ablauf einen Browser öffnen:

1. Geräte-Anmeldung - loginWithDevice aufrufen, dem Nutzer die URL zeigen, checkDeviceLoginStatus abfragen und den zurückgegebenen sessionKey bei jedem weiteren Aufruf mitgeben.
2. Konto direkt aus dem Agenten anlegen - createAccount, dann verifyAccount mit dem per E-Mail zugesandten Code. Der Kontakt des Auftraggebers wird zum ICANN-Registranten.
3. OAuth - anonyme Dynamic Client Registration mit PKCE, für Agenten, die bereits Tokens verwalten.

Die Kaufsperre

Alles, was Geld ausgibt oder Daten zerstört, ist bewusst zweistufig. Das Werkzeug liefert eine actionId mit einer aufgeschlüsselten Zusammenfassung; nichts geschieht, bevor Sie executeConfirmedAction aufrufen. Ihr Agent kann kein Geld aus Versehen ausgeben, und genau das macht es vertretbar, einem autonomen Agenten überhaupt einen Registrar anzuvertrauen. Zeigen Sie Ihrem Nutzer die Zusammenfassung und lassen Sie ihn bestätigen.

Ratenbegrenzung und Umgangsformen

Anonyme Abfragen sind auf 150 Anfragen pro Minute und IP begrenzt; authentifizierte Aufrufer erhalten 500 pro Minute und Konto. Die Kontingente füllen sich laufend wieder auf, ein Burst erholt sich also innerhalb von Sekunden, und jede Antwort meldet den Rest in x-ratelimit-remaining. Wenn Sie Hunderte Namen prüfen, verwenden Sie checkKeywordAvailability (ein Stichwort über viele Endungen in einem Aufruf) oder bulkDomainSuggestions, statt checkDomainAvailability in einer Schleife aufzurufen. Das ist schneller für Sie und rücksichtsvoller gegenüber den Registries hinter uns.

Ebenfalls verfügbar

• Gehostete Konnektoren - siehe OSIR mit Claude verbinden für den Weg ohne Code.
• CLI - eine einzelne Binärdatei mit 76 Befehlen, für Agenten, die lieber eine Shell nutzen. Siehe die Entwicklerdokumentation.
• A2A - 9 spezialisierte Agenten mit 89 Skills über JSON-RPC, für Agent-zu-Agent-Pipelines. Siehe KI-Integration.