Skip to main content
graph.swiss
Torna alla piattaforma

API Swiss Graph e risorse per sviluppatori

Tutto ciò che serve a uno sviluppatore o a un agente IA per lavorare con i dati Swiss Graph: un'API pubblica gratuita in anteprima con contratto OpenAPI, un server MCP, schede Markdown per ogni azienda e persona e l'API Graph Swiss con chiave per l'accesso ad alto volume.

  • Documento OpenAPI 3.1 — Contratto leggibile dalle macchine dell'API pubblica in anteprima. https://graph.swiss/openapi.json
  • llms.txt — Panoramica del sito e indicazioni d'uso per gli agenti IA. https://graph.swiss/llms.txt
  • Server MCP — Endpoint Streamable HTTP; documento di scoperta in /.well-known/mcp. https://graph.swiss/mcp
  • Schede Markdown — Aggiunga .md all'URL di qualsiasi profilo aziendale o personale.
  • Indice della sitemap — Ogni pagina scansionabile, inclusi gli indici frammentati di aziende e persone. https://graph.swiss/sitemap.xml
  • Documentazione dell'API Graph Swiss — Riferimento dell'API con chiave e a consumo (X-API-Key). https://docs.graph.swiss/
  • Prezzi — I piani in forma leggibile da persone e macchine (pricing.md). https://graph.swiss/pricing.md
  • Chiavi API — Gestisca le chiavi dell'API Graph Swiss (piano Enterprise).

API pubblica in anteprima

Cinque operazioni di sola lettura sul registro di commercio svizzero, servite da graph.swiss senza autenticazione. Gli stessi fatti del registro del sito pubblico, le stesse regole sulla privacy: solo organi attuali, persone oscurate mascherate, le ultime 3 pubblicazioni FUSC per azienda. Le risposte sono in JSON; ogni errore usa un'unica busta con codice stabile, messaggio e suggerimento.

Limiti: 60 chiamate di ricerca o autocompletamento e 120 chiamate di dettaglio al minuto per client. Le risposte riportano X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset; un 429 aggiunge Retry-After. Le ricerche sfogliano al massimo 45 righe per interrogazione: restringa l'interrogazione invece di sfogliare oltre.

MetodoPercorsoOperazioneDescrizione
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

Esempio di richiesta

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

Busta degli errori

{
  "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"
  }
}

Server MCP

Le stesse operazioni sono disponibili come strumenti Model Context Protocol via Streamable HTTP (senza stato, senza autenticazione, risposte JSON). Punti un client MCP verso l'endpoint o gli lasci leggere il documento di scoperta.

Configurazione del client

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

Schede Markdown

Ogni profilo aziendale e personale ha un gemello Markdown per gli agenti che preferiscono il testo: aggiunga .md all'URL canonico. Circa 2 KB per scheda, gli stessi fatti del registro della pagina HTML, serviti con un'intestazione Link canonica.

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

API Graph Swiss (con chiave)

Per l'accesso ad alto volume a consumo, le schede complete e i dati di borsa, l'API Graph Swiss si autentica con un'intestazione X-API-Key, restituisce una busta success/data con ID di richiesta e addebita ogni chiamata in crediti. Le chiavi vengono rilasciate con il piano Enterprise e gestite in Account → Chiavi API.

Dati, privacy e condizioni

Tutti i fatti del registro provengono dal Foglio ufficiale svizzero di commercio (FUSC/SHAB); l'autorità legale resta il registro cantonale. L'API in anteprima e il server MCP pubblicano solo fatti del registro: nessun arricchimento, nessun recapito. Le persone i cui dati il registro ha oscurato compaiono come «Redacted person» e non hanno alcuna scheda consultabile. L'uso è disciplinato dalle condizioni d'uso.

API Swiss Graph e risorse per sviluppatori | Swiss Graph