Für Entwickler und Agenten

Jede Regel ist ein JSON-Objekt.

Alles, was das UI kann, kann die API — die MCP-Tools rufen intern denselben Router auf und können deshalb nie abweichen.

API-Token erstellen Zum MCP-Server

rule.json

{
  "name": "HTML aus Beschreibung entfernen",
  "enabled": true,
  "definition": {
    "if": {
      "combinator": "and",
      "conditions": [
        { "field": "description", "op": "contains", "value": "<" }
      ]
    },
    "then": [
      { "action": "strip_html", "field": "description" }
    ]
  }
}

shell

curl -X POST https://app.firefeeds.io/api/v1/rulesets/12/rules \
  -H "Authorization: Bearer fft_9c41…" \
  -H "Content-Type: application/json" \
  -d @rule.json

REST-API

Basis /api/v1, Authentifizierung per Bearer-Token.

Tokens werden nur als Hash gespeichert — den Klartext gibt es einmalig beim Anlegen. Fehler kommen als JSON mit passendem Status: 400 Validierung, 401 Auth, 404 nicht gefunden.

Häufig genutzte Endpunkte der FireFeeds-REST-API
Methode	Pfad	Zweck
GET	/api/v1/projects	Projekte auflisten
POST	/api/v1/projects/{id}/sources	Quelle anlegen (xml_url, csv_url, shopware)
POST	/api/v1/projects/{id}/sources/{sourceID}/runs	Eine einzelne Quelle importieren
POST	/api/v1/projects/{id}/runs	Alle Quellen des Projekts importieren
POST	/api/v1/rulesets/{setID}/rules	Regel in ein Regelset schreiben
POST	/api/v1/rulesets/{setID}/rules/impact	Wirkung einer Regel messen, bevor sie live geht
GET	/feeds/{token}.xml	Fertiger Feed — live gerendert, stabile URL

Die vollständige Referenz — Operatoren, Aktionen, Kanal-Mapping und Feed-Formate — steht in der Anwendung unter Einstellungen sowie im Repository unter docs/.

MCP-Server

Ein Agent, der den ganzen Funktionsumfang steuert.

Anbindung per API-Token in Claude Code oder als Konnektor in claude.ai über den mitgelieferten OAuth-Server.

Claude Code

claude mcp add --transport http firefeeds \
  https://app.firefeeds.io/mcp \
  --header "Authorization: Bearer fft_…"

Auswahl der verfügbaren MCP-Tools
MCP-Tool	Beschreibung	Scope
ff_projekte_liste	Projekte, Quellen und Feed-URLs auflisten	read
ff_import_starten	Import anstoßen, Status über ff_import_status	write
ff_regel_speichern	Regel in ein Regelset schreiben	write
ff_regel_wirkung	Treffer und Änderungen über den ganzen Bestand	read
ff_feed_qualitaet	Feed gegen die Merchant-Center-Anforderungen prüfen	read

OAuth + Google-SSO

Konnektor-Anmeldung in claude.ai ohne manuelles Token-Handling.

Ein Router für alles

Die MCP-Tools rufen denselben HTTP-Router auf wie die Oberfläche — eine zweite Implementierung, die auseinanderlaufen könnte, gibt es nicht.

Streaming-Import

Seitenweise nach Postgres — konstanter Speicher auch bei 180.000+ Produkten.

Token holen, Regel schreiben.

Die API ist ab dem Pro-Plan enthalten — inklusive MCP-Server und OAuth-Konnektor.

Projekt anlegen Preise ansehen