AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Geben Sie einem LangChain-Agenten Tools für Instagram, TikTok und WhatsApp

Ein LangChain-Agent erhält Instagram-, TikTok-, WhatsApp- und weitere Kanäle als Tools vom MCP-Server von easyCoexistence unter https://easycoexistence.com/api/mcp, geladen durch MCPAdapter, den MCP-Client von LangChain, wobei FastMCP die OAuth-Anmeldung übernimmt. create_agent kann dann Beiträge veröffentlichen und planen, auf Kommentare und DMs antworten und Insights über die offizielle API jedes Netzwerks abrufen, während signierte Ereignisse neue Kommentare und Nachrichten an Ihre Route senden.

Beta

Die Bezeichnung von LangChain für seinen Namensraum langchain.mcp, der langchain[mcp] 1.4.0 oder neuer benötigt und FastMCP mitbringt.

In memory

Wo FastMCP OAuth-Token speichert, sofern token_storage kein Backend angibt, sodass ein Neustart eine erneute Anmeldung erfordert.

127.0.0.1

Die Loopback-Adresse des temporären Callback-Servers, den FastMCP für die Anmeldung im Browser startet, auf einem freien Port oder callback_port.

60 days

Wie lange ein Refresh-Token des MCP von easyCoexistence gültig ist; Access-Token gelten eine Stunde, und jede Erneuerung stellt ein neues Paar aus.

8 seconds

Wie lange easyCoexistence auf die Antwort Ihrer Route auf eine weitergeleitete Kommentar- oder DM-Nachricht wartet, die einmal gesendet und nie wiederholt wird.

Welche Tools erhält ein LangChain-Agent von easyCoexistence?

Mehr als 50, als gewöhnliche LangChain-Tools, die create_agent aufrufen kann. Die Social-Tools erwarten eine account_id, daher beginnt der Agent mit list_social_accounts und übergibt dessen IDs an die Tools zum Veröffentlichen, Lesen und Beantworten von Kommentaren, zum Ausblenden und zum Abrufen von Insights. Tools, die zu einem einzelnen Netzwerk gehören, tragen dessen Namen, etwa publish_tiktok_post oder upload_youtube_video. Eine WhatsApp-Nummer beginnt mit list_numbers, das die connection_id zurückgibt, welche send_message und send_template verwenden. Die Beschreibung jedes Tools enthält die eigenen Regeln des Netzwerks, sodass das Modell beispielsweise lernt, dass eine TikTok-Antwort öffentlich ist. Beim Posten kommt später ein weiteres Argument hinzu: Mit scheduled_at wird der Beitrag in die Warteschlange von easyCoexistence gestellt.

Instagrampublish_instagram_post, reply_to_comment, send_social_dm, get_social_insights
TikTokpublish_tiktok_post, get_tiktok_publish_status, reply_to_comment with post_id
WhatsApplist_numbers, send_message, send_template, get_number_health
Facebookpublish_facebook_post, reply_to_comment, send_social_dm for Messenger
YouTube and LinkedInupload_youtube_video, reply_to_youtube_comment, publish_linkedin_post, get_linkedin_stats
The queuelist_scheduled_posts, update_scheduled_post, cancel_scheduled_post, retry_scheduled_post

Wie meldet sich der Agent bei easyCoexistence an?

Mit dem OAuth-Helfer von FastMCP, den MCPAdapter zur Authentifizierung nutzt. Beim ersten Lauf ermittelt er den Autorisierungsserver von easyCoexistence, registriert sich als Client, öffnet den Browser mit der Zustimmungsseite, auf der sein client_name angezeigt wird, und empfängt den Code über einen lokalen Callback unter 127.0.0.1. Danach werden Access-Token ohne Browser erneuert. Token werden im Speicher gehalten, sofern der Helfer kein token_storage-Backend erhält; deshalb speichert das Beispiel sie auf der Festplatte, verschlüsselt mit einem Fernet-Schlüssel. Filtern Sie die Liste, bevor create_agent sie erhält: Die Tools halten den MCP-Client, sodass der Agent weiterarbeitet, nachdem der async with-Block geschlossen wurde.

A reply agent's tools, with a sign-in that survives restarts
import os

from cryptography.fernet import Fernet
from fastmcp import Client
from fastmcp.client.auth import OAuth
from key_value.aio.stores.disk import DiskStore
from key_value.aio.wrappers.encryption import FernetEncryptionWrapper
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

URL = "https://easycoexistence.com/api/mcp"

# Kept on disk and encrypted, so the browser sign-in happens once
oauth = OAuth(
    client_name="Acme reply agent",  # shown on easyCoexistence's consent screen
    callback_port=8765,
    token_storage=FernetEncryptionWrapper(
        key_value=DiskStore(directory="~/.easycoexistence/oauth"),
        fernet=Fernet(os.environ["TOKEN_KEY"]),
    ),
)

REPLY_TOOLS = {"list_social_accounts", "list_social_comments", "reply_to_comment",
               "hide_comment", "send_social_dm"}

RULES = (
    "You reply to comments and DMs for Acme, on the account_id in the event. "
    "TikTok replies are public and need the video ID as post_id. "
    "Never reply to the account's own messages or replies."
)

async def build_reply_agent(model: str):
    async with MCPAdapter(Client(URL, auth=oauth)) as adapter:
        tools = [t for t in await adapter.list_tools() if t.name in REPLY_TOOLS]
    return create_agent(model, tools, system_prompt=RULES)

Wie gelangen Kommentare und DMs zu einem LangChain-Agenten?

Als signierte POST-Anfragen an eine Route von Ihnen, da MCP nur auf die Aufrufe antwortet, die der Agent macht. Verknüpfen Sie jedes Konto mit der Route über set_social_webhook_destination, das der Agent einmal aufruft oder das Sie aus Claude oder ChatGPT ausführen, und bewahren Sie das zurückgegebene signing_secret auf. Instagram und Facebook leiten Kommentare, Erwähnungen und DMs weiter, TikTok leitet Kommentare weiter; jedes Ereignis enthält platform, account_id, external_id und den eigenen Eintrag des Netzwerks. Die Route prüft X-EC-Signature, antwortet sofort, da easyCoexistence 8 Sekunden wartet und nicht erneut sendet, und übergibt das Ereignis im Hintergrund an den Agenten. Ein Checkpointer mit einer thread_id pro DM-Absender speichert den Verlauf einer Unterhaltung.

A FastAPI route that verifies the event, then runs the agent
import hashlib, hmac, json, time

from fastapi import BackgroundTasks, FastAPI, HTTPException, Request

app = FastAPI()  # at startup: app.state.agent = await build_reply_agent("<MODEL>")
SECRETS: dict[str, str] = {}  # account_id -> signing_secret, kept in your database

def signed(raw: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > 300:
        return False
    mac = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac.encode(), v1.encode())

@app.post("/hooks/social")
async def social_event(request: Request, background: BackgroundTasks):
    raw = await request.body()
    event = json.loads(raw)  # platform, account_id, external_id, entry
    secret = SECRETS.get(event.get("account_id", ""))
    if not secret or not signed(raw, request.headers.get("x-ec-signature", ""), secret):
        raise HTTPException(status_code=401)
    background.add_task(reply, event)  # runs after the response is sent
    return {"received": True}

async def reply(event: dict) -> None:
    prompt = json.dumps(event)  # the agent reads the platform, the account and the entry
    await app.state.agent.ainvoke({"messages": [{"role": "user", "content": prompt}]})

Was erlaubt jedes Netzwerk dem Agenten?

Was die API des Netzwerks dem Konto erlaubt, was die Anweisungen des Agenten klar angeben sollten:

  • Instagram- und Messenger-DMs: send_social_dm antwortet Personen, die in den letzten 24 Stunden geschrieben haben, und Instagram begrenzt eine DM auf 1.000 Byte UTF-8.
  • Kommentarantworten: reply_to_comment antwortet öffentlich, oder mit private auf true sendet eine DM pro Instagram- oder Facebook-Kommentar innerhalb von 7 Tagen nach dem Kommentar.
  • TikTok: Antworten sind immer öffentlich und benötigen die ID des Videos als post_id; auf TikTok gibt es keine DMs.
  • WhatsApp: send_message funktioniert innerhalb von 24 Stunden nach der letzten Nachricht des Kunden, und send_template mit einer genehmigten Vorlage außerhalb dieses Zeitraums.
  • Medien: Jede Datei muss unter einem öffentlichen HTTPS-Link liegen; Instagram nimmt JPEG-Bilder, und TikTok-Fotobeiträge nehmen JPEG oder WebP.

Wann sollte Code die Netzwerke ohne den Agenten ansprechen?

Wenn ein Schritt immer gleich ablaufen muss oder ohne jemanden, der sich anmeldet. get_social_credentials übergibt dem Agenten die API-Basis eines Kontos, dessen ID im Netzwerk und, bei TikTok, YouTube und LinkedIn, ein Token, das jetzt gültig ist, und die Partner API liefert dasselbe über GET /api/v1/channels/:id?credentials=1 mit einem ec_live_-Schlüssel, sodass ein Python-Job TikTok, Google oder LinkedIn direkt aufrufen kann. Antworten, die ohne den Agenten zu jeder Zeit hinausgehen müssen, etwa fester Text für ein Schlüsselwort, passen zu Kommentarregeln und Automatisierungen, die easyCoexistence selbst ausführt.

Häufige Fehler

  • Auf Ereignisse antworten, die das Konto selbst ausgelöst hat. Instagram gibt die eigenen DMs des Kontos mit is_echo auf true zurück und liefert seine öffentlichen Antworten als Kommentare; filtern Sie sie aus, bevor der Agent sie sieht, sonst antwortet er sich selbst.
  • Den Agenten laufen lassen, bevor die Route antwortet. easyCoexistence wartet 8 Sekunden auf eine 2xx-Antwort und wiederholt nie; ein Handler, der auf das Modell wartet, verliert das Ereignis. Antworten Sie zuerst und arbeiten Sie im Hintergrund.
  • reply_to_comment für einen TikTok-Kommentar ohne post_id aufrufen. Die TikTok-Antwort nennt das Video ebenso wie den Kommentar; übergeben Sie deshalb die video_id des Ereignisses als post_id.
  • Einem Antwort-Agenten die Veröffentlichungs-Tools geben. Filtern Sie die Liste nach Namen, bevor create_agent sie erhält, damit ein falsch gelesener Kommentar keinen Beitrag veröffentlichen, löschen oder eine Automatisierung ändern kann.
Mit EasyCoexistence

easyCoexistence gibt Ihren LangChain-Agenten Reichweite zu Kunden auf WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn und weiteren Kanälen, jeweils über deren offizielle API: ein MCP-Server hinter einer OAuth-Anmeldung, signierte Kommentar- und DM-Ereignisse und eine Warteschlange, die bis zu 90 Tage im Voraus plant, wobei jede Verbindung rund um die Uhr überwacht wird. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, die ersten 3 Tage sind kostenlos.

Häufig gestellte Fragen

Braucht der Agent eine eigene Entwickler-App von Meta, TikTok oder Google?

Nein. Konten verbinden sich über die eigene App von easyCoexistence in jedem Netzwerk, im Dashboard oder über einen Verbindungslink der Partner API, und der Agent erreicht alle über eine einzige Anmeldung bei easyCoexistence.

Kann der Agent Beiträge planen, statt sofort zu veröffentlichen?

Ja. publish_instagram_post, publish_facebook_post, publish_tiktok_post und publish_linkedin_post nehmen scheduled_at entgegen, eine Zeit nach ISO 8601 mit Zeitzone, von 1 Minute bis 90 Tage im Voraus. YouTube plant nativ mit upload_youtube_video und publish_at.

Welche Modelle können den Agenten betreiben?

Jedes Chat-Modell, das create_agent mit Tools nutzen kann. Die MCP-Tools hängen nicht vom Modell ab, und der Anbieter des Modells rechnet seine eigene Nutzung ab; easyCoexistence berechnet pro Verbindung, niemals pro Tool-Aufruf.

Was kostet easyCoexistence für einen LangChain-Agenten?

US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, auf jedem Netzwerk gleich. Der MCP-Server, die weitergeleiteten Ereignisse und die Partner API sind enthalten, und die ersten 3 Tage sind kostenlos.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am