Skip to main content
graph.swiss
Zurück zur Plattform

Swiss Graph API & Entwickler-Ressourcen

Alles, was Entwickler oder KI-Agenten für die Arbeit mit Swiss-Graph-Daten brauchen: eine kostenlose öffentliche Preview-API mit OpenAPI-Vertrag, ein MCP-Server, Markdown-Faktenblätter für jede Firma und Person sowie die Graph Swiss API mit Schlüssel für Volumenzugriff.

  • OpenAPI-3.1-Dokument — Maschinenlesbarer Vertrag der öffentlichen Preview-API. https://graph.swiss/openapi.json
  • llms.txt — Website-Übersicht und Einsatzhinweise für KI-Agenten. https://graph.swiss/llms.txt
  • MCP-Server — Streamable-HTTP-Endpunkt; Discovery-Dokument unter /.well-known/mcp. https://graph.swiss/mcp
  • Markdown-Faktenblätter — Hängen Sie .md an eine beliebige Firmen- oder Personenprofil-URL an.
  • Sitemap-Index — Jede crawlbare Seite, inklusive der aufgeteilten Firmen- und Personenindizes. https://graph.swiss/sitemap.xml
  • Graph Swiss API-Dokumentation — Referenz der schlüsselbasierten, abgerechneten API (X-API-Key). https://docs.graph.swiss/
  • Preise — Pläne in menschen- und maschinenlesbarer Form (pricing.md). https://graph.swiss/pricing.md
  • API-Schlüssel — Schlüssel für die Graph Swiss API verwalten (Enterprise-Plan).

Öffentliche Preview-API

Fünf Nur-Lese-Operationen über das Schweizer Handelsregister, ohne Authentifizierung von graph.swiss ausgeliefert. Dieselben Registerfakten wie die öffentliche Website, dieselben Datenschutzregeln: nur aktuelle Organe, geschwärzte Personen maskiert, die neuesten 3 SHAB-Meldungen pro Firma. Antworten sind JSON; jeder Fehler nutzt dasselbe Envelope mit stabilem Code, Meldung und Hinweis.

Limiten: 60 Such- oder Autocomplete-Aufrufe und 120 Detailaufrufe pro Minute und Client. Antworten tragen X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset; ein 429 ergänzt Retry-After. Suchen blättern durch höchstens 45 Zeilen pro Abfrage — grenzen Sie die Abfrage ein, statt tiefer zu blättern.

MethodePfadOperationBeschreibung
GET/api/v1/companies/searchsearchCompaniesSearch Swiss companies
GET/api/v1/companies/autocompleteautocompleteCompaniesAutocomplete a company name
GET/api/v1/companies/{id}getCompanyGet a company record
GET/api/v1/people/searchsearchPeopleSearch registered officers
GET/api/v1/people/{id}getPersonGet a person record

Beispielanfrage

curl 'https://graph.swiss/api/v1/companies/search?q=Nestle&canton=VD&limit=3'
curl https://graph.swiss/api/v1/companies/102945

Fehler-Envelope

{
  "error": {
    "code": "invalid_parameter",
    "message": "q must be at least 2 characters.",
    "hint": "Pass a company name, UID (CHE-…) or person name of 2–200 characters as ?q=.",
    "docs": "https://graph.swiss/openapi.json"
  }
}

MCP-Server

Dieselben Operationen stehen als Model-Context-Protocol-Werkzeuge über Streamable HTTP bereit (zustandslos, ohne Authentifizierung, JSON-Antworten). Richten Sie einen MCP-Client auf den Endpunkt oder lassen Sie ihn das Discovery-Dokument lesen.

Client-Konfiguration

{
  "mcpServers": {
    "swiss-graph": {
      "type": "http",
      "url": "https://graph.swiss/mcp"
    }
  }
}

Markdown-Faktenblätter

Jedes Firmen- und Personenprofil hat einen Markdown-Zwilling für Agenten, die Text bevorzugen: Hängen Sie .md an die kanonische URL an. Rund 2 KB pro Datensatz, dieselben Registerfakten wie die HTML-Seite, ausgeliefert mit kanonischem Link-Header.

https://graph.swiss/companies/{slug}/{id}.md
https://graph.swiss/people/{slug}/{id}.md

Graph Swiss API (mit Schlüssel)

Für abgerechneten Volumenzugriff, vollständige Datensätze und Börsendaten authentifiziert sich die Graph Swiss API per X-API-Key-Header, liefert ein success/data-Envelope mit Request-IDs und rechnet pro Aufruf in Credits ab. Schlüssel werden mit dem Enterprise-Plan ausgestellt und unter Konto → API-Schlüssel verwaltet.

Daten, Datenschutz und Bedingungen

Alle Registerfakten stammen aus dem Schweizerischen Handelsamtsblatt (SHAB/SOGC); massgebend bleibt das kantonale Handelsregister. Preview-API und MCP-Server publizieren ausschliesslich Registerfakten — keine Anreicherung, keine Kontaktdaten. Personen, deren Daten das Register geschwärzt hat, erscheinen als „Redacted person“ und haben keinen abrufbaren Datensatz. Die Nutzung unterliegt den Nutzungsbedingungen.

Swiss Graph API & Entwickler-Ressourcen | Swiss Graph