Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Beri ejen LangChain alat untuk Instagram, TikTok dan WhatsApp

Ejen LangChain mendapat Instagram, TikTok, WhatsApp dan lebih banyak saluran sebagai alat daripada pelayan MCP easyCoexistence di https://easycoexistence.com/api/mcp, dimuatkan oleh MCPAdapter, klien MCP LangChain, dengan FastMCP menjalankan log masuk OAuth. create_agent kemudian boleh menerbitkan dan menjadualkan siaran, membalas komen dan DM serta membaca wawasan melalui API rasmi setiap rangkaian, manakala acara bertanda tangan membawa komen dan mesej baharu ke laluan anda.

Beta

Label LangChain untuk ruang nama langchain.mcp, yang memerlukan langchain[mcp] 1.4.0 atau lebih baharu dan membawa masuk FastMCP.

In memory

Tempat FastMCP menyimpan token OAuth melainkan token_storage menamakan storan, jadi memulakan semula bermakna log masuk semula.

127.0.0.1

Alamat gelung balik pelayan panggil balik sementara yang FastMCP mulakan untuk log masuk melalui pelayar, pada port percuma atau callback_port.

60 days

Tempoh token segar MCP easyCoexistence bertahan; token akses bertahan sejam, dan setiap penyegaran mengeluarkan pasangan baharu.

8 seconds

Tempoh masa easyCoexistence menunggu laluan anda membalas komen atau DM yang dihantar, dihantar sekali dan tidak dicuba semula.

Alat apakah yang diperoleh ejen LangChain daripada easyCoexistence?

Lebih 50, sebagai alat LangChain biasa yang boleh dipanggil oleh create_agent. Alat sosial mengambil account_id, jadi ejen bermula dengan list_social_accounts dan menghantar ID-nya kepada alat untuk menerbitkan, membaca dan membalas komen, menyembunyikannya serta membaca wawasan. Alat yang tergolong dalam satu rangkaian membawa namanya, seperti publish_tiktok_post atau upload_youtube_video, dan nombor WhatsApp bermula daripada list_numbers, yang memulangkan connection_id yang diambil oleh send_message dan send_template. Penerangan setiap alat membawa peraturan rangkaian itu sendiri, supaya model belajar, contohnya, bahawa balasan TikTok adalah awam. Siaran yang dijadualkan memerlukan satu lagi argumen: scheduled_at meletakkan siaran dalam baris gilir 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 ejen log masuk ke easyCoexistence?

Dengan pembantu OAuth FastMCP, yang digunakan oleh MCPAdapter untuk pengesahan. Pada larian pertama, ejen menemukan pelayan kebenaran easyCoexistence, mendaftarkan dirinya sebagai klien, membuka pelayar pada skrin persetujuan, di mana client_name-nya dipaparkan, dan menerima kod pada panggil balik tempatan di 127.0.0.1. Selepas itu, token akses disegarkan tanpa pelayar. Token disimpan dalam memori melainkan pembantu diberi storan token_storage, jadi contoh ini menyimpannya pada cakera, disulitkan dengan kunci Fernet. Tapis senarai sebelum create_agent melihatnya: alat memegang klien MCP, jadi ejen terus berfungsi selepas 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 komen dan DM sampai kepada ejen LangChain?

Sebagai permintaan POST bertanda tangan ke laluan anda, kerana MCP hanya menjawab panggilan yang dibuat oleh ejen. Tetapkan setiap akaun ke laluan itu dengan set_social_webhook_destination, yang diminta daripada ejen sekali, atau dijalankan dari Claude atau ChatGPT, dan simpan signing_secret yang dipulangkannya. Instagram dan Facebook memajukan komen, sebutan dan DM, dan TikTok memajukan komen; setiap acara membawa platform, account_id, external_id dan entri rangkaian itu sendiri. Laluan memeriksa X-EC-Signature, membalas serta-merta kerana easyCoexistence menunggu 8 saat dan tidak mencuba semula, lalu menyerahkan acara kepada ejen di latar belakang. Checkpointer dengan thread_id bagi setiap pengirim DM menyimpan sejarah perbualan.

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 dibenarkan setiap rangkaian untuk dilakukan ejen?

Apa yang dibenarkan oleh API rangkaian kepada akaun, yang patut dinyatakan dengan jelas dalam arahan ejen:

  • Instagram dan DM Messenger: send_social_dm membalas orang yang menulis dalam 24 jam terakhir, dan Instagram mengehadkan DM kepada 1,000 bait UTF-8.
  • Balasan komen: reply_to_comment membalas secara awam, atau dengan private ditetapkan kepada true menghantar satu DM bagi setiap komen Instagram atau Facebook dalam tempoh 7 hari selepas komen itu dibuat.
  • TikTok: balasan sentiasa awam dan memerlukan ID video sebagai post_id, dan tiada DM di TikTok.
  • WhatsApp: send_message boleh digunakan dalam tempoh 24 jam selepas mesej terakhir pelanggan, dan send_template dengan template yang diluluskan di luar tempoh itu.
  • Media: setiap fail berada pada pautan HTTPS awam; Instagram menerima imej JPEG, dan siaran foto TikTok menerima JPEG atau WebP.

Bila kod sepatutnya memanggil rangkaian tanpa ejen?

Apabila satu langkah perlu berlaku dengan cara yang sama setiap kali, atau tanpa sesiapa yang hadir untuk log masuk. get_social_credentials memberikan ejen asas API akaun, ID-nya pada rangkaian dan, pada TikTok, YouTube dan LinkedIn, token yang sah sekarang, dan Partner API memulangkan perkara yang sama daripada GET /api/v1/channels/:id?credentials=1 dengan kunci ec_live_, supaya kerja Python boleh memanggil TikTok, Google atau LinkedIn secara terus. Balasan yang perlu dihantar pada bila-bila masa tanpa ejen, seperti teks tetap bagi kata kunci, sesuai dengan peraturan komen dan automasi yang dijalankan sendiri oleh easyCoexistence.

Kesilapan biasa

  • Membalas acara yang dicetuskan oleh akaun itu sendiri. Instagram mengulang DM akaun dengan is_echo ditetapkan kepada true dan memulangkan balasan awamnya sebagai komen, jadi buang acara itu sebelum ejen melihatnya, jika tidak ia akan membalas dirinya sendiri.
  • Menjalankan ejen sebelum laluan membalas. easyCoexistence menunggu 8 saat untuk 2xx dan tidak mencuba semula, jadi pengendali yang menunggu model akan kehilangan acara; balas dahulu, kemudian kerjakan di latar belakang.
  • Memanggil reply_to_comment untuk komen TikTok tanpa post_id. Balasan TikTok menamakan video dan juga komen, jadi hantar video_id acara sebagai post_id.
  • Memberi ejen balas alat penerbitan. Tapis senarai mengikut nama sebelum create_agent, supaya komen yang disalah baca tidak boleh menerbitkan siaran, memadam satu atau menukar automasi.
Menggunakan EasyCoexistence untuk ini

easyCoexistence memberikan ejen LangChain anda capaian kepada pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran, setiap satu melalui API rasminya: satu pelayan MCP di sebalik log masuk OAuth, acara komen dan DM bertanda tangan, serta baris gilir yang menjadualkan siaran sehingga 90 hari ke hadapan, dengan setiap sambungan dipantau 24/7. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah ejen memerlukan aplikasi pembangun Meta, TikTok atau Google sendiri?

Tidak. Akaun disambungkan melalui aplikasi easyCoexistence sendiri pada setiap rangkaian, dalam dashboard atau melalui pautan sambungan Partner API, dan ejen mencapai semuanya melalui satu log masuk easyCoexistence.

Bolehkah ejen menjadualkan siaran dan bukannya menerbitkan serta-merta?

Boleh. publish_instagram_post, publish_facebook_post, publish_tiktok_post dan publish_linkedin_post menerima scheduled_at, iaitu masa ISO 8601 dengan zon waktu, dari 1 minit hingga 90 hari ke hadapan. YouTube menjadualkan secara asli dengan upload_youtube_video dan publish_at.

Model mana yang boleh menjalankan ejen?

Mana-mana model sembang yang create_agent boleh gunakan dengan alat. Alat MCP tidak bergantung kepada model, dan pembekal model mengenakan caj atas penggunaannya sendiri; easyCoexistence mengenakan caj setiap sambungan, bukan setiap panggilan alat.

Berapa kos easyCoexistence untuk ejen LangChain?

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dan sama pada setiap rangkaian. Pelayan MCP, acara yang dipajukan dan Partner API termasuk, dan 3 hari pertama percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada