# swissco CLI

Schweizer Firmendaten aus dem Terminal: Handelsregister, Amtsblatt, öffentliches Beschaffungswesen, FINMA, GLEIF und ARAMIS in einem Befehl.

## Installation

Einmal ausführen ohne Installation, oder dauerhaft installieren:

`uvx swissco --help # run without installing pip install swissco # or install via pip`

Erfordert Python 3.14 oder neuer. Veröffentlicht auf PyPI als [swissco](https://pypi.org/project/swissco/).

## Befehle

### swissco lookup \<UID>

Vollständiger Registereintrag für eine Firma: Name, UID, Rechtsform, Gemeinde, Adresse, Zweck. Mit --finma werden FINMA-Bewilligungstyp und Aufsichtskategorie ergänzt, oder mit --lei der Legal Entity Identifier und die Konzernstruktur aus GLEIF.

`$ swissco lookup CHE-105.805.080 Name Nespresso SA UID CHE-105.805.080 Legal form AG Municipality Lausanne Canton VD`

### swissco search \<query>

Suche nach Firmenname oder Zwecktext. Filtern nach Kanton oder Rechtsform.

`$ swissco search "solar energy" --canton BE --format csv uid,name,legal_form,municipality,canton CHE-114.526.940,BKW Energie AG,AG,Bern,BE CHE-334.713.622,Solarkraft Berner Oberland AG,AG,Frutigen,BE`

### swissco publications

SHAB-Publikationen in einem Zeitraum, filterbar nach Kanton und Ereignistyp.

`$ swissco publications --since 2026-09-01 --canton ZH --type NEWLY_REGISTERED uid name event CHE-248.357.133 Zurich AI Labs GmbH NEWLY_REGISTERED CHE-248.358.971 Helvetic Solar Solutions AG NEWLY_REGISTERED`

### swissco events \<UID>

Die vollständige Registerhistorie einer Firma aus dem Amtsblatt.

`$ swissco events CHE-105.805.080 date event summary 2020-03-12 MUTATION Seat transfer to Lausanne 2018-06-01 CAPITAL_INCREASED Share capital CHF 200'000 → 250'000 2005-11-03 NEWLY_REGISTERED Initial registration`

### swissco tenders

Öffentliche Beschaffungsprojekte auf simap nach Kanton und Datum durchsuchen. Filterbar nach Publikationstyp: Ausschreibungen, Zuschläge, freihändige Vergaben.

`$ swissco tenders --canton ZH --since 2026-08-01 --type tender title buyer canton publication_date Sanierung Schulhaus Mühlebach Baudirektion Kanton Zürich ZH 2026-08-15 IT-Infrastruktur 2027–2031 Universitätsspital Zürich ZH 2026-08-12`

### swissco vendor \<query>

Eine Firma im simap-Anbieterprofil nachschlagen. Die UID wird gegen die uidNo des Verzeichnisses geprüft.

`$ swissco vendor CHE-409.633.691 Name Implenia Schweiz AG UID CHE-409.633.691 City Dietlikon Canton ZH Company size large`

### swissco finma

Institute auf der FINMA-Liste der bewilligten Banken und Wertpapierhäuser auflisten oder nachschlagen, verknüpft mit einer UID. Filterbar nach Bewilligungstyp, Aufsichtskategorie oder Name.

`$ swissco finma --category 3 name city licence_type category uid Zürcher Kantonalbank Zürich Bank 3 CHE-105.842.028 Banque Cantonale Vaudoise Lausanne Bank 3 CHE-105.925.867`

### swissco lei \<UID>

Den Legal Entity Identifier einer Firma bei GLEIF nachschlagen. Zeigt den LEI, den Registrierungsstatus und welche Einheit diese Firma konsolidiert (direktes und oberstes Mutterhaus). Mit --children werden die von ihr konsolidierten Einheiten aufgelistet.

`$ swissco lei CHE-412.669.376 Legal name UBS Switzerland AG LEI 549300WOIFUSNYH0FL22 Registered as CHE-412.669.376 Jurisdiction CH Status ACTIVE Direct parent UBS Group AG (549300SZJ9VS8SGXAN81, CH) Ultimate parent UBS Group AG (549300SZJ9VS8SGXAN81, CH) Direct children 12`

### swissco research \<query>

Im Forschungsregister des Bundes (ARAMIS) suchen. Eine UID wird gegen die Teilnehmer-UID des Projekts geprüft; Freitext wird unverändert gesucht.

`$ swissco research CHE-115.694.164 title project_number office status start_date Hydrogen storage in metal hydrides SI/502345 SERI Completed 2022-03-01 Advanced fuel cell membranes SI/502891 SERI Ongoing 2024-01-15`

### swissco watch \<file>

Berechnet einen Fingerabdruck der Identitäts-, Adress- und Zweckfelder jeder Firma. Exit-Code 10 bei Änderungen, 0 wenn nichts geändert hat. Konzipiert für cron.

`$ swissco watch my_competitors.txt Checked 12 companies, 2 changed. $ echo $? 10`

## Ausgabeformate

Jeder Befehl unterstützt --format table|json|csv. Weitergeleitete und direkte Terminalausgabe sind byteidentisch. Derselbe Befehl funktioniert in einem Skript und in einem Notebook.

## Agent-Skill

swissco enthält einen Agent-Skill, der Claude Code, Cursor, Codex und anderen Coding-Agenten beibringt, das CLI zu bedienen. Einmal installiert, beantwortet ein Agent Fragen in natürlicher Sprache, indem er den passenden swissco-Befehl selbst ausführt.

`npx skills add prospex-ch/swissco-cli`

Der Skill wird installiert in .agents/skills/swissco/. Fügen Sie -g hinzu, um global für jedes Projekt zu installieren, oder --all um Standardwerte ohne Rückfrage zu übernehmen.

Sobald der Skill installiert ist, stellen Sie Ihrem Agenten Fragen wie:

`Welche Unternehmen in Zug erwähnen Blockchain in ihrem Zweck? Hat sich bei CHE-105.943.826 seit Juni etwas geändert? Liste die diese Woche neu eingetragenen Unternehmen im Kanton Waadt auf.`

Das swissco-CLI muss im PATH oder über uvx erreichbar sein, damit der Agent es ausführen kann.

## Datenquellen

| Quelle | Daten | Authentifizierung |
| --- | --- | --- |
| Zefix on LINDAS | Handelsregister: Firmenidentität, Rechtsform, Adresse, Zweck | Keine |
| SHAB | Amtsblattpublikationen, Ereignisklassifikation | Keine |
| Zefix REST | Kapital, Status, Löschungsdatum, frühere Namen, Konzernbeziehungen | Optionale Zugangsdaten |
| simap | Öffentliches Beschaffungswesen: Ausschreibungen, Zuschläge, Anbieterverzeichnis mit UID | Keine |
| FINMA | Bewilligte Banken und Wertpapierhäuser: Bewilligungstyp, Aufsichtskategorie | Keine |
| GLEIF | Legal Entity Identifiers: LEI, Registrierungsstatus, Konzernstruktur (wer wen konsolidiert) | Keine |
| ARAMIS | Bundesfinanzierte Forschungsprojekte: Titel, Amt, Teilnehmer mit UID | Keine |

Alle Befehle funktionieren ohne Authentifizierung. Optionale Zefix-Zugangsdaten schalten zusätzliche Felder frei in lookup und Präfixsuche in search. Die FINMA-Daten decken Banken und Wertpapierhäuser ab. Andere Bewilligungstypen stehen auf separaten Listen.

## Links

[GitHub](https://github.com/prospex-ch/swissco-cli) · [PyPI](https://pypi.org/project/swissco/) · [Dokumentation](https://swissco.readthedocs.io/) · Lizenz: MIT

Prospex verfolgt Ihren gesamten Markt und informiert Sie, wenn sich etwas ändert.

[Einen Beispielmarkt ansehen](https://prospex.ch/de/firmenliste-schweiz/)
