ログイン無料トライアルを開始
easyCoexistence 公式 API

LangChain エージェントに Instagram、TikTok、WhatsApp のツールを追加する

LangChain エージェントは、easyCoexistence の MCP サーバー(https://easycoexistence.com/api/mcp)から Instagram、TikTok、WhatsApp などのチャネルをツールとして受け取ります。ツールは LangChain の MCP クライアントである MCPAdapter で読み込まれ、OAuth サインインは FastMCP が処理します。create_agent は、各ネットワークの公式 API を通じて投稿の公開と予約、コメントや DM への返信、インサイトの読み取りを行えます。新しいコメントやメッセージは、署名付きイベントとしてルートに届きます。

Beta

langchain.mcp 名前空間に対する LangChain 側の呼び名です。langchain[mcp] 1.4.0 以降が必要で、FastMCP も含まれます。

In memory

token_storage でバックエンドを指定しない限り、FastMCP が OAuth トークンを保持するのはメモリ上です。そのため、再起動するとサインインし直しになります。

127.0.0.1

FastMCP がブラウザでのサインインのために一時的に起動する、コールバックサーバーのループバックアドレスです。空きポートまたは callback_port で待ち受けます。

60 days

easyCoexistence の MCP リフレッシュトークンの有効期間です。アクセストークンは 1 時間有効で、リフレッシュするたびに新しいペアが発行されます。

8 seconds

転送されたコメントや DM への応答を、ルートが返すまで easyCoexistence が待つ時間です。イベントは 1 回だけ送信され、再送はしません。

LangChain エージェントは easyCoexistence からどのツールを受け取りますか?

50 以上の、create_agent が呼び出せる通常の LangChain ツールです。ソーシャルツールは account_id を受け取るため、エージェントは最初に list_social_accounts を呼び出し、そこで得た ID を、投稿、読み取り、コメントへの返信、非表示、インサイト取得の各ツールに渡します。特定のネットワークに属するツールには、publish_tiktok_post や upload_youtube_video のようにそのネットワーク名が付きます。WhatsApp の番号は list_numbers から始まり、そこで返される connection_id を send_message と send_template が使います。各ツールの説明には、そのネットワーク固有のルールが記されているため、モデルは例えば TikTok の返信は公開であることを学習できます。投稿を予約する場合は、もう 1 つの引数 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

LangChain エージェントは easyCoexistence にどのようにサインインしますか?

MCPAdapter が認証に使う FastMCP の OAuth ヘルパーを使います。初回の実行時には、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 エージェントにどう届きますか?

MCP はエージェントが行う呼び出しにしか応答しないため、イベントは署名付きの POST リクエストとして、お使いのシステムのルートに届きます。各アカウントは set_social_webhook_destination でルートを指定します。エージェントに一度依頼するか、Claude や ChatGPT から実行できます。返される signing_secret は必ず保管してください。Instagram と Facebook はコメント、メンション、DM を転送し、TikTok はコメントを転送します。各イベントには platform、account_id、external_id と、そのネットワーク独自のエントリが含まれます。ルートは X-EC-Signature を検証して、すぐに応答します。easyCoexistence は 8 秒待ち、再試行は行わないためです。そのうえで、イベントをバックグラウンドでエージェントに渡します。DM の送信者ごとに thread_id を持つチェックポインターを用意すると、会話の履歴を保持できます。

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 は UTF-8 で 1,000 バイトまでに制限されています。
  • コメントへの返信:reply_to_comment は公開で返信します。private を true に設定すると、7 日以内の Instagram または Facebook のコメントそれぞれに、DM を 1 件送ります。
  • TikTok:返信は常に公開で、動画の ID を post_id として指定する必要があります。TikTok に DM はありません。
  • WhatsApp:send_message は、顧客からの最後のメッセージから 24 時間以内に使えます。その期間外では、承認済みテンプレートを使う send_template を使います。
  • メディア:各ファイルは公開された HTTPS リンク上に置かれている必要があります。Instagram は JPEG 画像を受け付け、TikTok の写真投稿は JPEG または WebP を受け付けます。

エージェントを介さず、コードから直接ネットワークを呼び出すのはいつですか?

手順を毎回同じように実行する必要があるときや、認証する人が不在のときです。get_social_credentials は、アカウントの API ベース、ネットワーク上の ID、そして TikTok、YouTube、LinkedIn の場合は現時点で有効なトークンをエージェントに渡します。同じ情報は、ec_live_ キーを使った Partner API の GET /api/v1/channels/:id?credentials=1 からも取得できるため、Python のジョブから TikTok、Google、LinkedIn を直接呼び出せます。エージェントがいなくても時間を問わず送られる必要がある返信(キーワードに対する定型文など)は、コメントルールや自動化が向いています。これらは easyCoexistence 自体が実行します。

よくある間違い

  • 自分のアカウントが引き起こしたイベントへの返信。Instagram は、アカウント自身の DM を is_echo が true の状態で返し、公開返信もコメントとして返します。エージェントが処理する前にこれらを除外してください。除外しないと、エージェントが自分自身に返信してしまいます。
  • ルートが応答する前にエージェントを実行すること。easyCoexistence は 2xx の応答を 8 秒待ち、再試行はしません。そのため、モデルの応答を待つハンドラーはイベントを失います。先に応答し、処理はバックグラウンドで行ってください。
  • post_id を指定せずに TikTok のコメントに対して reply_to_comment を呼び出すこと。TikTok の返信は、コメントだけでなく動画も指定するため、イベントの video_id を post_id として渡してください。
  • 返信用エージェントに投稿用ツールを渡すこと。名前でツール一覧を絞り込み、create_agent に渡す前に投稿用ツールを除外してください。そうしないと、誤って解釈されたコメントから、投稿の公開や削除、自動化の変更が起きかねません。
EasyCoexistence で実現する

easyCoexistence は、LangChain エージェントに、WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などのチャネルへの接続手段を提供します。各チャネルは公式 API 経由です。OAuth サインイン 1 回の背後にある MCP サーバー、署名付きのコメントと DM のイベント、最大 90 日先まで投稿を予約できるキューを備え、すべての接続を 24 時間監視します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。

よくある質問

エージェントには、独自の Meta、TikTok、Google の開発者アプリが必要ですか?

いいえ。アカウントは、各ネットワーク上の easyCoexistence 独自のアプリを通じて接続されます。接続方法は、ダッシュボードまたは Partner API の接続リンクのいずれかです。エージェントは、すべてを 1 つの easyCoexistence サインインから利用します。

エージェントは、すぐに公開せずに投稿を予約できますか?

はい。publish_instagram_post、publish_facebook_post、publish_tiktok_post、publish_linkedin_post は scheduled_at を受け取ります。これは、1 分先から 90 日先までの、タイムゾーン付きの ISO 8601 形式の時刻です。YouTube は、upload_youtube_video と publish_at を使い、YouTube 側の機能で予約します。

エージェントはどのモデルで動かせますか?

ツールを扱える、create_agent が利用できる任意のチャットモデルです。MCP ツールはモデルに依存しません。モデルの利用料金は、そのモデルの提供元が請求します。easyCoexistence は接続ごとに課金し、ツール呼び出しごとには課金しません。

LangChain エージェントの場合、easyCoexistence の料金はいくらですか?

接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。料金はどのネットワークでも同じです。MCP サーバー、転送されるイベント、Partner API は含まれており、最初の 3 日間は無料です。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日