Подключите LangChain-агенту инструменты для Instagram, TikTok и WhatsApp
LangChain-агент получает Instagram, TikTok, WhatsApp и другие каналы как инструменты с MCP-сервера easyCoexistence по адресу https://easycoexistence.com/api/mcp. Их загружает MCPAdapter, MCP-клиент LangChain, а вход через OAuth выполняет FastMCP. Затем create_agent может публиковать и планировать посты, отвечать на комментарии и DM и читать аналитику через официальный API каждой сети, а подписанные события передают на ваш эндпоинт новые комментарии и сообщения.
Пространство имён LangChain langchain.mcp, для которого нужен langchain[mcp] 1.4.0 или новее и которое подтягивает FastMCP.
Где FastMCP хранит токены OAuth, если token_storage не указывает хранилище, поэтому после перезапуска нужно войти заново.
Локальный адрес (loopback) временного сервера обратного вызова, который FastMCP запускает для входа через браузер, на свободном порту или callback_port.
Срок действия токена обновления MCP easyCoexistence; токены доступа живут час, и при каждом обновлении выдаётся новая пара.
Сколько easyCoexistence ждёт ответа вашего эндпоинта на пересланный комментарий или DM; событие отправляется один раз и не повторяется.
Какие инструменты получает LangChain-агент от easyCoexistence?
Более 50 обычных инструментов LangChain, которые может вызывать create_agent. Социальные инструменты принимают account_id, поэтому агент начинает с list_social_accounts и передаёт его ID в публикацию, чтение и ответы на комментарии, их скрытие и чтение аналитики. Инструменты, относящиеся к одной сети, содержат её название, например publish_tiktok_post или upload_youtube_video, а номер WhatsApp начинается с list_numbers, который возвращает connection_id для send_message и send_template. В описании каждого инструмента есть правила сети, поэтому модель узнаёт, например, что ответ в TikTok всегда публичный. Для отложенной публикации нужен ещё один аргумент: scheduled_at ставит пост в очередь easyCoexistence.
Как агент входит в easyCoexistence?
С помощью OAuth-помощника FastMCP, который MCPAdapter использует для аутентификации. При первом запуске он находит сервер авторизации easyCoexistence, регистрирует себя как клиента, открывает браузер с экраном согласия, где показан его client_name, и получает код на локальном обратном вызове 127.0.0.1. После этого токены доступа обновляются без браузера. Токены хранятся в памяти, если помощнику не передано хранилище token_storage, поэтому пример сохраняет их на диске, зашифрованными ключом Fernet. Отфильтруйте список до того, как create_agent его получит: инструменты держат MCP-клиент, поэтому агент продолжает работать после закрытия блока async with.
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)Как комментарии и DM попадают к агенту LangChain?
Как подписанные POST-запросы на ваш эндпоинт, потому что MCP отвечает только на вызовы агента. Привяжите каждый аккаунт к эндпоинту через set_social_webhook_destination, вызвав его из агента один раз или из Claude либо ChatGPT, и сохраните возвращённый signing_secret. Instagram и Facebook пересылают комментарии, упоминания и DM, а TikTok пересылает комментарии; каждое событие содержит platform, account_id, external_id и собственную запись сети. Эндпоинт проверяет X-EC-Signature, сразу отвечает, так как easyCoexistence ждёт 8 секунд и не повторяет запрос, и передаёт событие агенту в фоне. Чекпоинтер с thread_id для каждого отправителя DM сохраняет историю переписки.
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}]})Что каждая сеть разрешает агенту?
То, что API сети разрешает аккаунту. Инструкции агента должны говорить об этом прямо:
- Instagram и Messenger DM:
send_social_dmотвечает людям, которые писали за последние 24 часа, а Instagram ограничивает DM 1 000 байтами в UTF-8. - Ответы на комментарии:
reply_to_commentотвечает публично, а при private, равном true, отправляет одно DM на комментарий Instagram или Facebook в течение 7 дней после него. - TikTok: ответы всегда публичные и требуют ID видео как
post_id, а DM в TikTok нет. - WhatsApp:
send_messageработает в течение 24 часов после последнего сообщения клиента, аsend_templateс одобренным шаблоном работает за пределами этого окна. - Медиафайлы: каждый файл лежит по публичной ссылке HTTPS; Instagram принимает изображения в JPEG, а фотопубликации TikTok принимают JPEG или WebP.
Когда код должен обращаться к сетям без агента?
Когда шаг должен выполняться одинаково каждый раз или когда некому войти. get_social_credentials передаёт агенту базовый адрес API аккаунта, его ID в сети и, для TikTok, YouTube и LinkedIn, токен, действующий прямо сейчас, а Partner API возвращает то же самое по GET /api/v1/channels/:id?credentials=1 с ключом ec_live_, поэтому Python-скрипт может обращаться к TikTok, Google или LinkedIn напрямую. Ответы, которые должны уходить в любое время без агента, например фиксированный текст по ключевому слову, подходят для правил комментариев и автоматизаций, которые easyCoexistence запускает сам.
Распространённые ошибки
- Ответ на события, которые вызвал сам аккаунт. Instagram возвращает личные сообщения аккаунта с is_echo, равным true, а его публичные ответы приходят как комментарии, поэтому отбрасывайте их до того, как агент их увидит, иначе он начнёт отвечать сам себе.
- Запуск агента до ответа эндпоинта. easyCoexistence ждёт 2xx 8 секунд и никогда не повторяет запрос, поэтому обработчик, который ждёт модель, теряет событие. Сначала ответьте, а работайте в фоне.
- Вызов reply_to_comment для комментария TikTok без post_id. Ответ в TikTok указывает и видео, и комментарий, поэтому передайте video_id события как post_id.
- Выдача агенту инструментов публикации для ответов. Отфильтруйте список по имени до create_agent, чтобы ошибочно прочитанный комментарий не мог опубликовать пост, удалить его или изменить автоматизацию.
easyCoexistence даёт вашим агентам LangChain доступ к клиентам в WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналах, каждый через официальный API: один MCP-сервер за входом через OAuth, подписанные события комментариев и DM и очередь, которая публикует посты на 90 дней вперёд, при круглосуточном мониторинге каждого подключения. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Нужно ли агенту собственное приложение разработчика Meta, TikTok или Google?
Нет. Аккаунты подключаются через собственное приложение easyCoexistence в каждой сети, в панели управления или по ссылке подключения Partner API, а агент работает со всеми через один вход в easyCoexistence.
Может ли агент планировать посты, а не публиковать сразу?
Да. publish_instagram_post, publish_facebook_post, publish_tiktok_post и publish_linkedin_post принимают scheduled_at, время в формате ISO 8601 с часовым поясом, от 1 минуты до 90 дней вперёд. YouTube планирует нативно через upload_youtube_video и publish_at.
Какие модели могут работать с агентом?
Любая чат-модель, которую create_agent может использовать с инструментами. Инструменты MCP не зависят от модели, а провайдер модели выставляет счёт за собственное использование. easyCoexistence берёт плату за подключение, а не за вызов инструмента.
Сколько стоит easyCoexistence для агента LangChain?
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, одинаково для каждой сети. Сервер MCP, пересылаемые события и Partner API включены, первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на