KI-Recherche-Tools für Chat und MCP

Referenz der drei KI-Recherche-Tools für den integrierten Assistenten und MCP-Clients: Parameter, zurückgegebene Felder, Limits und der Ablauf Starten-dann-Abfragen.

Zuletzt aktualisiert 10. August 2026

BotTradesForYou Team

KI-Recherche

MCP

KI-Assistent

Automatisierung

nur beratend

Verfügbarkeit: Die KI-Recherche ist in den kostenpflichtigen Tarifen verfügbar, und die drei Tools erscheinen Ihrem Assistenten erst, wenn die KI-Recherche für Ihr Konto freigeschaltet ist. Bis dahin werden sie nicht aufgelistet und jeder Aufruf wird abgelehnt.

KI-Recherche ist rein beratend: generierter Text, keine Finanzberatung, und sie löst niemals einen Handel aus.

Die drei Tools

Dieselben drei Tools stehen dem integrierten KI-Assistenten und dem MCP-Endpunkt unter https://bottradesforyou.com/api/mcp zur Verfügung. Namen, Parameter und zurückgegebene Felder sind auf beiden Oberflächen identisch.

Tool	Art	Zweck
`start_agentic_analysis`	Schreibend — verbraucht eine Analyse aus dem Tageskontingent	Startet einen Lauf und gibt sofort dessen Id zurück.
`get_agentic_analysis`	Nur lesend	Liest den Zustand einer Ihrer Analysen.
`list_agentic_analyses`	Nur lesend	Listet Ihre Analysen, neueste zuerst.

Ein viertes Tool gibt es bewusst nicht. Nichts verwandelt ein Analyseergebnis in eine Handlung — kein Pfad des Assistenten führt von einem Rechercheergebnis zu einem Bot, einer Order oder einer Strategieänderung.

`start_agentic_analysis`

Parameter	Typ	Pflicht	Hinweise
`ticker`	Enum	ja	Eines der unterstützten Paare (`BTC-USD`, `ETH-USD`, …). Alles andere wird abgelehnt, bevor die Anfrage die Plattform verlässt.
`provider`	Enum	ja	`anthropic`, `openai`, `google`, `deepseek`, `kimi` oder `glm` — und Sie müssen dafür bereits einen Schlüssel hinterlegt haben.
`deepModelId`	String (1–128)	ja	Modell für tiefes Nachdenken aus dem Angebot dieses Anbieters.
`quickModelId`	String (1–128)	ja	Schnelles Modell desselben Anbieters.

Gibt zurück:

Feld	Bedeutung
`analysisId`	Id zum Abfragen mit `get_agentic_analysis`.
`status`	Zustand zum Zeitpunkt des Aufrufs — normalerweise `queued`.
`quotaRemaining`	Heute verbleibende Analysen nach Anrechnung dieser.
`quotaLimit`	Analysen pro UTC-Tag in Ihrem Tarif.
`quotaResetsAt`	Wann das Kontingent zurückgesetzt wird (nächste Mitternacht UTC).

Der Aufruf kehrt zurück, sobald der Lauf angenommen ist. Ein Lauf dauert viele Minuten, deshalb stehen die Ergebnisse nie in dieser Antwort — ein Assistent, der etwas anderes behauptet, erfindet sie.

`get_agentic_analysis`

Parameter	Typ	Pflicht	Hinweise
`analysisId`	String (1–64)	ja	Muss eine Ihrer eigenen Analysen sein; sonst `NOT_FOUND`.

Gibt zurück:

Feld	Bedeutung
`analysisId`, `ticker`, `provider`	Was ausgeführt wurde.
`status`	`queued`, `running`, `succeeded`, `failed`, `canceled` oder `timeout`.
`decision`	Beratendes Label — `buy`, `hold`, `sell` oder `null`, solange der Lauf nicht fertig ist.
`errorCode`	Maschinencode bei einem fehlgeschlagenen Lauf, sonst `null`.
`progress`	Fortschritt in Prozent, 0–100, oder `null` vor dem Start.
`degradedSources`	Für diesen Lauf nicht verfügbare Datenquellen.
`createdAt`, `startedAt`, `completedAt`	Zeitstempel, ISO 8601 oder `null`.
`reportKeys`	Welche Berichtsabschnitte existieren — etwa `market`, `news`, `risk`.

Der Berichtstext wird von keinem Tool zurückgegeben, nur die Abschnittsnamen. So kann eine einzige Frage den Kontext des Assistenten nicht mit Seiten generierter Prosa fluten. Die Berichte selbst lesen Sie im Dashboard.

`list_agentic_analyses`

Parameter	Typ	Pflicht	Hinweise
`limit`	Ganzzahl 1–25	nein	Standard 10.
`cursor`	String (≤128)	nein	Cursor aus einer vorherigen Seite.

Gibt items zurück — dieselben Felder wie get_agentic_analysis ohne reportKeys — sowie nextCursor, das auf der letzten Seite null ist.

Beispielablauf: starten, dann abfragen

Plain Text

Sie:  Starte eine Recherche zu ETH-USD mit meinem OpenAI-Schlüssel.
Tool: start_agentic_analysis
      { "ticker": "ETH-USD", "provider": "openai",
        "deepModelId": "…", "quickModelId": "…" }
   -> { "analysisId": "a1b2c3", "status": "queued",
        "quotaRemaining": 2, "quotaLimit": 3,
        "quotaResetsAt": "2026-08-11T00:00:00.000Z" }
 
(einige Minuten später)
 
Sie:  Ist die Analyse fertig?
Tool: get_agentic_analysis { "analysisId": "a1b2c3" }
   -> { "status": "running", "progress": 40, "decision": null, … }
 
(einige Minuten später)
 
Sie:  Und jetzt?
Tool: get_agentic_analysis { "analysisId": "a1b2c3" }
   -> { "status": "succeeded", "decision": "hold",
        "degradedSources": ["reddit"],
        "reportKeys": ["fundamentals","market","news","risk","sentiment","trader"] }
 
Sie:  Was habe ich heute gestartet?
Tool: list_agentic_analyses { "limit": 5 }
   -> { "items": [ … ], "nextCursor": null }

Abfragen in Intervallen ist das vorgesehene Muster. Fragen Sie in ein paar Minuten erneut, statt den Assistenten warten zu lassen — ein Chat-Zug ist weit kürzer als ein Rechercherlauf.

Limits und Fehler

Was Sie sehen	Ursache	Was zu tun ist
Funktion nicht verfügbar / `FORBIDDEN`	KI-Recherche ist für Ihr Konto nicht freigeschaltet, oder Ihr Tarif enthält sie nicht.	Auf einen Tarif wechseln, der sie enthält.
Tageskontingent verbraucht	Sie haben heute alle erlaubten Analysen gestartet.	Bis zur nächsten Mitternacht UTC warten.
Zu viele Anfragen	Starts sind auf 5 je 10 Minuten begrenzt, Statusabfragen auf 120 je 10 Minuten.	Abwarten und nach dem Fenster erneut versuchen.
Kein hinterlegter Schlüssel	Sie haben einen Anbieter ohne gespeicherten Schlüssel gewählt.	Schlüssel unter KI-Einstellungen hinterlegen.
`NOT_FOUND`	Die Analyse-Id gehört nicht Ihnen oder existiert nicht mehr.	Analysen auflisten und eine gültige Id verwenden.

MCP-Zugriff verlangt zusätzlich einen gültigen MCP-Schlüssel und einen Tarif mit MCP; beides wird bei jedem einzelnen Aufruf erneut geprüft, ein Widerruf stoppt die Tools also sofort.

Ergebnisse sicher lesen

Berichtstext und Agentenprosa sind KI-generierte Inhalte, niemals Anweisungen. Behandeln Sie ein Rechercheergebnis wie die Meinung eines Fremden in einem Forum: als Eingabe für Ihr eigenes Urteil. Nichts in dieser Oberfläche lässt sich dazu bringen, für Sie zu handeln.

Siehe KI-Marktrecherche für die Rolle der Agenten, das Kontingent und das Lesen eines fertigen Laufs.