Εργαλεία social media στο Vercel AI SDK: Instagram, TikTok και άλλα
Το Vercel AI SDK αποκτά εργαλεία social media για Instagram, TikTok, Facebook, WhatsApp και άλλα κανάλια από τον MCP server του easyCoexistence. Το createMCPClient, από το πακέτο @ai-sdk/mcp, ανοίγει σύνδεση HTTP προς https://easycoexistence.com/api/mcp, ο OAuthClientProvider που γράφετε κρατά την είσοδο, και τα tools() του client περνούν στο generateText ή στο streamText για να δημοσιεύουν, να προγραμματίζουν, να απαντούν σε σχόλια και DMs και να διαβάζουν στατιστικά μέσω του επίσημου API κάθε δικτύου.
Η συνάρτηση του @ai-sdk/mcp που ολοκληρώνει το callback OAuth από το serverUrl και το authorizationCode, με το callbackState και το callbackIssuer όταν υπάρχουν.
Το προεπιλεγμένο stopWhen του generateText, οπότε το μοντέλο διαβάζει το αποτέλεσμα ενός εργαλείου μόνο όταν το stopWhen επιτρέπει περισσότερα βήματα.
Το transport MCP που συστήνει το AI SDK για παραγωγή. Το transport stdio προορίζεται μόνο για τοπικούς servers.
Η διάρκεια ισχύος του access token του MCP του easyCoexistence. Το refresh token ισχύει 60 ημέρες και αντικαθίσταται σε κάθε ανανέωση.
Το μέγιστο κείμενο που χωράει σε ένα DM του Instagram, μετρημένο σε UTF-8, οπότε οι τόνοι και τα emoji καταλαμβάνουν περισσότερο χώρο.
Πώς κάνει είσοδο το AI SDK στο easyCoexistence;
Μέσω ενός OAuthClientProvider που υλοποιείτε πάνω στον δικό σας αποθηκευτικό χώρο, τον οποίο οδηγεί η auth() του AI SDK. Η πρώτη κλήση καταχωρίζει την εφαρμογή σας στο easyCoexistence ως public client, αποθηκεύει τον PKCE verifier και δίνει το URL συγκατάθεσης μέσω του redirectToAuthorization. Η auth() επιστρέφει REDIRECT, και η διαδρομή σας στέλνει εκεί τον χρήστη. Το easyCoexistence ανακατευθύνει στο callback σας με έναν κωδικό, και μια δεύτερη κλήση της auth() με authorizationCode τον ανταλλάσσει με tokens. Μόλις αποθηκευτούν τα tokens, η auth() χρησιμοποιεί το refresh token για ένα νέο ζεύγος, χωρίς να στείλει ξανά τον χρήστη. Κρατήστε το redirectUrl και τα καταχωρισμένα redirect_uris πανομοιότυπα, καθώς το easyCoexistence τα αντιστοιχίζει ακριβώς.
import { auth, type OAuthClientProvider } from "@ai-sdk/mcp";
export const MCP_URL = "https://easycoexistence.com/api/mcp";
const CALLBACK = "https://app.example.com/api/easycoexistence/callback";
// db is your own key-value store (Postgres, Redis, Vercel KV); one set of keys per user
export function easyAuth(userId: string): OAuthClientProvider {
const k = (name: string) => "easycoexistence:" + userId + ":" + name;
return {
get redirectUrl() { return CALLBACK; },
get clientMetadata() {
return {
client_name: "Acme app", // shown on easyCoexistence's consent screen
redirect_uris: [CALLBACK],
grant_types: ["authorization_code", "refresh_token"],
response_types: ["code"],
token_endpoint_auth_method: "none", // easyCoexistence registers public clients
};
},
clientInformation: () => db.get(k("client")),
saveClientInformation: (info) => db.set(k("client"), info),
isClientInformationDynamicallyRegistered: async () => Boolean(await db.get(k("client"))),
tokens: () => db.get(k("tokens")),
saveTokens: (tokens) => db.set(k("tokens"), tokens),
saveCodeVerifier: (verifier) => db.set(k("verifier"), verifier),
codeVerifier: () => db.get(k("verifier")),
redirectToAuthorization: (url) => db.set(k("sign-in"), url.href),
};
}
// GET /api/easycoexistence/connect: send the user to the consent screen
export async function connect(userId: string) {
const result = await auth(easyAuth(userId), { serverUrl: MCP_URL });
if (result === "AUTHORIZED") return new Response("Already connected");
return Response.redirect(await db.get("easycoexistence:" + userId + ":sign-in"));
}
// GET /api/easycoexistence/callback: trade the code for tokens
export async function callback(req: Request, userId: string) {
const code = new URL(req.url).searchParams.get("code");
if (!code) return new Response("Sign-in was cancelled", { status: 400 });
await auth(easyAuth(userId), { serverUrl: MCP_URL, authorizationCode: code });
return Response.redirect("https://app.example.com/settings");
}Πώς φτάνουν τα εργαλεία στο generateText;
Από το createMCPClient με το HTTP transport, το URL του easyCoexistence και τον provider. Το tools() επιστρέφει τα εργαλεία του server ως εργαλεία του AI SDK. Κρατήστε κατά όνομα όσα χρειάζεται η εργασία και περάστε τα στο generateText ή στο streamText. Ορίστε το stopWhen με isStepCount, επειδή η κλήση σταματά από προεπιλογή μετά από ένα βήμα και το μοντέλο δεν διαβάζει ποτέ όσα επέστρεψε το reply_to_comment. Βάλτε τους κανόνες του δικτύου στο instructions, την παράμετρο που χρησιμοποιεί η τρέχουσα αναφορά για τη συμπεριφορά του μοντέλου. Κλείστε τον client σε block finally ή στο callback onEnd του streamText, ώστε να μη μένει ανοιχτή καμία σύνδεση.
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText, isStepCount, type LanguageModel } from "ai";
import { easyAuth, MCP_URL } from "./easycoexistence-auth";
const REPLY_TOOLS = new Set(["list_social_comments", "reply_to_comment", "hide_comment", "send_social_dm"]);
export async function replyToEvent(userId: string, model: LanguageModel, event: unknown) {
const mcp = await createMCPClient({
transport: { type: "http", url: MCP_URL, authProvider: easyAuth(userId) },
});
try {
const tools = Object.fromEntries(
Object.entries(await mcp.tools()).filter(([name]) => REPLY_TOOLS.has(name)),
);
const { text } = await generateText({
model,
tools,
stopWhen: isStepCount(4),
instructions:
"Reply to comments and DMs for Acme on the event's account_id. TikTok replies are public " +
"and need the video ID as post_id. Instagram DMs only go to people who wrote in the last 24 hours.",
prompt: JSON.stringify(event),
});
return text;
} finally {
await mcp.close();
}
}Πού πρέπει να βρίσκονται τα tokens σε serverless φιλοξενία;
Οπουδήποτε επιβιώνει από μία μεμονωμένη κλήση: σε μια εγγραφή βάσης δεδομένων, σε Redis ή σε key-value store, με κλειδί τον χρήστη της εφαρμογής σας στον οποίο ανήκουν. Μια συνάρτηση στο Vercel ή σε άλλη serverless πλατφόρμα ξεκινά χωρίς τίποτα στη μνήμη, οπότε ένας provider που κρατά τα tokens σε μεταβλητή στέλνει τον χρήστη πίσω στην οθόνη συγκατάθεσης μετά από ψυχρή εκκίνηση. Τα access tokens ισχύουν μία ώρα και τα refresh tokens 60 ημέρες, με νέο refresh token κάθε φορά που χρησιμοποιείται. Έτσι, μια εφαρμογή που καλεί τα εργαλεία τουλάχιστον μία φορά μέσα σε 60 ημέρες παραμένει συνδεδεμένη. Κρατήστε την καταχώριση του client δίπλα στα tokens, αφού ο provider διαβάζει και τα δύο σε κάθε σύνδεση.
Πώς φτάνουν τα σχόλια και τα DMs στην εφαρμογή;
Ως υπογεγραμμένα POST σε route handler, το οποίο καταχωρίζει το set_social_webhook_destination για έναν λογαριασμό και στη συνέχεια λαμβάνει σχόλια, αναφορές και DMs του Instagram και του Facebook, καθώς και σχόλια του TikTok. Κάθε σώμα περιέχει τα πεδία platform, account_id, external_id και entry, δηλαδή το γεγονός του δικτύου όπως στάλθηκε. Διαβάστε το σώμα ως κείμενο, ελέγξτε το X-EC-Signature απέναντί του με το μυστικό υπογραφής του λογαριασμού και απαντήστε γρήγορα: το easyCoexistence δίνει στη διαδρομή 8 δευτερόλεπτα και στέλνει κάθε γεγονός μία φορά, χωρίς επανάληψη. Βάλτε το γεγονός σε ουρά και αφήστε έναν worker να καλέσει το replyToEvent με αυτό, ώστε ο χρόνος του μοντέλου να μην μετράει ποτέ στα 8 δευτερόλεπτα.
Τι επιτρέπει κάθε δίκτυο στο μοντέλο;
Όσα επιτρέπει το API του λογαριασμού, κάτι που πρέπει να περιγράφουν ρητά τα instructions:
- Instagram: δημοσιεύσεις, Reels και Stories με εικόνες JPEG. Απαντήσεις DM μόνο σε άτομα που έγραψαν τις τελευταίες 24 ώρες, σε έως 1.000 bytes.
- Facebook: δημοσιεύσεις Σελίδας, απαντήσεις σε σχόλια και απαντήσεις στο Messenger εντός των ίδιων 24 ωρών.
- TikTok: βίντεο και δημοσιεύσεις φωτογραφιών. Απαντήσεις σε σχόλια πάντα δημόσιες, με το ID του βίντεο ως
post_id. Χωρίς DMs. - WhatsApp:
send_messageεντός 24 ωρών από το τελευταίο μήνυμα του πελάτη,send_templateγια οποιονδήποτε άλλον. - YouTube και LinkedIn: ανεβάσματα και δημοσιεύσεις όταν το ζητά ο χρήστης, απαντήσεις σε σχόλια και αναλυτικά στοιχεία. Κανένα από τα δύο δεν στέλνει γεγονότα, οπότε η εφαρμογή διαβάζει τα νέα σχόλια σε τακτά διαστήματα.
Συνηθισμένα λάθη
- Αφήνετε το stopWhen στην προεπιλογή. Το generateText σταματά μετά το πρώτο βήμα, οπότε το μοντέλο καλεί το reply_to_comment και δεν μαθαίνει ποτέ αν η απάντηση στάλθηκε. Επιτρέψτε μερικά βήματα με το isStepCount.
- Κρατάτε τα tokens σε μεταβλητή επιπέδου module σε serverless φιλοξενία. Στην επόμενη ψυχρή εκκίνηση δεν υπάρχουν, και ο χρήστης βρίσκεται ξανά στην οθόνη συγκατάθεσης. Αποθηκεύστε τα εκεί όπου τα tokens() και τα saveTokens() φτάνουν σε βάση δεδομένων.
- Καταχωρίζετε ένα redirect URL και στέλνετε άλλο. Το easyCoexistence ελέγχει το redirect_uri ακριβώς απέναντι στην καταχώριση, οπότε μια τελική κάθετος ή διαφορετική διαδρομή τερματίζει τη σύνδεση σε σελίδα σφάλματος.
- Απαντάτε στη δική σας δραστηριότητα. Το Instagram στέλνει πίσω τα DMs του λογαριασμού ως echo, και οι δημόσιες απαντήσεις του επιστρέφουν ως σχόλια. Παραλείψτε και τα δύο πριν το prompt φτάσει στο μοντέλο.
Το easyCoexistence δίνει στους agents που φτιάχνετε με το Vercel AI SDK πρόσβαση σε πελάτες στο WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn και άλλα κανάλια, μέσω του επίσημου API του καθενός: εργαλεία MCP πίσω από είσοδο OAuth, υπογεγραμμένα γεγονότα για σχόλια και DMs, και ουρά δημοσιεύσεων έως 90 ημέρες μπροστά, με κάθε σύνδεση να παρακολουθείται 24/7. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες είναι δωρεάν δοκιμή.
Συχνές ερωτήσεις
Χρειάζεται Next.js ή φιλοξενία στο Vercel;
Όχι. Το AI SDK τρέχει σε Node.js, οπότε λειτουργεί κάθε φιλοξενία που σερβίρει διαδρομή HTTPS, και ο MCP client χρειάζεται μόνο εξερχόμενη κίνηση HTTPS προς easycoexistence.com.
Μπορεί μια διεπαφή συνομιλίας να στέλνει σε ροή τις κλήσεις εργαλείων;
Ναι. Περάστε τα ίδια εργαλεία στο streamText και κλείστε τον MCP client στο callback onEnd του, όπως τεκμηριώνει το AI SDK για τις ροές απαντήσεων.
Μπορεί η ίδια εφαρμογή να απαντά σε μηνύματα WhatsApp;
Ναι. Τα εργαλεία του αριθμού έρχονται μέσω του ίδιου client: list_numbers για το connection_id, και έπειτα send_message εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη. Ο οδηγός του AI SDK για το WhatsApp καλύπτει τη λήψη τους.
Πόσο κοστίζει το easyCoexistence για εφαρμογή με AI SDK;
US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, με την ίδια τιμή σε κάθε δίκτυο. Στο κόστος περιλαμβάνονται ο MCP server και το Partner API, και οι πρώτες 3 ημέρες είναι δωρεάν.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις