1 つの API で Python から Instagram、TikTok、Facebook に投稿
easyCoexistence を使うと、Python のコードから各ネットワークの公式 API を通じて Instagram、Facebook、TikTok、YouTube、LinkedIn に投稿できます。各アカウントは、ホストされたリンクから一度だけサインインします。その後、スクリプトが 1 回の GET で TikTok、YouTube、LinkedIn の新しいトークンを取得します。Instagram と Facebook の呼び出しは、トークンを保持する easyCoexistence の MCP ツールを経由します。MCP ツールを使えば、Python のエージェントも同じアカウントを扱えます。
Instagram DM 1 件で API が送れる最大テキスト量。UTF-8 で数えるため、絵文字は多くの容量を使います。
TikTok のビジネス向け API のアクセストークンの有効期間。リフレッシュトークンは 1 年間有効です。
(すべての YouTube API 呼び出しで使われる)Google のユーザーアクセストークンの有効期間。
MCP Python SDK の OAuth ハンドラーです。クライアントの登録、PKCE を使ったサインイン、トークンの更新を行います。
転送されるコメント、メンション、DM のイベントは一度だけ配信され、保存されません。そのため、受け取ったらすぐに応答を返してください。
Python はどのようにして Instagram、Facebook、TikTok、YouTube、LinkedIn のトークンを取得しますか?
easyCoexistence の Partner API にある接続セッションを経由します。認証には ec_live_ キーを使います。channel に instagram、facebook、tiktok、youtube、linkedin のいずれかを指定して POST /connect-sessions を送ると、お客様 1 人分のホストされたリンクが返ります。有効期限は 1 時間です。お客様はネットワーク自身のログインでサインインし、status=connected と channel_id を付けて redirect_url に戻ります。バックエンドはクエリ文字列を信用せず、GET /connect-sessions/{session} で確認してください。Meta、TikTok、Google、LinkedIn 用に独自の開発者アプリを用意する必要はありません。
その後、ジョブの開始時に毎回認証情報を取得してください。GET /channels/{id}?credentials=1 は、ネットワークの API のベース URL、そのネットワーク上のアカウント ID、そして TikTok、YouTube、LinkedIn の場合は easyCoexistence が常に更新しているアクセストークンを返します。TikTok のトークンは 24 時間、Google のトークンは 1 時間有効です。そのため保存せず、ジョブごとに取得してください。Instagram と Facebook のトークンは決して渡されません。それらの呼び出しは MCP ツールを経由します。
import os
import requests
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
# A hosted sign-in link for one customer on one network
session = requests.post(f"{EC}/connect-sessions", headers=KEY, json={
"channel": "instagram", # or facebook, tiktok, youtube, linkedin
"redirect_url": "https://app.example.com/connected",
"external_ref": "customer_4821",
}).json()
print(session["url"]) # they come back with ?session=...&status=connected&channel_id=...
def credentials(channel_id: str) -> dict:
"""The network's API base and a token that is valid now. Call it per job."""
r = requests.get(f"{EC}/channels/{channel_id}", headers=KEY, params={"credentials": 1})
r.raise_for_status()
creds = r.json()["credentials"]
if not creds.get("access_token"):
raise RuntimeError(creds.get("note", "This channel is not connected."))
return credsPython から Instagram と Facebook に投稿するには?
Instagram は Meta の Graph API 上で 2 段階で投稿します。トークンは Bearer ヘッダーで渡します。POST /{ig-id}/media に image_url と caption を指定するとコンテナが作成されます。その status_code を GET で確認し、FINISHED になったら、POST /{ig-id}/media_publish に creation_id としてコンテナを渡すと、プロフィールに公開されます。Meta は約 1 分ごとに確認し、最大 5 分間続けることを推奨しています。リール(Reel)も同じ手順で、media_type に REELS を指定し、画像の代わりに video_url を送ります。
Facebook ページへの投稿は 1 回の呼び出しで済みます。POST /{page-id}/feed に message を指定し、必要に応じて link を加えます。published を false にし、scheduled_publish_time を 10 分後から 30 日後までの時刻にすると、Meta がその時刻に公開します。その間、ご自身のジョブを動かす必要はありません。どちらの場合も、Meta は公開 URL からメディアをダウンロードします。Instagram は JPEG 画像のみ対応しています。
import time
import requests
def graph(c: dict, path: str, **body) -> dict:
"""Meta's Graph API: a POST when there is a body, a GET when there is none."""
r = requests.request("POST" if body else "GET", f"{c['graph_api_base']}/{path}",
json=body or None, headers={"Authorization": f"Bearer {c['access_token']}"})
r.raise_for_status()
return r.json()
def post_to_instagram(channel_id: str, image_url: str, caption: str) -> str:
c = credentials(channel_id)
ig = c["account_id_on_meta"]
container = graph(c, f"{ig}/media", image_url=image_url, caption=caption)["id"]
for _ in range(5): # Meta: check about once a minute, for up to five minutes
status = graph(c, f"{container}?fields=status_code")["status_code"]
if status == "FINISHED":
return graph(c, f"{ig}/media_publish", creation_id=container)["id"]
if status in ("ERROR", "EXPIRED"):
raise RuntimeError(f"Instagram could not process the media: {status}")
time.sleep(60)
raise TimeoutError("The container is still processing")
def schedule_on_facebook(channel_id: str, message: str, publish_at: int) -> str:
c = credentials(channel_id)
post = graph(c, f"{c['account_id_on_meta']}/feed", message=message,
published=False, scheduled_publish_time=publish_at) # unix seconds
return post["id"]Python から YouTube へのアップロードと LinkedIn への投稿はどうしますか?
YouTube には再開可能なアップロードで動画を送ります。最初のリクエストは uploadType=resumable と part=snippet,status を付けてアップロードのエンドポイントに送り、タイトルと公開設定を JSON で渡します。その応答の Location ヘッダーがセッションのアドレスです。そこへファイルを PUT すると、201 が返り、新しい動画が作成されます。privacyStatus を private に設定し publishAt を指定すると、その時刻に YouTube が自動で公開します。selfDeclaredMadeForKids は、子供向けかどうかを記録します。
LinkedIn には、/rest/posts に 1 回 POST します。Bearer トークン、LinkedIn-Version ヘッダー、X-Restli-Protocol-Version 2.0.0 を付けます。ボディで投稿者を指定し、本文を commentary に入れ、visibility、distribution、lifecycleState を設定します。認証情報は author_urn を提供します。会社ページなら urn:li:organization、個人プロフィールなら urn:li:person になり、easyCoexistence が使うバージョンも含まれます。新しい投稿の URN は x-restli-id ヘッダーで返ります。
import requests
def schedule_on_youtube(channel_id: str, path: str, title: str, publish_at: str) -> str:
c = credentials(channel_id)
auth = {"Authorization": f"Bearer {c['access_token']}"}
start = requests.post(
"https://www.googleapis.com/upload/youtube/v3/videos",
params={"uploadType": "resumable", "part": "snippet,status"},
headers={**auth, "X-Upload-Content-Type": "video/mp4"},
json={"snippet": {"title": title},
"status": {"privacyStatus": "private", "publishAt": publish_at, # ISO 8601
"selfDeclaredMadeForKids": False}},
)
start.raise_for_status()
with open(path, "rb") as video: # streamed, not read into memory
done = requests.put(start.headers["Location"], data=video,
headers={**auth, "Content-Type": "video/mp4"})
done.raise_for_status()
return done.json()["id"]
def post_on_linkedin(channel_id: str, text: str) -> str:
c = credentials(channel_id)
r = requests.post(f"{c['api_base']}/posts", headers={
"Authorization": f"Bearer {c['access_token']}",
"LinkedIn-Version": c["required_headers"]["LinkedIn-Version"], # YYYYMM
"X-Restli-Protocol-Version": "2.0.0",
}, json={
"author": c["author_urn"], # urn:li:organization:... or urn:li:person:...
"commentary": text,
"visibility": "PUBLIC",
"distribution": {"feedDistribution": "MAIN_FEED", "targetEntities": [],
"thirdPartyDistributionChannels": []},
"lifecycleState": "PUBLISHED",
"isReshareDisabledByAuthor": False,
})
r.raise_for_status()
return r.headers["x-restli-id"] # the new post's URNPython でコメントや DM を読み取り、返信するには?
チャンネルの転送を有効にし、届いたすべての配信を検証してから、ネットワークの API で返信します。PUT /channels/{id}/webhook に url を指定すると、signing_secret が返ります。これは一度だけ表示されます。Instagram と Facebook のコメント、メンション、DM、および TikTok のコメントは、platform、account_id、external_id、entry を含む POST として届きます。entry はネットワークが送ったそのままの形式です。X-EC-Signature ヘッダーは t=<unix>,v1=<hex> の形式で、v1 はタイムスタンプ、ドット、生のボディから成る HMAC-SHA256 です。各イベントは一度だけ送られ、コピーは保存されず、再送もありません。そのため、まず応答を返し、キューから処理してください。
Instagram の DM への返信は、相手の最後のメッセージから 24 時間以内に /{ig-id}/messages へ送ります。1 通は最大 1,000 バイトです。コメントには /{comment-id}/replies で公開返信するか、7 日以内に 1 回だけ非公開返信できます。TikTok には DM がないため、TikTok のコメントへの公開返信は business/comment/reply/create/ を使います。YouTube と LinkedIn のコメントは、それぞれの API からスケジュールに沿って読み取ります。
import hashlib, hmac, json, queue, time
import requests
from flask import Flask, abort, request
app = Flask(__name__)
jobs: queue.Queue = queue.Queue() # a worker calls reply_on_instagram() for each event
SECRETS: dict[str, str] = {} # channel_id -> signing_secret; keep them in your database
def forward_events(channel_id: str, url: str) -> None:
r = requests.put(f"{EC}/channels/{channel_id}/webhook", headers=KEY, json={"url": url})
r.raise_for_status()
SECRETS[channel_id] = r.json()["signing_secret"] # returned only this once
def verified(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")
def social_event():
raw = request.get_data()
event = json.loads(raw) # platform, account_id, external_id, entry
secret = SECRETS.get(event.get("account_id"))
if not secret or not verified(raw, request.headers.get("X-EC-Signature", ""), secret):
abort(401)
jobs.put(event) # sent once and never retried: acknowledge first, work after
return "", 204
def reply_on_instagram(event: dict, text: str) -> None:
c, me = credentials(event["account_id"]), event["external_id"]
for m in event["entry"].get("messaging", []): # DMs, minus echoes of your own
if "message" in m and not m["message"].get("is_echo"):
graph(c, f"{me}/messages", recipient={"id": m["sender"]["id"]}, message={"text": text})
for ch in event["entry"].get("changes", []): # comments, minus your own replies
if ch["field"] == "comments" and ch["value"]["from"]["id"] != me:
graph(c, f"{ch['value']['id']}/replies", message=text)Python から TikTok に投稿するには?
easyCoexistence の MCP ツール publish_tiktok_post を経由します。TikTok のビジネス向け API は video_url で動画を受け取ります。2023 年 11 月 16 日以降、TikTok はトークンが紐づくアプリに検証済みのドメインまたは URL プレフィックスからしかメディアをダウンロードしません。このアプリは easyCoexistence のものです。ツールは HTTPS のリンクを受け取り、easyCoexistence の検証済みメディアルートで署名付きアドレスを TikTok に渡します。ファイルは保存せずストリーミングします。写真の投稿は代わりに image_urls を使い、JPEG または WebP のファイルを 1〜35 枚指定します。get_tiktok_publish_status は、TikTok の処理中に投稿の状態を追跡します。
Python からは、公式 MCP SDK バージョン 2 を使い、Python 3.10 以降で 1 回の呼び出しで済みます。https://easycoexistence.com/api/mcp のサーバーは OAuth 2.1 のみを受け付けます。SDK の OAuthClientProvider がクライアントを登録し、PKCE を使ったブラウザーでのサインインを 1 回行い、トークンを更新します。アクセストークンは 1 時間、リフレッシュトークンは 60 日間有効です。更新のたびに新しいペアが発行されます。これらを永続的に保存する仕組みがあれば、バックエンドはサインイン状態を保てます。
import asyncio
import os
from urllib.parse import parse_qs, urlparse
import httpx2
from pydantic import AnyUrl
from mcp import Client
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.client.streamable_http import streamable_http_client
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
MCP_URL = "https://easycoexistence.com/api/mcp"
class Storage: # keep both values in a database, so the browser sign-in happens once
tokens: OAuthToken | None = None
client: OAuthClientInformationFull | None = None
async def get_tokens(self): return self.tokens
async def set_tokens(self, tokens): self.tokens = tokens
async def get_client_info(self): return self.client
async def set_client_info(self, info): self.client = info
async def show_sign_in(url: str) -> None:
print("Sign in to easyCoexistence:", url)
async def read_callback() -> AuthorizationCodeResult:
query = parse_qs(urlparse(input("Paste the address you were sent back to: ")).query)
return AuthorizationCodeResult(code=query["code"][0], state=query["state"][0])
oauth = OAuthClientProvider(
server_url=MCP_URL,
client_metadata=OAuthClientMetadata(
client_name="My social agent",
redirect_uris=[AnyUrl("http://localhost:3030/callback")],
scope="mcp",
),
storage=Storage(),
redirect_handler=show_sign_in,
callback_handler=read_callback,
)
async def main() -> None:
timeout = httpx2.Timeout(30.0, read=300.0)
async with httpx2.AsyncClient(auth=oauth, timeout=timeout) as http:
async with Client(streamable_http_client(MCP_URL, http_client=http)) as client:
result = await client.call_tool("publish_tiktok_post", {
"account_id": os.environ["TIKTOK_CHANNEL_ID"], # the Partner API channel id
"video_url": "https://cdn.example.com/launch.mp4",
"caption": "New drop #behindthescenes",
})
print(result.content[0].text) # a share_id for get_tiktok_publish_status
asyncio.run(main())Python の AI エージェントはこれらのアカウントをどう使いますか?
同じ MCP セッションを通じて使います。サーバーは、お使いのアカウントのネットワーク向けツールを一覧で返します。MCP ツールを受け付けるエージェントフレームワークなら、それらをモデルに渡せます。各ネットワークへの投稿、投稿の一覧取得、コメントの読み取りと返信、Instagram と Facebook の DM への返信、コメントから DM へのルール設定、インサイトと分析の取得ができます。サーバーの指示文と各ツールの説明にはネットワークのルールが含まれるので、モデルは TikTok の返信が公開であること、Instagram の画像は JPEG である必要があることを理解できます。
エージェントは list_social_accounts から開始してください。他のソーシャルツールはすべてそこから account_id を受け取り、その ID は Partner API が返すチャンネル ID と同じです。午前 3 時に返信が必要で、エージェントが動いていない場合は、コメントルールと自動化を使ってください。これらは easyCoexistence 自体で実行されます。
よくある間違い
- トークンを設定ファイルに保存すること。TikTok のトークンは 1 日以内、Google のトークンは 1 時間以内に期限切れになります。easyCoexistence が裏で更新するので、ジョブの開始時に認証情報のエンドポイントを呼び出してください。
- 独自ドメインのリンクを TikTok に渡すこと。TikTok は、トークンを持つアプリに対して検証された URL プレフィックスからのみメディアをダウンロードします。そのため publish_tiktok_post で投稿してください。このツールは easyCoexistence の検証済みアドレスからファイルを配信します。
- 自分自身のコメントを含め、すべてのコメントイベントに返信すること。公開返信は新しいコメントとして戻り、Instagram の DM はエコーとして戻ります。そのため、投稿者がアカウント自身のイベントは無視してください。そうしないと、ボットが自分に返信し続けます。
- Instagram の DM を文字数で数えること。上限は UTF-8 で 1,000 バイトです。絵文字やアクセント付きの文字を含むテキストは、より早く上限に達します。送信前に、エンコード後のバイト数で切り詰めてください。
easyCoexistence は、Python のコードと AI エージェントに、各ネットワークの公式 API を通じて WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などのほかのチャンネルのお客様への到達手段を提供します。Partner API はアカウントを接続し、新しいトークンを発行します。MCP サーバーは、同じアカウントをエージェントにツールとして提供します。すべての接続は 24 時間 365 日監視されます。接続ごとの月額は US$ 9 から、接続を増やすほど下がって US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
Meta、TikTok、Google、LinkedIn の開発者アプリは自分で用意する必要がありますか?
いいえ。アカウントは、各ネットワーク上の easyCoexistence 独自のアプリを通じてサインインします。認証情報を取得する呼び出しは、TikTok、YouTube、LinkedIn の場合はそのアカウントのトークンをコードに渡し、ネットワークの API ですぐに使える状態にします。
Python のどのバージョンとライブラリが必要ですか?
Partner API と各ネットワークの API は、JSON を使ったプレーンな HTTPS です。そのため requests、httpx など任意の Python HTTP クライアントで呼び出せます。TikTok への投稿やエージェントツールで使う MCP Python SDK バージョン 2 には、Python 3.10 以降が必要です。
どのネットワークがコメントと DM をエンドポイントに送りますか?
Instagram と Facebook はコメント、メンション、DM を転送し、TikTok はコメントを転送します。すべてチャンネルのシークレットで署名されます。YouTube と LinkedIn はこのようなイベントを送らないため、それぞれの API からスケジュールに沿ってコメントを読み取ってください。
Python で easyCoexistence の料金はいくらですか?
接続ごとの月額は US$ 9 から、接続を増やすほど下がって US$ 0.75 まで。どのネットワークでも同じです。Partner API と MCP コネクタは含まれ、座席数による課金はありません。最初の 3 日間は無料トライアルです。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日