durenzidu/powpow-workbuddy-connector

Anleitung zur Nutzung des PowPop MCP Connectors

PowPop ist eine standortbasierte soziale App: Nutzer entdecken auf der Karte öffentliche digitale Menschen, echte Nutzer und Beiträge in ihrer Nähe, können mit digitalen Menschen chatten und an Check-in-Aktionen teilnehmen. Dieser Connector fasst diese Fähigkeiten in 9 schreibgeschützten Tools zusammen.

Authentifizierung & Voraussetzungen

• Öffentliche Inhalte benötigen keine Anmeldung: Digitale Menschen, Beiträge, Sehenswürdigkeiten, Aktionen, Mitgliedschaftspläne etc. in der Nähe können anonym abgefragt werden.
• Kontobezogene Funktionen benötigen Autorisierung: Wenn der erste Aufruf einen 401-Fehler zurückgibt, bedeutet dies, dass der Nutzer die OAuth-Autorisierung noch nicht abgeschlossen hat. Leiten Sie den Nutzer an, in den Connector-Einstellungen PowPop zu finden und die Autorisierung abzuschließen (die Autorisierungsseite wird von PowPop bereitgestellt). Wiederholen Sie den Vorgang danach. Der Autorisierungsstatus wird automatisch von der Plattform verwaltet (Token werden automatisch erneuert); es ist nicht nötig, wiederholt nachzufragen.
• Hinweis zum Koordinatensystem: Alle Tools, die Koordinaten verwenden, nutzen einheitlich das GCJ-02 (Gaode/Mars-Koordinatensystem). Wenn der Nutzer direkt GPS-Koordinaten (WGS-84) angibt, kann es zu Abweichungen von etwa 300–600 Metern kommen. Bevorzugen Sie Ortsnamen vom Nutzer; die Konvertierung erfolgt durch geocode_place oder den Parameter place der Tools.

Tool-Übersicht

Tool	Zweck	Schlüsselparameter	Typisches Szenario
find_nearby	Entdeckt digitale Menschen, echte Nutzer und Beiträge in der Nähe	lat+lng oder place (eines von beiden); radius_meters Standard 1000; types filtert nach Typ	„Wer/Was ist in meiner Nähe?“
geocode_place	Wandelt Ortsnamen in Koordinaten um und gibt die Konfidenz der Übereinstimmung an	place	Erster Schritt, bevor Koordinaten benötigt werden
get_digital_human	Vollständiges Profil eines digitalen Menschen (Persona/Beschreibung/Standort/Stimmung)	id (aus find_nearby)	„Nächster Schritt“ nach dem Finden eines digitalen Menschen
get_post_detail	Vollständiger Beitragstext + Kommentarliste	post_id (aus find_nearby/search_posts)	Diskussion unter einem bestimmten Beitrag anzeigen
nearby_attractions	Sehenswürdigkeiten und Geschäftsviertel in der Nähe (nach Entfernung)	lat+lng oder place; radius_meters Standard 3000	„Was gibt es in der Nähe zu sehen?“
search_posts	Sucht öffentliche Beiträge nach Schlüsselwörtern	keyword (Groß-/Kleinschreibung wird ignoriert)	„Beiträge über die Verbotene Stadt“
list_campaigns	Listet alle öffentlichen Aktionen auf (inkl. Check-in-Punkte)	Keine	„Welche Aktionen gibt es gerade?“
list_membership_plans	Preise für Mitgliedschaften/Pakete	Keine	„Was kostet eine Mitgliedschaft?“
whoami	Überprüft die aktuelle autorisierte Identität	Keine	„Wer bin ich?“ „Bin ich angemeldet?“

Das tatsächliche Parameterschema entnehmen Sie bitte den Echtzeitdaten von tools/list. Oben sind nur die häufig verwendeten Parameter aufgeführt; bei optionalen Parametern oder Abweichungen von Standardwerten diskutieren Sie nicht mit dem Benutzer, sondern rufen Sie gemäß dem Echtzeitschema auf.

Wichtige Hinweise zur Verwendung der einzelnen Tools

find_nearby – Kern-Tool zur Entdeckung in der Nähe

• Standort – Auswahl aus drei Optionen: place (Ortsname, empfohlen, automatische Codierung) > lat+lng (GCJ-02). Wenn keiner der Parameter übergeben wird, kann der Server den Standort nicht ermitteln und gibt einen Fehler zurück.
• types kann nach Bedarf filtern: digital_humans (digitale Menschen) / users (echte Nutzer) / posts (Beiträge); Standardmäßig werden alle zurückgegeben.
• Die Rückgabe enthält eine Zusammenfassung jeder Kategorie sowie die Entfernung. Karten von digitalen Menschen können mit get_digital_human erweitert werden.
• Beispiel: Der Benutzer sagt „Wer ist in der Nähe von Guomao?