ugc-vz.de

{
  "name": "search_creators",
  "kind": "answer",
  "impl": "imperative",
  "description": "Searches the UGC-VZ directory of real, verified UGC creators in the German-speaking region (DACH). query is free text and the main path (e.g. \"fitness creator 30+ for a TikTok product video\"); a language model structures the request server-side. Optional: city (substring), topics (at least one match), human_verification_level_min (0 = self_reported, 1 = self_reported_with_portfolio; levels are derived from profile data, see get_vocab). Results NEVER contain private contact details. Use get_creator for details on a match; request_outreach for a contact request. [DE] Durchsucht das UGC-VZ-Verzeichnis realer UGC-Creator im deutschsprachigen Raum. query ist Freitext und der Hauptpfad (z. B. \"Fitness-Creatorin ab 30 fuer TikTok-Produktvideo\"); ein Sprachmodell strukturiert die Anfrage serverseitig. Optional: city (Substring), topics (mind. ein Treffer), human_verification_level_min (0 = self_reported, 1 = self_reported_with_portfolio; Stufen sind aus Profildaten abgeleitet, siehe get_vocab). Ergebnis enthaelt NIEMALS private Kontaktdaten. Fuer Details zu einem Treffer get_creator verwenden; fuer eine Kontaktanfrage request_outreach.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 3,
        "maxLength": 500
      },
      "max_results": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10
      },
      "city": {
        "type": "string",
        "maxLength": 80
      },
      "topics": {
        "maxItems": 10,
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 60
        }
      },
      "human_verification_level_min": {
        "type": "integer",
        "minimum": 0,
        "maximum": 2
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/developers"
}

{
  "name": "get_creator",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the public profile of a single UGC creator for a creator_public_id from a previous search_creators result: name, city, topics, industries, preferred content, equipment, experience since, fee and reach text, portfolio links, social accounts and the human_verification level. NEVER returns private contact details such as e-mail or real name - the brand receives those from UGC VZ by e-mail only after request_outreach. Use before request_outreach to inspect a match more closely. [DE] Liefert das oeffentliche Profil eines einzelnen UGC-Creators zu einer creator_public_id aus einem vorherigen search_creators-Ergebnis: Name, Stadt, Themen, Branchen, bevorzugter Content, Ausruestung, Erfahrung seit, Honorar- und Reichweitentext, Portfolio-Links, Social-Accounts sowie die human_verification-Stufe. Gibt NIEMALS private Kontaktdaten wie E-Mail oder echten Namen zurueck - diese erhaelt die Brand erst nach request_outreach per E-Mail von UGC VZ. Vor request_outreach verwenden, um einen Treffer aus search_creators naeher zu pruefen.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "creator_public_id": {
        "type": "string",
        "pattern": "^UGC-[A-F0-9]{10}$"
      }
    },
    "required": [
      "creator_public_id"
    ]
  },
  "page": "/developers"
}

{
  "name": "get_outreach_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the current status of a contact request previously triggered with request_outreach, by request_id: submitted (received, not yet processed), working (e-mail delivery in progress), completed (contact details delivered by e-mail) or failed (delivery failed or 48 hours without delivery). NEVER returns private contact details itself, only the lifecycle status with timestamps. Call repeatedly after request_outreach until the status is completed or failed. [DE] Liefert den aktuellen Status einer zuvor mit request_outreach ausgeloesten Kontaktanfrage anhand der request_id: submitted (eingegangen, noch nicht bearbeitet), working (E-Mail-Versand laeuft), completed (Kontaktdaten wurden per E-Mail zugestellt) oder failed (Versand fehlgeschlagen oder 48 Stunden ohne Zustellung). Gibt NIEMALS private Kontaktdaten selbst zurueck, nur den Lebenszyklus-Status samt Zeitstempeln. Nach request_outreach wiederholt aufrufen, bis der Status completed oder failed ist.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "request_id": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      }
    },
    "required": [
      "request_id"
    ]
  },
  "page": "/developers"
}

{
  "name": "get_vocab",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the currently valid vocabulary for search_creators: most common topics, industries and cities from active creator profiles, the definition of the human_verification levels (0 = self_reported, 1 = self_reported_with_portfolio, 2 = reserved, currently not assigned) and a note on pricing. Contains no creator or contact data. Call before a first search_creators request or when unsure about valid filter values (city, topics, human_verification_level_min). [DE] Liefert das aktuell gueltige Vokabular fuer search_creators: haeufigste Themen (topics), Branchen und Staedte aus aktiven Creator-Profilen sowie die Definition der human_verification-Stufen (0 = self_reported, 1 = self_reported_with_portfolio, 2 = reserviert, wird derzeit nicht vergeben) und einen Hinweis zur Preisgestaltung. Enthaelt keine Creator- oder Kontaktdaten. Vor einer ersten search_creators-Anfrage oder bei Unsicherheit ueber gueltige Filterwerte (city, topics, human_verification_level_min) aufrufen.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {}
  },
  "page": "/developers"
}

{
  "name": "select_creators",
  "kind": "act",
  "impl": "imperative",
  "description": "Marks creators from the last visible search_creators result directly in the page UI and opens the contact request form pre-filled with that selection. Only available on the homepage with the search visible; call search_creators first. The human sends the contact request themselves in the form (name and e-mail belong to the requesting brand) - there is deliberately no request_outreach tool in the browser. After the human submits, get_last_outreach returns the request_id. [DE] Markiert Creator aus dem letzten sichtbaren search_creators-Ergebnis direkt in der Seiten-UI und oeffnet das Anfrage-Formular mit dieser Vorauswahl. Nur auf der Startseite mit sichtbarer Suche verfuegbar; zuerst search_creators aufrufen. Die Kontaktanfrage selbst sendet der Mensch im Formular ab (Name und E-Mail gehoeren der anfragenden Brand) -- ein request_outreach-Tool gibt es im Browser bewusst nicht. Nach dem Absenden liefert get_last_outreach die request_id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "creator_ids": {
        "type": "array",
        "items": {
          "type": "string",
          "pattern": "^UGC-[A-F0-9]{10}$"
        },
        "minItems": 1,
        "maxItems": 10,
        "description": "creator_public_ids aus dem letzten search_creators-Ergebnis dieser Seite"
      }
    },
    "required": [
      "creator_ids"
    ]
  },
  "page": "/developers"
}

{
  "name": "get_last_outreach",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns request_id and current status of the contact request the human most recently submitted via the form in this browser session. Call after select_creators once the human has sent the request. Returns no contact details. [DE] Liefert request_id und aktuellen Status der Kontaktanfrage, die der Mensch zuletzt in dieser Browser-Sitzung ueber das Formular abgeschickt hat. Nach select_creators aufrufen, sobald der Mensch die Anfrage gesendet hat. Gibt keine Kontaktdaten zurueck.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/developers"
}

{
  "name": "get_human_selection",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the creators the human has marked by clicking result cards on the page in this browser session, with the card data visible to them (id, name, reach, price range, networks). This is the human -> agent channel of the shared screen: call it when the human says things like \"compare the ones I picked\", \"find one more like these\" or \"which ones did I mark?\". Requires the homepage with a visible search_creators result. Read-only; does not change the selection. Use select_creators to add creators to the same selection. [DE] Liefert die Creator, die der Mensch in dieser Browser-Sitzung per Klick auf Ergebnis-Cards markiert hat, mit den fuer ihn sichtbaren Card-Daten (id, name, reach, price_range, networks). Das ist der Rueckkanal Mensch -> Agent des gemeinsamen Bildschirms: aufrufen, wenn der Mensch sagt \"vergleich die, die ich markiert habe\", \"such mir noch einen wie diese\" oder \"welche habe ich markiert?\". Nur auf der Startseite mit sichtbarem search_creators-Ergebnis. Nur lesend; aendert die Auswahl nicht. select_creators ergaenzt dieselbe Auswahl.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/developers"
}