Schweizer Kaufsignale in Clay und n8n

Mit Clay, n8n, Ihrem Sequencer und Ihrem CRM können Sie Firmendaten bereits anreichern und weitergeben. Prospex liefert dazu eine Liste passender Schweizer Firmen. Zu jeder Firma sehen Sie, warum sie zu Ihrem Markt passt, welche Angaben noch fehlen und was sich dort zuletzt getan hat.

Um einen Prospex-Markt in Clay oder n8n zu nutzen, rufen Sie die Firmendaten als JSON oder CSV ab. Erstellen Sie dazu einen Markt und kopieren Sie die Feed-URL. Ordnen Sie anschliessend die Felder den passenden Feldern in Ihrem Workflow zu.

Schweizer Firmendaten sind über Register, Amtsblätter, Markendatenbanken und Stellenportale verteilt. Prospex führt diese Quellen für Ihren Workflow zusammen.

Alles beginnt mit einem Markt

Jeder Feed gehört zu einem Markt und enthält die Firmen aus dem Tab Core oder Explore. Beschreiben Sie unter /app/lists/, an welche Firmen Sie verkaufen, und nennen Sie Beispielkunden. Erstellen Sie daraus Ihren Markt. Unter Core finden Sie die Firmen, die am besten passen. Unter Explore finden Sie weitere Firmen, die infrage kommen. Zu jeder Firma sehen Sie die Gründe für ihre Einstufung.

Der Feed liefert standardmässig die Firmen aus Core. Hängen Sie ?tab=explore für Explore an. Hat die URL bereits einen Query-String, hängen Sie &tab=explore an.

Öffnen Sie in Ihrem Markt Connect. Die Connect-Seite zeigt eine JSON-Feed-URL und eine CSV-Feed-URL. Beide enthalten dasselbe Zugriffstoken.

https://prospex.ch/app/lists/feed/{token}.json
https://prospex.ch/app/lists/feed/{token}.csv

Das Token in der URL gewährt Zugriff auf den Feed. Jede Person mit der URL kann die Daten des Marktes abrufen. Speichern Sie die URL bei den Zugangsdaten Ihres Automatisierungstools. Falls die URL in unbefugte Hände gerät, erzeugen Sie auf der Connect-Seite ein neues Token. Die alte URL wird sofort ungültig.

Der JSON-Feed

curl -s 'https://prospex.ch/app/lists/feed/{token}.json?limit=5'

Die Antwort enthält Metadaten zum Markt sowie Angaben zur Paginierung und zum Verbrauch. Die Firmendaten stehen im data-Array. Eine gekürzte Antwort sieht so aus:

{
  "version": 1,
  "market": {"id": 12, "name": "Romandie, 11–50", "refreshed_at": "…"},
  "count": 5,
  "total": 214,
  "has_more": true,
  "next_url": "https://prospex.ch/app/lists/feed/…?limit=5&cursor=…",
  "usage": {"rows_today": 5, "daily_limit": 500, "rows_this_month": 5, "monthly_limit": 1000},
  "data": [ … ]
}

Jedes Element in data steht für eine Firma. Felder, die häufig für Verknüpfungen und Filter verwendet werden, liegen auf der obersten Ebene. Die jüngsten Ereignisse stehen im verschachtelten Feld signals.

• company_id, company_url: die Firmen-ID und der Link zum Firmenprofil.
• fit und fit_label: fit ist der stabile Wert für Automatisierungsregeln (strong, good oder possible). fit_label ist die übersetzte Bezeichnung für die Anzeige.
• reasons: die Gründe, weshalb diese Firma zu Ihrem Markt passt, jeweils als Satz formuliert und im Arbeitsbereich auf einer eigenen Zeile angezeigt.
• missing: Angaben, die Prospex noch nicht verifiziert hat. Eine fehlende Angabe bedeutet nicht, dass die Firma das Kriterium nicht erfüllt.
• bucket: core oder explore.
• pinned, decided, in_crm: pinned ist wahr, wenn Sie bei dieser Firma manuell entschieden haben, sie zu behalten. decided ist wahr, wenn Sie die Firma angenommen oder abgelehnt haben. in_crm ist wahr, wenn sie an Ihr CRM übermittelt wurde.
• signal_count, latest_signal_date und signals: die letzten datierten Ereignisse der Firma, jedes mit Typ, Titel, Datum, Prospex-Link und Originalquelle.

Jede Zeile enthält ausserdem Firmenangaben: company_name, company_uid, company_website, company_domain, company_canton, company_city, company_sector, company_sector_code, company_sector_group, company_tagline, company_employee_size und company_audience.

Verwenden Sie company_domain, wenn das andere Tool Firmen anhand ihrer Website zuordnet. Für den Abgleich mit Schweizer Registerdaten eignet sich company_uid.

Passende Firmen und Anlässe für die Kontaktaufnahme erkennen

fit gibt an, wie gut eine Firma zum Markt passt. Unter signals sehen Sie, was sich dort zuletzt geändert hat. Zu jeder Firma erhalten Sie das Datum des letzten Signals und bis zu drei aktuelle Ereignisse. Zu jedem Ereignis gehören Typ, Titel, Datum, Prospex-Link und Originalquelle.

Mit latest_signal_date filtern Sie Firmen nach dem Datum ihres letzten Signals. Greifen Sie auf das verschachtelte signals-Array zu, wenn Ihr Workflow Details zum Ereignis benötigt. In n8n können Sie beispielsweise besonders gut passende Firmen herausfiltern, die kürzlich ihr Kapital erhöht haben, und sie samt Quellenlink zur weiteren Recherche weiterleiten. Gut passende Firmen ohne aktuelles Ereignis können Sie im Markt belassen und später prüfen.

Weitere Seiten über next_url abrufen

Jede Seite enthält standardmässig 100 Zeilen, maximal sind 500 möglich. Sind weitere Zeilen vorhanden, enthält next_url die vollständige URL der nächsten Seite. Rufen Sie diese ab und wiederholen Sie den Vorgang, bis next_url leer ist.

url = "https://prospex.ch/app/lists/feed/{token}.json?limit=500"
while url:
  page = requests.get(url).json()
  yield from page["data"]
  url = page["next_url"]

Ein Cursor ist an den Stand des Marktes gebunden, für den er erzeugt wurde. Wird der Markt zwischen zwei Anfragen aktualisiert, führt der alte Cursor zum Fehlercode 400. Beginnen Sie den Abruf erneut mit der ursprünglichen Feed-URL, um die aktualisierte Liste zu erhalten.

Clay

Sie können aus den Prospex-Daten eine neue Tabelle erstellen oder eine bestehende Tabelle ergänzen.

Neue Tabelle aus Prospex erstellen. Rufen Sie den JSON-Feed ab und wählen Sie das data-Array. Jedes Element wird zu einer Tabellenzeile. Mit regelmässigen Abrufen halten Sie die Tabelle auf dem Stand Ihres Marktes.

Prospex mit einer bestehenden Tabelle abgleichen. Importieren Sie die CSV-Datei in eine zweite Tabelle und gleichen Sie deren Domain-Spalte mit der Domain-Spalte Ihrer bestehenden Tabelle ab. Die CSV-Datei enthält eine Zeile pro Firma mit festen Spaltenüberschriften. Die Einträge eines Arrays stehen gemeinsam in einer Zelle. In Reasons sind sie durch senkrechte Striche getrennt, in Missing durch Kommas. Verwenden Sie JSON, wenn der Workflow die vollständigen Ereignisdetails braucht.

Prospex zeigt, wie gut eine Firma passt und was sich dort zuletzt getan hat.

n8n

Schedule Trigger → HTTP Request → Split Out auf data.

1. Fügen Sie einen Schedule Trigger hinzu.
2. Fügen Sie einen HTTP Request hinzu und setzen Sie die JSON-Feed-URL aus Prospex ein.
3. Aktivieren Sie die Paginierung. Verwenden Sie {{ $response.body.next_url }} als URL für die nächste Anfrage und beenden Sie den Abruf, sobald {{ $response.body.has_more }} falsch ist.
4. Fügen Sie Split Out hinzu und wählen Sie data.

Firmenfelder der obersten Ebene stehen jetzt als {{ $json.company_name }}, {{ $json.company_domain }} und {{ $json.fit }} bereit. Das Feld signals bleibt ein verschachteltes Array. Fügen Sie ein zweites Split Out hinzu, wenn der nächste Knoten ein Element pro Ereignis braucht.

Mit einem IF-Knoten können Sie beispielsweise den Wert von {{ $json.fit }} prüfen: Leiten Sie besonders gut passende Firmen zur Kontaktanreicherung oder Firmenrecherche weiter und sammeln Sie die übrigen zur späteren Prüfung in einer Tabelle. Sie können auch {{ $json.missing }} nach website filtern. So leiten Sie Firmen, deren missing-Array diesen Wert enthält, zur Website-Recherche weiter.

Monatliches Kontingent und Limits

Eine Zeile entspricht einem Unternehmen. Jeder Plan legt fest, wie viele Unternehmen ein Konto pro Kalendermonat abrufen kann, gemeinsam über die App, Markt-Feeds, Signal-Downloads, CSV-Exporte, die API und MCP: 250 mit Starter, 1'000 mit Pro und 10'000 mit Business. Ein Unternehmen zählt einmal pro Monat, egal über welchen Weg und wie oft es abgerufen wurde, und eine Seite mit Signalen zählt eine Zeile pro betroffenem Unternehmen. Zusätzlich gilt ein tägliches Sicherheitslimit; die Referenz zu den Limits nennt die Zahlen. Reicht das Kontingent mitten in einer Seite nicht mehr, liefert der Feed die Unternehmen, die noch hineinpassen, und einen Cursor zum Fortsetzen. Passt nichts mehr hinein, antwortet er mit 429 und einem Retry-After-Header. Die Connect-Seite zeigt den Verbrauch des Tages und des Monats. Der Tag wird um Mitternacht in der Zeitzone Europe/Zurich zurückgesetzt, der Monat am 1.

Derzeit lässt sich der Feed zeitgesteuert abrufen. Die Übermittlung per Webhook ist geplant.

Leiten Sie die qualifizierten Firmen an Ihren Sequencer oder Ihr CRM weiter. Wenn Sie die zugrundeliegenden Registerpublikationen brauchen, helfen Ihnen die Leitfäden zur Zefix-REST-API und zur SHAB-API weiter.