Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Julkaise Instagramiin, TikTokiin ja Facebookiin Pythonilla yhdellä API:lla

easyCoexistencen avulla Python-koodi julkaisee Instagramiin, Facebookiin, TikTokiin, YouTubeen ja LinkedIniin kunkin verkon virallisen API:n kautta. Jokainen tili kirjautuu sisään kerran isännöidyn linkin kautta. Sen jälkeen skriptisi hakee tuoreen TikTokin, YouTuben tai LinkedInin tokenin yhdellä GET-pyynnöllä, kun taas Instagram- ja Facebook-kutsut kulkevat easyCoexistencen MCP-työkalujen kautta, jotka pitävät tokenin yllä. MCP-työkalut antavat Python-agentille samat tilit.

1,000 bytes

Suurin tekstimäärä, jonka yksi Instagram-DM voi kuljettaa API:n kautta laskettuna UTF-8-tavuina, joten emojit vievät enemmän tilaa.

24 hours

Kuinka kauan TikTok API for Business -pääsytoken on voimassa; sen päivitystoken pysyy voimassa vuoden.

1 hour

Kuinka kauan Googlen käyttäjän access token on voimassa, eli sellainen, jota jokainen YouTube API -kutsu kantaa mukanaan.

OAuthClientProvider

MCP Python SDK:n OAuth-käsittelijä, joka rekisteröi asiakkaan, suorittaa kirjautumisen PKCE:llä ja päivittää tokenit.

1 attempt

Edelleen välitetyt kommentti-, maininta- ja DM-tapahtumat toimitetaan kerran eikä niitä tallenneta, joten vahvista jokainen heti vastaanotetuksi.

Miten Python saa tokenin Instagramiin, Facebookiin, TikTokiin, YouTubeen tai LinkedIniin?

Connect-istunnon kautta easyCoexistencen Partner API:ssa, tunnistautuneena ec_live_-avaimellasi. POST /connect-sessions, jonka channel on asetettu arvoon instagram, facebook, tiktok, youtube tai linkedin, palauttaa yhdelle asiakkaalle tarkoitetun isännöidyn linkin, joka on voimassa tunnin. Asiakas kirjautuu verkon omalla kirjautumisella ja päätyy redirect_url-osoitteeseesi status=connected ja channel_id-tunnisteen kanssa. Taustajärjestelmäsi vahvistaa tämän kutsulla GET /connect-sessions/{session}, eikä luota kyselyparametreihin. Koodisi ei tarvitse omaa kehittäjäsovellusta Metalla, TikTokissa, Googlella tai LinkedInissä.

Pyydä sitten tunnuksia jokaisen työn alussa. GET /channels/{id}?credentials=1 palauttaa verkon API-kantaosoitteen, tilin tunnuksen kyseisessä verkossa ja TikTokin, YouTuben ja LinkedInin kohdalla access tokenin, jonka easyCoexistence pitää uusittuna. TikTokin token on voimassa 24 tuntia ja Googlen yhden tunnin, joten hae se työkohtaisesti sen sijaan, että tallentaisit sen. Instagramin ja Facebookin tokeneita ei koskaan anneta ulos; niiden kutsut kulkevat MCP-työkalujen kautta.

Connect an account, then fetch its credentials per job
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 creds

Miten julkaiset Instagramiin ja Facebookiin Pythonista?

Instagram julkaistaan kahdessa vaiheessa Metan Graph API:n kautta, token bearer-otsakkeena. POST /{ig-id}/media, jossa image_url ja caption, luo kontin. Kun GET sen status_code-kentästä lukee FINISHED, POST /{ig-id}/media_publish, jossa creation_id on kontti, julkaisee sen profiiliin. Meta suosittelee tarkistusta noin minuutin välein, enintään viisi minuuttia. Reel etenee samoin, mutta media_type REELS ja video_url image_urlin sijaan.

Facebook-sivun julkaisu on yksi kutsu: POST /{page-id}/feed, jossa message ja halutessasi link. Kun lisäät published false ja scheduled_publish_time 10 minuutin ja 30 päivän päähän, Meta julkaisee sen juuri silloin, eikä sinun tarvitse ajaa mitään työtä. Meta lataa median julkisesta URL-osoitteesta molemmissa tapauksissa, ja Instagram hyväksyy vain JPEG-kuvat.

Publish a photo on Instagram and schedule a Page post
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"]

Miten lataat YouTubeen ja julkaiset LinkedInissä Pythonista?

YouTube ottaa videon jatkettavana latauksena. Ensimmäinen pyyntö menee latauspäätepisteeseen uploadType=resumable ja part=snippet,status, ja mukana on otsikko ja tila JSON-muodossa. Vastauksen Location-otsake on istunnon osoite. Tiedoston PUT tähän osoitteeseen vastaa 201 uudella videolla. Kun privacyStatus asetetaan arvoon private ja mukana on publishAt-aika, YouTube julkaisee videon itsekseen sinä hetkenä, ja selfDeclaredMadeForKids kertoo, onko video tehty lapsille.

LinkedIn vaatii yhden POST-pyynnön osoitteeseen /rest/posts, jossa on bearer-token, LinkedIn-Version-otsake ja X-Restli-Protocol-Version 2.0.0. Runko nimeää tekijän, sisältää tekstin commentary-kentässä ja asettaa visibility-, distribution- ja lifecycleState-arvot. Tunnukset antavat author_urn-arvon, joka on urn:li:organization yritykselle tai urn:li:person profiilille, sekä easyCoexistencen käyttämän version. Uuden julkaisun URN palautuu x-restli-id-otsakkeessa.

Schedule a YouTube upload and publish a LinkedIn post
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 URN

Miten luet ja vastaat kommentteihin ja DM-viesteihin Pythonissa?

Ota välitys käyttöön kanavalle, varmista jokainen toimitus ja vastaa sitten verkon API:n kautta. PUT /channels/{id}/webhook, jossa url, palauttaa signing_secretin, joka näytetään vain kerran. Instagramin ja Facebookin kommentit, maininnat ja DM-viestit sekä TikTokin kommentit saapuvat POST-pyyntönä, jossa on platform, account_id, external_id ja entry, ja entry täsmälleen sellaisena kuin verkko sen lähetti. X-EC-Signature-otsake on muotoa t=<unix>,v1=<hex>, ja v1 on HMAC-SHA256 aikaleimasta, pisteestä ja raakasisällöstä. Jokainen tapahtuma lähetetään kerran, ilman kopiota ja ilman uusintaa, joten kuittaa ensin ja työskentele jonosta.

Vastaus Instagram-DM:ään menee osoitteeseen /{ig-id}/messages enintään 24 tuntia henkilön viimeisimmästä viestistä, enintään 1 000 tavua. Kommenttiin voi vastata julkisesti osoitteessa /{comment-id}/replies tai yhdellä yksityisellä vastauksella 7 päivän sisällä. TikTok-kommentteihin vastataan julkisesti business/comment/reply/create/-kutsulla, koska TikTokissa ei ole DM-viestejä. YouTuben ja LinkedInin kommentit luetaan niiden API:ista aikataulun mukaan.

Verify forwarded events and reply to Instagram DMs and comments
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)

Miten julkaiset TikTokiin Pythonista?

easyCoexistencen MCP-työkalun publish_tiktok_post kautta. TikTokin API for Business ottaa videon video_url-kenttänä ja lataa sen 16.11.2023 lähtien vain domainista tai URL-etuliitteestä, joka on vahvistettu tokenin takana olevalle kehittäjäsovellukselle, eli easyCoexistencen sovellukselle. Työkalu ottaa HTTPS-linkkisi ja antaa TikTokille allekirjoitetun osoitteen easyCoexistencen vahvistetulla mediareitillä, joka striimaa tiedoston tallentamatta sitä. Kuvajulkaisut käyttävät sen sijaan image_urls-kenttää, 1–35 JPEG- tai WebP-tiedostoa, ja get_tiktok_publish_status seuraa julkaisua TikTokin käsittelyn aikana.

Pythonista se on yksi kutsu virallisen MCP SDK:n version 2 kautta, Python 3.10:llä tai uudemmalla. Palvelin osoitteessa https://easycoexistence.com/api/mcp hyväksyy vain OAuth 2.1:n, joten SDK:n OAuthClientProvider rekisteröi asiakkaasi, suorittaa yhden selaimessa tapahtuvan kirjautumisen PKCE:llä ja päivittää tokenit. Access tokenit ovat voimassa tunnin ja päivitystokenit 60 päivää, jokainen päivitys antaa uuden parin, ja tallennus, joka säilyttää ne, pitää taustajärjestelmän kirjautuneena.

Publish a TikTok video through the MCP server
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())

Miten Python-tekoälyagentti käyttää näitä tilejä?

Saman MCP-istunnon kautta. Palvelin listaa työkalut tilillesi kuuluville verkoille, ja mikä tahansa agenttikehys, joka hyväksyy MCP-työkaluja, voi antaa ne mallilleen: julkaise kussakin verkossa, listaa julkaisuja, lue kommentteja ja vastaa niihin, vastaa DM-viesteihin Instagramissa ja Facebookissa, aseta kommentista DM:ään -sääntöjä sekä lue insights ja analytiikka. Palvelimen ohjeet ja kunkin työkalun kuvaus kantavat verkon säännöt, joten malli oppii, että TikTok-vastaukset ovat julkisia ja että Instagram-kuvien on oltava JPEG-muotoisia.

Aloita agentti list_social_accounts-työkalulla, koska jokainen muu sosiaalisen median työkalu ottaa siltä account_id:n, ja tuo id on sama kanavatunniste, jonka Partner API palauttaa. Vastaukset, jotka täytyy lähettää kello 3 yöllä ilman käynnissä olevaa agenttia, kuuluvat kommenttisääntöihin ja automaatioihin, jotka ajavat easyCoexistencella itsessään.

Yleiset virheet

  • Tokenin tallentaminen konfiguraatiotiedostoon. TikTokin token vanhenee vuorokauden sisällä ja Googlen tunnin sisällä, ja easyCoexistence uusii ne taustalla, joten kutsu tunnusten päätepistettä jokaisen työn alussa.
  • Linkin antaminen TikTokille omasta domainista. TikTok lataa mediaa vain URL-etuliitteistä, jotka on vahvistettu tokenin pitävälle sovellukselle, joten julkaise publish_tiktok_post-työkalun kautta, joka palvelee tiedostosi easyCoexistencen vahvistetusta osoitteesta.
  • Jokaisen kommenttitapahtuman vastaaminen, myös omasi. Julkiset vastauksesi palaavat uusina kommentteina ja Instagram-DM-viestisi kaikuina, joten ohita tapahtumat, joiden tekijä on tili itse, muuten botti vastaa itselleen.
  • Instagram-DM:n mittaaminen merkkeinä. Raja on 1 000 tavua UTF-8-koodauksessa, joten emojit ja aksentilliset kirjaimet tekevät tekstistä lyhyemmän. Lyhennä teksti koodatun pituuden mukaan ennen lähettämistä.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence antaa Python-koodillesi ja tekoälyagenteillesi pääsyn asiakkaisiin WhatsAppissa, Instagramissa, Facebookissa, TikTokissa, YouTubessa, LinkedInissä ja muissa kanavissa kunkin verkon virallisen API:n kautta. Partner API yhdistää tilit ja antaa tuoreet tokenit, MCP-palvelin antaa agenteille samat tilit työkaluina, ja jokaista yhteyttä valvotaan ympäri vuorokauden. US$ 9 – US$ 0,75 per yhteys kuukaudessa, ja hinta laskee, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ovat ilmainen kokeilu.

Usein kysytyt kysymykset

Tarvitsenko oman Meta-, TikTok-, Google- tai LinkedIn-kehittäjäsovelluksen?

Et. Tilit kirjautuvat easyCoexistencen omalla sovelluksella kussakin verkossa, ja tunnusten kutsu antaa koodillesi kyseisen tilin tokenin TikTokissa, YouTubessa ja LinkedInissä, valmiina käytettäväksi verkon API:a vastaan.

Mitä Python-versiota ja kirjastoja tarvitsen?

Partner API ja verkkojen API:t ovat tavallista HTTPS:ää JSON-muodossa, joten requests, httpx tai mikä tahansa muu Python HTTP -asiakas kutsuu niitä. MCP Python SDK, versio 2, jota TikTok-julkaisu ja agenttityökalut käyttävät, vaatii Python 3.10:n tai uudemman.

Mitkä verkot lähettävät kommentteja ja DM-viestejä päätepisteeseeni?

Instagram ja Facebook välittävät kommentit, maininnat ja DM-viestit, ja TikTok välittää kommentit, kaikki allekirjoitettuna kanavan salaisuudella. YouTube ja LinkedIn eivät lähetä tällaisia tapahtumia, joten lue niiden kommentit niiden API:ista aikataulun mukaan.

Mitä easyCoexistence maksaa Pythonille?

US$ 9 – US$ 0,75 per yhteys kuukaudessa, ja hinta laskee, kun lisäät yhteyksiä, sama kaikissa verkoissa. Partner API ja MCP-liitin ovat mukana ilman käyttäjäpaikkoja, ja ensimmäiset 3 päivää ovat ilmaisia.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu