Bigyan ang LangChain agent ng Instagram, TikTok at WhatsApp tools
Nakukuha ng LangChain agent ang Instagram, TikTok, WhatsApp at iba pang channels bilang tools mula sa MCP server ng easyCoexistence sa https://easycoexistence.com/api/mcp, na nilo-load ng MCPAdapter, ang MCP client ng LangChain, habang pinapatakbo ng FastMCP ang OAuth sign-in. Puwede nang mag-publish at mag-schedule ng posts ang create_agent, sumagot sa comments at DMs, at magbasa ng insights sa pamamagitan ng official API ng bawat network, habang dinadala ng mga naka-sign na event ang mga bagong comment at mensahe sa inyong route.
Ang label ng LangChain para sa namespace nitong langchain.mcp, na nangangailangan ng langchain[mcp] 1.4.0 o mas bago at kasama ang FastMCP.
Kung saan itinatago ng FastMCP ang OAuth tokens maliban kung may pinangalanang backend sa token_storage, kaya kailangang mag-sign in ulit pagkatapos ng restart.
Ang loopback address ng pansamantalang callback server na sinisimulan ng FastMCP para sa browser sign-in, sa libreng port o sa callback_port.
Gaano katagal nabubuhay ang refresh token ng easyCoexistence MCP; isang oras ang buhay ng access tokens, at bawat refresh ay naglalabas ng bagong pares.
Gaano katagal naghihintay ang easyCoexistence na sumagot ang inyong route sa comment o DM na ipinasa, ipinapadala nang isang beses at hindi inuulit.
Anong tools ang nakukuha ng LangChain agent mula sa easyCoexistence?
Higit sa 50, bilang ordinaryong LangChain tools na matatawag ng create_agent. Kailangang kunin muna ng agent ang list_social_accounts, at ipapasa nito ang mga ID sa publish, read, reply sa comments, hide, at insights. Ang mga tool na para sa iisang network ay may pangalan nito, gaya ng publish_tiktok_post o upload_youtube_video. Nagsisimula sa list_numbers ang numero ng WhatsApp, na nagbabalik ng connection_id na kailangan ng send_message at send_template. Dala ng bawat tool description ang sariling patakaran ng network, kaya natututunan ng model, halimbawa, na pampubliko ang reply sa TikTok. Ang pag-post ay nangangailangan ng isa pang argumento: inilalagay ng scheduled_at ang post sa pila ng easyCoexistence.
Paano nag-sign in ang agent sa easyCoexistence?
Gamit ang OAuth helper ng FastMCP, na ginagamit ng MCPAdapter para sa authentication. Sa unang takbo, hinahanap nito ang authorization server ng easyCoexistence, nagpaparehistro bilang client, binubuksan ang browser sa consent screen kung saan makikita ang client_name nito, at tinatanggap ang code sa local callback sa 127.0.0.1. Pagkatapos nito, nagre-refresh ang access tokens nang walang browser. Nasa memorya ang tokens maliban kung bibigyan ang helper ng backend na token_storage, kaya sa halimbawa ay sa disk sila itinatago, naka-encrypt gamit ang Fernet key. I-filter ang listahan bago makita ng create_agent: hawak ng tools ang MCP client, kaya tuloy pa rin sa pagtrabaho ang agent kahit magsara ang async with block.
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)Paano nakakarating ang comments at DMs sa LangChain agent?
Bilang naka-sign na POST request sa isang route ninyo, dahil sumasagot lang ang MCP sa mga tawag na ginagawa ng agent. Itakda ang route ng bawat account gamit ang set_social_webhook_destination, na itatanong sa agent nang minsan o patatakbuhin mula sa Claude o ChatGPT, at itago ang signing_secret na ibinabalik nito. Ipinapasa ng Instagram at Facebook ang comments, mentions at DMs, at ipinapasa ng TikTok ang comments; bawat event ay may platform, account_id, external_id at sariling entry ng network. Tinitingnan ng route ang X-EC-Signature at sumasagot agad, dahil naghihintay ang easyCoexistence ng 8 segundo at hindi inuulit ang pagpapadala, saka ibinibigay ang event sa agent sa background. Pinapanatili ng checkpointer na may thread_id bawat nagpadala ng DM ang history ng usapan.
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}]})Anong gawain ang pinapayagan ng bawat network sa agent?
Kung ano ang pinapayagan ng API ng network sa account, na dapat tahasang nakasaad sa mga tagubilin ng agent:
- Instagram at Messenger DMs: pinapayagan ng
send_social_dmang reply sa mga taong sumulat sa nakaraang 24 na oras, at may limitasyon ang Instagram na 1,000 bytes ng UTF-8 bawat DM. - Mga reply sa comment: nagre-reply ang
reply_to_commentsa publiko, o kapag private na set sa true, isang DM lang bawat comment sa Instagram o Facebook sa loob ng 7 araw mula rito. - TikTok: laging pampubliko ang reply at kailangan ang ID ng video bilang
post_id, at walang DMs sa TikTok. - WhatsApp: gumagana ang
send_messagesa loob ng 24 na oras mula sa huling mensahe ng customer, at angsend_templatena may aprubadong template ay sa labas nito. - Media: bawat file ay nasa pampublikong HTTPS link; tumatanggap ang Instagram ng JPEG na larawan, at ang TikTok photo posts ay JPEG o WebP.
Kailan dapat tumawag ang code sa mga network nang hindi dumadaan sa agent?
Kapag kailangang maganap ang isang hakbang sa parehong paraan tuwing takbo, o walang taong nandoon para mag-sign in. Ibinibigay ng get_social_credentials sa agent ang API base ng account, ang ID nito sa network, at, sa TikTok, YouTube at LinkedIn, token na valid sa sandaling iyon. Ibinibigay rin ito ng Partner API mula sa GET /api/v1/channels/:id?credentials=1 gamit ang ec_live_ key, kaya direktang matatawag ng Python job ang TikTok, Google o LinkedIn. Ang mga reply na kailangang lumabas anumang oras kahit walang agent, gaya ng nakapirming teksto para sa isang keyword, ay angkop sa comment rules at automations, na pinapatakbo ng easyCoexistence mismo.
Mga karaniwang pagkakamali
- Pagsagot sa sariling event ng account. Ibinabalik ng Instagram ang sariling DMs ng account na may is_echo na naka-true, at ibinabalik nitong comments ang pampublikong reply, kaya alisin ang mga ito bago makita ng agent, dahil kung hindi ay sasagot ito sa sarili.
- Pagpapatakbo ng agent bago sumagot ang route. Naghihintay ang easyCoexistence ng 8 segundo para sa 2xx at hindi inuulit, kaya mawawala ang event kung maghihintay ang handler sa model; sumagot muna, saka magtrabaho sa background.
- Pagtawag ng reply_to_comment sa TikTok comment nang walang post_id. Pinapangalanan ng reply sa TikTok ang video at ang comment, kaya ipasa ang video_id ng event bilang post_id.
- Pagbibigay sa reply agent ng publishing tools. I-filter ang listahan ayon sa pangalan bago ang create_agent, para hindi makapag-publish, makapagbura ng post, o makapagbago ng automation ang maling nabasang comment.
Binibigyan ng easyCoexistence ang inyong LangChain agents ng abot sa mga customer sa WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn at iba pang channels, bawat isa sa pamamagitan ng sariling official API: isang MCP server sa likod ng OAuth sign-in, naka-sign na comment at DM event, at pila na nagpo-post hanggang 90 araw nang maaga, habang namo-monitor 24/7 ang bawat koneksyon. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumadagdag ang koneksyon, at kasama ang unang 3 araw sa free trial.
Mga madalas itanong
Kailangan ba ng agent ng sariling Meta, TikTok o Google developer app?
Hindi. Kumokonekta ang mga account sa sariling app ng easyCoexistence sa bawat network, sa dashboard o sa pamamagitan ng Partner API connect link, at naaabot ng agent ang lahat ng ito sa iisang sign-in sa easyCoexistence.
Puwede bang mag-schedule ng posts ang agent sa halip na mag-publish agad?
Oo. Tumatanggap ang publish_instagram_post, publish_facebook_post, publish_tiktok_post at publish_linkedin_post ng scheduled_at, isang ISO 8601 na oras na may timezone, mula 1 minuto hanggang 90 araw nang maaga. Ang YouTube ay may sariling schedule gamit ang upload_youtube_video at publish_at.
Anong model ang puwedeng magpatakbo ng agent?
Anumang chat model na kayang gamitin ng create_agent kasama ang tools. Hindi nakadepende ang MCP tools sa model, at sisingilin ng provider ng model ang sarili nitong paggamit; sumisingil ang easyCoexistence kada koneksyon, hindi kada tool call.
Magkano ang presyo ng easyCoexistence para sa LangChain agent?
US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumadagdag ang koneksyon, at pareho sa bawat network. Kasama ang MCP server, ang mga ipinasang event at ang Partner API, at kasama ang unang 3 araw sa free trial.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong