ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Подключите LangChain-агенту инструменты для Instagram, TikTok и WhatsApp

LangChain-агент получает Instagram, TikTok, WhatsApp и другие каналы как инструменты с MCP-сервера easyCoexistence по адресу https://easycoexistence.com/api/mcp. Их загружает MCPAdapter, MCP-клиент LangChain, а вход через OAuth выполняет FastMCP. Затем create_agent может публиковать и планировать посты, отвечать на комментарии и DM и читать аналитику через официальный API каждой сети, а подписанные события передают на ваш эндпоинт новые комментарии и сообщения.

Beta

Пространство имён LangChain langchain.mcp, для которого нужен langchain[mcp] 1.4.0 или новее и которое подтягивает FastMCP.

In memory

Где FastMCP хранит токены OAuth, если token_storage не указывает хранилище, поэтому после перезапуска нужно войти заново.

127.0.0.1

Локальный адрес (loopback) временного сервера обратного вызова, который FastMCP запускает для входа через браузер, на свободном порту или callback_port.

60 days

Срок действия токена обновления MCP easyCoexistence; токены доступа живут час, и при каждом обновлении выдаётся новая пара.

8 seconds

Сколько 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.

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

Как агент входит в easyCoexistence?

С помощью OAuth-помощника FastMCP, который MCPAdapter использует для аутентификации. При первом запуске он находит сервер авторизации easyCoexistence, регистрирует себя как клиента, открывает браузер с экраном согласия, где показан его client_name, и получает код на локальном обратном вызове 127.0.0.1. После этого токены доступа обновляются без браузера. Токены хранятся в памяти, если помощнику не передано хранилище token_storage, поэтому пример сохраняет их на диске, зашифрованными ключом Fernet. Отфильтруйте список до того, как create_agent его получит: инструменты держат MCP-клиент, поэтому агент продолжает работать после закрытия блока async with.

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)

Как комментарии и 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 сохраняет историю переписки.

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

Что каждая сеть разрешает агенту?

То, что 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

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 дня бесплатно.

Читайте дальше

Дайте агенту OpenAI Agents SDK инструменты для Instagram, TikTok и WhatsAppПодключите агента OpenAI Agents SDK к MCP-серверу easyCoexistence по OAuth: публикации, расписание и ответы в Instagram, TikTok, WhatsApp и других сетях.Инструменты соцсетей в Vercel AI SDK: Instagram, TikTok и другиеПодключите MCP-инструменты easyCoexistence к Vercel AI SDK через createMCPClient и OAuth: публикуйте, планируйте и отвечайте в Instagram, TikTok и других.Дайте команде CrewAI инструменты для Instagram, TikTok и WhatsAppАгенты CrewAI получают инструменты MCP easyCoexistence через MCPServerHTTP и токен OAuth для публикаций и ответов в Instagram, TikTok и WhatsApp.Подключите к агенту LangChain номер WhatsAppЗагрузите инструменты EasyCoexistence MCP в агент LangChain через OAuth и передавайте ему входящие сообщения WhatsApp из вебхука официального Cloud API.MCP-сервер для соцсетей: Claude и ChatGPTОдин MCP-коннектор для всех сетей: Claude или ChatGPT публикуют, планируют, отвечают на комментарии и личные сообщения, читают аналитику через официальные API.Публикация в Instagram, TikTok и Facebook из Python через один APIПубликуйте посты, читайте комментарии и отвечайте на личные сообщения в Instagram, Facebook, TikTok, YouTube и LinkedIn из Python через официальные API.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на