# Fynvo

Deutsches Firmenverzeichnis für KI-Assistenten und Agenten.

Fynvo beantwortet Fragen wie "Wer fräst CNC-Teile aus Edelstahl im Raum Stuttgart und ist nach
ISO 9001 zertifiziert?". Abrufbar sind 196.080 Profile. Geführt werden Firmendaten, keine
personenbezogenen Angaben.

## Zugang

Der Zugang ist frei und hat ein Tageslimit von 200 Abrufen je IP-Adresse. Ein Schlüssel im
Kopf `X-Fynvo-Key` hebt das Limit. Es ist keine Anmeldung nötig, um zu suchen.

- MCP-Server (Streamable HTTP, JSON-RPC 2.0): https://api.fynvo.de/mcp
- REST-API: https://api.fynvo.de/v1
- Beschreibung der REST-API: https://api.fynvo.de/v1/openapi.json

## Werkzeuge im MCP-Server

- `firmen_suchen`: Sucht deutsche Unternehmen nach Leistung, Zertifikat, Region, Rechtsform, Betriebsgröße oder Freitext.
- `firma_abrufen`: Liefert das vollständige Profil eines Unternehmens: Adresse, Leistungen, Zertifikate, Registereintrag, Kontakt und zu jedem Feld die Herkunft der Angabe.
- `anfrage_senden`: Schickt eine Anfrage an ein Unternehmen, im Auftrag des Nutzers.

## Wege in der REST-API

- `GET https://api.fynvo.de/v1/firmen?q=&leistung=&zertifikat=&plz=&umkreis_km=&bundesland=&rechtsform=&groesse=&besteht_jahre_min=&seite=`
- `GET https://api.fynvo.de/v1/firmen/{slug}`
- `POST https://api.fynvo.de/v1/firmen/{slug}/anfragen`
- `GET https://api.fynvo.de/v1/leistungen`
- `GET https://api.fynvo.de/v1/zertifikate`

Die Werte für `leistung` und `zertifikat` kommen aus einem festen Vokabular:
366 Leistungen in 37 Oberbegriffen und 45 Zertifikate.
Erst `/v1/leistungen` abrufen, dann den Slug einsetzen. Ein Oberbegriff trifft auch
alle Leistungen darunter.

`rechtsform` nimmt die Form, wie sie im Profil steht, etwa `GmbH` oder `GmbH & Co. KG`.
`groesse` nimmt `kleinst` (1 bis 9 Beschäftigte), `klein` (10 bis 49), `mittel` (50 bis 249)
oder `gross` (ab 250). `besteht_jahre_min` nimmt eine Zahl in Jahren. `groesse` und
`besteht_jahre_min` lassen Firmen heraus, zu denen die Angabe fehlt; wer breit suchen
will, lässt beide weg. Die Trefferliste nennt `rechtsform`, `gruendungsjahr` und
`groessenklasse` zu jedem Treffer, eine Vorauswahl braucht also keinen Profilabruf.

## Herkunft der Angaben

Bei jeder Angabe stehen Quelle und Stand. Im Feld `quellen` steht je Feld eine davon,
die schwerste zuerst:

- `redaktion`: von uns geprüft und eingetragen
- `unternehmen`: das Unternehmen hat die Angabe selbst gepflegt
- `register`: aus einem amtlichen Register
- `website`: aus der Website des Unternehmens erhoben, mit Quelle-URL
- `karte`: aus offenen Karten und Ortsverzeichnissen
- `import`: aus einem übernommenen Bestand

Profile mit zu wenigen geprüften Angaben werden nicht ausgeliefert. `qualitaet` nennt den
Wert von 0 bis 100, ausgeliefert wird ab 25.

Eine Angabe ist gegen eine amtliche Stelle geprüft: die Umsatzsteuer-Identifikationsnummer.
`register.ust_gueltig` ist true, wenn der Mitgliedsstaat sie über VIES, das
Mehrwertsteuer-Informationssystem der Europäischen Kommission, als aktuell gültig führt.
`ust_geprueft_am` nennt den Stand, `ust_geprueft_durch` die Stelle. NULL heißt: die
Prüfung steht noch aus, nicht ungültig. Mehr als „gültig" sagt VIES nicht; Deutschland
gibt dort weder Name noch Anschrift heraus.

Alle übrigen Angaben stammen aus öffentlich zugänglichen Quellen, meist dem Impressum. Was
dort steht, hat niemand gegengeprüft, und `quellen` sagt je Feld, woher es kommt.

## Profilseiten

Jedes Profil ist auch als Seite lesbar: https://fynvo.de/firma/{slug}, mit JSON-LD nach Schema.org.

## Erhebung

Unser Bot heißt `FynvoBot/1.0 (+https://fynvo.de/bot)`. Er befolgt robots.txt und stellt
höchstens eine Anfrage pro Sekunde und Domain.