MasukMulai uji coba gratis
easyCoexistence API resmi

Beri agen LangChain alat untuk Instagram, TikTok dan WhatsApp

Agen LangChain mendapatkan Instagram, TikTok, WhatsApp, dan saluran lainnya sebagai alat dari server MCP easyCoexistence di https://easycoexistence.com/api/mcp, dimuat oleh MCPAdapter, klien MCP LangChain, dengan FastMCP yang menjalankan login OAuth. create_agent kemudian dapat menerbitkan dan menjadwalkan postingan, membalas komentar dan DM, serta membaca insight melalui API resmi masing-masing jaringan, sementara event yang ditandatangani membawa komentar dan pesan baru ke rute Anda.

Beta

Label LangChain untuk namespace langchain.mcp, yang membutuhkan langchain[mcp] 1.4.0 atau lebih baru dan membawa FastMCP.

In memory

Tempat FastMCP menyimpan OAuth token kecuali token_storage menentukan backend, sehingga restart berarti login ulang.

127.0.0.1

Alamat loopback dari server callback sementara yang dijalankan FastMCP untuk login lewat browser, di port bebas atau callback_port.

60 days

Berapa lama refresh token MCP easyCoexistence berlaku; access token berlaku satu jam, dan setiap refresh menerbitkan pasangan baru.

8 seconds

Berapa lama easyCoexistence menunggu rute Anda membalas komentar atau DM yang diteruskan, dikirim sekali dan tidak pernah dicoba ulang.

Alat apa yang didapat agen LangChain dari easyCoexistence?

Lebih dari 50, sebagai alat LangChain biasa yang dapat dipanggil create_agent. Alat sosial membutuhkan account_id, sehingga agen mulai dengan list_social_accounts lalu meneruskan ID-nya ke publish, membaca, dan membalas komentar, menyembunyikannya, serta membaca insight. Alat milik satu jaringan membawa namanya, seperti publish_tiktok_post atau upload_youtube_video, dan nomor WhatsApp dimulai dari list_numbers, yang mengembalikan connection_id yang dibutuhkan send_message dan send_template. Deskripsi setiap alat memuat aturan jaringan itu sendiri, sehingga model memahami, misalnya, bahwa balasan TikTok bersifat publik. Memposting membutuhkan satu argumen lagi: scheduled_at menempatkan postingan di antrean easyCoexistence.

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

Bagaimana agen masuk ke easyCoexistence?

Dengan helper OAuth FastMCP, yang digunakan MCPAdapter untuk autentikasi. Saat pertama kali dijalankan, agen menemukan server otorisasi easyCoexistence, mendaftarkan dirinya sebagai klien, membuka browser ke layar persetujuan, tempat client_name-nya ditampilkan, lalu menerima kode di callback lokal pada 127.0.0.1. Setelah itu, access token diperbarui tanpa browser. Token disimpan di memori kecuali helper mendapat backend token_storage, jadi contoh ini menyimpannya di disk, dienkripsi dengan kunci Fernet. Saring daftar sebelum create_agent melihatnya: alat menyimpan klien MCP, sehingga agen tetap bekerja setelah blok async with ditutup.

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)

Bagaimana komentar dan DM sampai ke agen LangChain?

Sebagai permintaan POST bertanda tangan ke rute milik Anda, karena MCP hanya menjawab panggilan yang dibuat agen. Arahkan setiap akun ke rute dengan set_social_webhook_destination, yang diminta agen sekali atau dijalankan dari Claude atau ChatGPT, dan simpan signing_secret yang dikembalikannya. Instagram dan Facebook meneruskan komentar, mention, dan DM, sedangkan TikTok meneruskan komentar; setiap event membawa platform, account_id, external_id, dan entri asli jaringan tersebut. Rute memeriksa X-EC-Signature, langsung merespons, karena easyCoexistence menunggu 8 detik dan tidak mencoba ulang, lalu menyerahkan event ke agen di latar belakang. Checkpointer dengan thread_id per pengirim DM menjaga riwayat percakapan.

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}]})

Apa yang boleh dilakukan agen di setiap jaringan?

Apa yang diizinkan API jaringan untuk akun, yang sebaiknya dinyatakan dengan jelas dalam instruksi agen:

  • DM Instagram dan Messenger: send_social_dm membalas orang yang menulis dalam 24 jam terakhir, dan Instagram membatasi DM hingga 1,000 byte UTF-8.
  • Balasan komentar: reply_to_comment membalas secara publik, atau dengan private diatur ke true mengirim satu DM untuk setiap komentar Instagram atau Facebook dalam 7 hari sejak komentar itu.
  • TikTok: balasan selalu publik dan membutuhkan ID video sebagai post_id, dan tidak ada DM di TikTok.
  • WhatsApp: send_message berfungsi dalam jendela layanan pelanggan 24 jam sejak pesan terakhir pelanggan, dan send_template dengan template yang disetujui berfungsi di luar jendela tersebut.
  • Media: setiap file berada di tautan HTTPS publik; Instagram menerima gambar JPEG, dan postingan foto TikTok menerima JPEG atau WebP.

Kapan kode memanggil jaringan tanpa agen?

Ketika suatu langkah harus terjadi dengan cara yang sama setiap kali, atau tanpa ada orang yang bisa login. get_social_credentials memberi agen base API sebuah akun, ID-nya di jaringan, dan, di TikTok, YouTube dan LinkedIn, token yang valid saat ini, dan Partner API mengembalikan hal yang sama dari GET /api/v1/channels/:id?credentials=1 dengan kunci ec_live_, sehingga skrip Python dapat memanggil TikTok, Google, atau LinkedIn secara langsung. Balasan yang harus terkirim kapan saja tanpa agen, seperti teks tetap untuk sebuah kata kunci, cocok dengan aturan komentar dan otomatisasi, yang dijalankan easyCoexistence sendiri.

Kesalahan umum

  • Membalas event yang disebabkan akun itu sendiri. Instagram menggemakan DM akun dengan is_echo bernilai true dan mengembalikan balasan publiknya sebagai komentar, jadi buang event tersebut sebelum agen melihatnya, atau agen akan membalas dirinya sendiri.
  • Menjalankan agen sebelum rute merespons. easyCoexistence menunggu 8 detik untuk 2xx dan tidak pernah mencoba ulang, sehingga handler yang menunggu model kehilangan event; merespons dulu, kerjakan di latar belakang.
  • Memanggil reply_to_comment untuk komentar TikTok tanpa post_id. Balasan TikTok menyebut video sekaligus komentar, jadi teruskan video_id dari event sebagai post_id.
  • Memberi agen balasan alat penerbitan. Saring daftar berdasarkan nama sebelum create_agent, sehingga komentar yang salah dibaca tidak dapat menerbitkan postingan, menghapus postingan, atau mengubah otomatisasi.
Melakukan ini dengan EasyCoexistence

easyCoexistence memberi agen LangChain Anda jangkauan ke pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn, dan saluran lainnya, masing-masing lewat API resminya: satu server MCP di balik login OAuth, event komentar dan DM yang ditandatangani, serta antrean yang memposting hingga 90 hari ke depan, dengan setiap koneksi dipantau 24/7. US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah agen memerlukan aplikasi developer Meta, TikTok, atau Google sendiri?

Tidak. Akun terhubung melalui aplikasi easyCoexistence sendiri di setiap jaringan, di dashboard atau lewat tautan koneksi Partner API, dan agen menjangkau semuanya lewat satu login easyCoexistence.

Dapatkah agen menjadwalkan postingan alih-alih langsung menerbitkan?

Dapat. publish_instagram_post, publish_facebook_post, publish_tiktok_post, dan publish_linkedin_post menerima scheduled_at, yaitu waktu ISO 8601 dengan zona waktu, dari 1 menit hingga 90 hari ke depan. YouTube menjadwalkan secara native dengan upload_youtube_video dan publish_at.

Model apa yang dapat menjalankan agen?

Model chat apa pun yang dapat dipakai create_agent dengan alat. Alat MCP tidak bergantung pada model, dan penyedia model menagih penggunaannya sendiri; easyCoexistence menagih per koneksi, tidak pernah per panggilan alat.

Berapa biaya easyCoexistence untuk agen LangChain?

US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dan sama di setiap jaringan. Server MCP, event yang diteruskan, dan Partner API sudah termasuk, dan 3 hari pertama gratis.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada