Warum GunSpec?
Es gab keine gute API für Waffenspezifikationen, also haben wir eine gebaut: 9,162 Waffen von 1,003 Herstellern, jeder Datensatz belegt, bewertet und in einer Form geliefert. Diese Seite ist das, was wir über diese Daten glauben, und wie wir es belegen.
- 9,162Waffen
- 1,003Hersteller
- 605Kaliber
- 74%Mittlere Datenkonfidenz
Das Problem und der Ansatz
Waffendaten waren über Wikis, Foren, Herstellerseiten und alte PDFs verstreut. Spielestudios scrapten Wikipedia. App-Entwickler kopierten Specs aus Broschüren. Forscher fügten ein Dutzend widersprüchlicher Quellen zusammen. Niemand konnte belegen, woher eine Zahl kam.
Vorher
Fünfzehn offene Tabs pro Waffe. Eine Lauflänge in Zoll auf der einen Seite, in Millimetern auf der nächsten. Ein Gewicht, von dem niemand sagen konnte, ob leer oder geladen. Eine Variante, verwechselt mit ihrem Stammmodell. Keine Möglichkeit zu wissen, was sich seit letztem Monat geändert hat, und niemand, dem man eine falsche Zahl melden konnte.
GunSpec
Eine Anfrage liefert den Datensatz: 78 Felder, Einheiten im Namen, eine Konfidenzbewertung, die Quellen und eine version, die sich nur ändert, wenn sich die Daten ändern. Jede Liste dieselbe Hülle, jeder Fehler dieselbe Form, jede Änderung angekündigt. Eine falsche Zahl ist eine Meldung, auf die ein Mensch reagiert.
Wofür wir stehen
Sechs Grundsätze. Jeder ist eine Behauptung über das Produkt, also trägt jeder die Zahl oder die Seite, mit der Sie ihn prüfen können.
- 01
Belegt, nicht gescrapt
Eine Spezifikation stammt aus einem Herstellerdatenblatt oder einem gleichwertigen Dokument, wird gegen unabhängige Referenzen geprüft und von einem Menschen geprüft, bevor sie erscheint. Wo Quellen widersprechen, sagt der Datensatz das, statt eine auszuwählen.
Jeder Datensatz nennt seine Quellen und trägt eine Konfidenzbewertung; der Katalogmittelwert liegt bei 74 %.
- 02
Ehrlich über das, was wir nicht wissen
Ein fehlender Wert ist null, nie geraten, nie die Zahl eines Geschwistermodells. Die Konfidenzbewertung misst Vollständigkeit und Herkunft auf Datensatzebene, kein Versprechen, dass eine bestimmte Zahl stimmt, und die Doku sagt das überall, wo sie erscheint.
Die Feldreferenz dokumentiert die Bedeutung von null und der Bewertung auf jeder Seite, auf der sie vorkommt.
- 03
Jedes Mal dieselbe Form
Jede Liste ist dieselbe Hülle. Jede Einheit steckt im Feldnamen. Jeder Status, Verschlusstyp und jedes Ereignis kommt aus einem geschlossenen Vokabular, das wächst, aber nie verschiebt. Ein Client, der gegen einen Datensatz geschrieben ist, funktioniert gegen alle.
133 Operationen, eine JSON-Hülle (nur die Dateidownloads und die Händler-Weiterleitung antworten anders), 39 benannte Fehlergründe unter einer Handvoll stabiler Codes.
- 04
Für Maschinen und Modelle gebaut
Das OpenAPI-Dokument ist der Vertrag, keine Beschreibung davon: SDKs, Referenz, Agenten-Pakete und Tests werden daraus generiert. Ein Agent mit den Paketen lernt den Ablauf, der die teuren Fehler vermeidet: einen Namen auflösen, bevor er abruft, nie eine Spezifikation erfinden, die Quelle nennen.
Fünf Agenten-Pakete, llms.txt und ein OpenAPI-3-Dokument, alle aus derselben Spezifikation geschnitten.
- 05
Standardmäßig offen
Ein kostenloser Explorer-Schlüssel dauert eine Minute und liest den Katalog. Inhaltszugriffe brauchen gar keinen Schlüssel. Changelog, Genauigkeitsmethodik, Datenschutzmaßnahmen und diese Seite sind öffentlich. Eine falsche Zahl kann jeder mit einem Schlüssel melden, und die Korrektur geht an alle.
200 Anfragen im Monat bei 10 pro Minute im kostenlosen Tarif; 17 Operationen antworten ohne Schlüssel.
- 06
Ein Vertrag, auf dem man bauen kann
Additive Änderungen landen unter dem Präfix, das Sie schon nutzen. Ein Breaking Change zieht auf ein neues Präfix, das alte antwortet weiter; die enge Ausnahme, einen Defekt an Ort und Stelle zu korrigieren, wird vorher angekündigt und jeder Betroffene informiert. Katalogänderungen erreichen Sie als signierte Webhooks, nicht als Diff, den Sie selbst laufen lassen.
Ein abgelöstes Präfix antwortet mindestens 12 Monate; 18 Webhook-Ereignistypen; 61 veröffentlichte Changelog-Einträge.
In Zahlen
Zur Bauzeit aus Katalog, Spezifikation und Changelog gelesen. Die Live-Zahlen sind einen Aufruf entfernt.
Der Katalog
- Waffen
- 9,162
- Hersteller
- 1,003
- Kaliber
- 605
- Herkunftsländer
- 69
- Erfasste Varianten
- 1,353
- Strichzeichnungen
- 2,589
- Felder pro Datensatz
- 78
- Mittlere Datenkonfidenz
- 74%
Die API
- Operationen
- 133
- Operationen ohne Schlüssel
- 17
- Konkrete Fehlergründe
- 39
- Webhook-Ereignisse
- 18
- Monate, die ein Präfix nach einem Breaking Change weiter antwortet
- 12
- Explorer-Anfragen pro Monat, kostenlos
- 200
- Veröffentlichte Changelog-Einträge
- 61
Live-Zahlen: GET /v1/stats/summary oder die Statistikseite der Website. Was wann ausgeliefert wurde: das Changelog.
Für wen
Derselbe Datensatz dient sehr unterschiedlichen Lesern. Jede Zeile öffnet den Teil der Referenz, mit dem dieser Leser beginnt.
- SpielestudiosAcht ausbalancierte 0-100-Werte pro Waffe, abgeleitet aus der echten Spezifikation, sodass eine 1911 richtig gegen eine MP5 liest.
- App- und Tool-EntwicklerVergleichswerkzeuge, Waffenschrank-Tracker, Nachschlage-Apps: typisierte Datensätze, Volltextsuche, ein Resolver für Namen, wie Menschen sie schreiben.
- Händler und MarktplätzeGenaue Specs auf Produktseiten, Kaliberkompatibilität und eine bezahlte Platzierung auf den Datensätzen, die Sie führen.
- Forschung, Journalismus und PolitikZitierfähige Zahlen mit Quellen und Konfidenzbewertung, nach jedem Feld abfragbar, mit Herkunft auf jedem Datensatz.
- Verteidigung, Ausbildung und SimulationBeschaffungsblätter, Kursmaterial und VR-Schießstände aus einer zitierbaren Quelle, mit Passung berechnet aus Montageschnittstellen.
- KI-Agenten und AssistentenEine Spezifikation, aus der Tools generiert werden, Pakete, die den Ablauf lehren, und ein Resolver, der sagt, wenn er unsicher ist.
Wie ein Datensatz seinen Platz verdient
Jede Zahl im Katalog hat dieselben sechs Schritte durchlaufen. Die Bewertung, die Sie sehen, ist das Protokoll, wie weit sie gekommen ist.
- 1Belegt aus einem Herstellerdatenblatt, Beschaffungsdokument oder einer gleichwertigen Referenzpublikation. Wikis und Foren sind Hinweise, nie Quellen.
- 2Gegen unabhängige Referenzen geprüft. Wo sie nach Jahr, Werk oder Markt abweichen, vermerkt der Datensatz die Abweichung, statt zu wählen.
- 3Von einem Menschen geprüft, bevor er erscheint. Kein automatisierter Pfad schreibt in den Katalog; ein Modell darf vorschlagen, nur ein Mensch veröffentlichen.
- 4Bewertet. Datenkonfidenz wird aus dem gesetzt, was tatsächlich belegt wurde, und nie von Hand angehoben. Die Stufen, die Quellenreihenfolge und das
provenance-Objekt stehen in der Feldreferenz. - 5Offen korrigiert. Eine Datenmeldung von jedem Schlüssel landet in einer Warteschlange, die ein Mensch abarbeitet; die Korrektur geht an alle und die
versiondes Datensatzes bewegt sich. - 6Aktuell gehalten ohne Polling. Eine Änderung löst Webhooks an Abonnenten aus; ein unveränderter Datensatz antwortet mit 304, sodass ein Spiegel nichts kostet.
Welche Quelle gewinnt
Widersprechen sich zwei Quellen, gewinnt die Produktseite oder das Datenblatt des Herstellers, dann die Zeichnung eines Normungsgremiums bei einer Patrone, dann eine Referenz, die eine Norm zitiert, dann eine Referenzseite, dann ein Vertrieb oder Händler, und Modellwissen aus der Erstbefüllung zuletzt. sources am Datensatz listet die konsultierten Seiten, und eine konkrete Zahl wird gegen diese geprüft statt gegen den Wert. Die volle Reihenfolge, die Bedeutung jeder Stufe und das provenance-Objekt stehen in der Feldreferenz.
Wie weiter
Ein kostenloser Explorer-Schlüssel dauert eine Minute. Der Schnellstart bringt Sie in vier Schritten zur ersten Antwort.