Konfigurationsguide för SosoAPI

Välj var du vill börja

SosoAPI ger agenten du redan använder en anslutning till dina sociala konton. Agenten hjälper till att skriva och granska innehåll; SosoAPI hanterar stödda kontoåtgärder, schemaläggning och publiceringsresultat. Du kan granska samma inlägg i appen eller använda API:et från egen kod.

Den här guiden börjar med en person och ett socialt konto. Du ansluter en lokal eller värdbaserad MCP-klient, väljer åtkomst, kontrollerar ett socialt konto, förbereder och godkänner ett inlägg och läser det faktiska resultatet. Den avancerade genomgången täcker CLI och HTTP API. Själva konfigureringen kräver inget testinlägg.

• Låt Claude Code eller Codex sköta konfigureringen: steg 1
• Konfigurera en MCP-klient själv: steg 3
• Använd terminal eller backend: steg 9
• Åtgärda en anslutning: steg 10

Innan du börjar

Du behöver en MCP-kompatibel AI-klient, ett SosoAPI-konto och ett socialt konto du får hantera. Du kan skapa SosoAPI-kontot när inloggningssidan öppnas. Ha ett verkligt innehåll i åtanke.

Lokal MCP behöver Node.js 20 eller senare med npm/npx och vald AI-klient. Värdbaserad MCP behöver en klient som stöder remote MCP, OAuth och automatisk klientregistrering; lokal Node.js-installation krävs inte. Klientfunktioner kan bero på plan och administratörsinställningar.

SosoAPI ansluter till Instagram, Threads, Facebook Pages, YouTube och X. Välj ett konto vars typ, behörigheter och inläggsformat passar uppgiften. Ett behörigt Threads-konto är ett bra första exempel med enbart text. Instagram och YouTube behöver lämpliga medier för sina stödda publiceringsformat. En plattform i anslutningsmenyn innebär inte att alla åtgärder är tillgängliga för alla konton.

Kontrollera kontospecifika funktioner under konfigureringen. Läs aktuell plan och kvot i appen innan du schemalägger en omgång; X har en separat kreditkvot per organisation. Ett exempel för en plattform visar inte stöd på en annan.

• Stödda plattformar
• Publiceringsfunktioner och kontokrav

1. Ge agenten konfigurationsbegäran

Klistra in detta i din befintliga Claude Code- eller Codex-konversation.

Agenten bör först kontrollera om det finns en fungerande SosoAPI-anslutning och återanvända den. Annars följer den konfigurationsanvisningarna och meddelar när webbläsarinloggning eller klientomstart behövs. Förväntat resultat: SosoAPI-verktyg kan användas i denna konversation. En installationsbekräftelse är inte i sig bevis. Fortsätt med inloggning och kontokontroll eller använd steg 3 för manuell konfigurering.

Konfigurera SosoAPI från https://sosoapi.ai/setup.md. Behåll mitt aktuella innehåll och min uppgift. Jag loggar in och godkänner åtkomst när jag blir tillfrågad. Publicera ingenting under konfigureringen.

2. Logga in och välj agentens åtkomst

Använd rätt konto: fortsätt med Google eller registrera dig med e-post och slutför verifieringen. Slutför eventuell konto- eller arbetsytekonfiguration som visas. Om du tillhör flera arbetsytor väljer du avsett varumärke eller projekt. Granska begärda arbetsytor och åtgärder före godkännande och återvänd till samma konversation.

Behåll inloggningslänken från agenten så att webbläsaren kan återgå till den väntande auktoriseringen. Du kan börja i appen och sedan återvända till agenten. Ersätt inte en väntande godkännandelänk med en annan inloggningslänk.

Arbetsyteroller och plattformsbehörigheter gäller fortfarande: en läsare blir inte redaktör för att agenten har publiceringsåtkomst. Publiceringsåtkomst fortsätter inom det omfång du ger; SosoAPI kräver inte nytt webbläsargodkännande för varje inlägg. Berätta för agenten när den ska pausa för innehållsgranskning. Vanlig OAuth-konfiguration kräver inte att du klistrar in ett socialt lösenord eller en API-nyckel i agenten.

Förväntat resultat: Inloggningen slutförs med rätt identitet och agenten kan hämta arbetsytorna du auktoriserade. Använd felsökningen om fel webbläsarprofil öppnas.

• Börja i SosoAPI-appen

3. Anslut agenten manuellt vid behov

Välj en anslutningsmetod. Hoppa över avsnittet om agenten redan har konfigurerat en fungerande anslutning. För lokal MCP kontrollerar du Node.js och npx först. Node.js måste vara version 20 eller senare.

node --version
npx --version

Lokal MCP: Claude Code eller Codex

Kör bara kommandot för din klient: det första är för Claude Code och det andra för Codex. core-profilen täcker vanlig publicering. Profiler ändrar vilka verktyg som visas, inte behörigheter. Behåll en fungerande full-profilanslutning om du redan har en.

Anslut igen eller starta om om klienten begär det och kontrollera sedan att SosoAPI-verktyg finns i den aktuella konversationen. Första autentiserade anropet startar webbläsarinloggning vid behov.

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

Andra lokala MCP-klienter

För klienter som använder mcpServers JSON lägger du till posten i befintlig konfiguration och behåller andra servrar. Andra format ska få samma kommando, argument och miljövariabel via klientens egna MCP-inställningar.

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• Installationsreferens och paketval

Värdbaserad MCP: kompatibla webbläsare eller fjärrklienter

I klientens inställningar för anpassade anslutningar eller remote MCP lägger du till en anslutning med namnet SosoAPI och server-URL:en nedan. Välj OAuth med automatisk klientregistrering när det erbjuds. Logga in på SosoAPI, välj tillåtna arbetsytor och åtgärder, återvänd till konversationen och aktivera anslutningen om klienten kräver det. Be agenten kontrollera auktoriserade konton.

Använd https://sosoapi.ai för en ny värdbaserad anslutning. Den äldre slutpunkten https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp stöds fortfarande. Behåll en fungerande lokal eller värdbaserad anslutning; den behöver inte ersättas bara för att ändra URL:en.

Du behöver inte klistra in API-nyckel, klient-ID eller klienthemlighet. Egna MCP-appar i ChatGPT beror på klientens plan, utvecklarläge och administratörsinställningar. Detta beskriver en anpassad anslutning, inte en listning i appkatalogen. Värdbaserad MCP kan inte läsa lokala filer; använd import från offentlig URL eller lokal MCP för lokal filuppladdning.

https://sosoapi.ai

• Anvisningar för egen OAuth-klientregistrering och token

Valfri inloggningskontroll i terminalen

För en lokal anslutning kör du auth status först. Kör auth login bara om den visar att du inte är inloggad. Slutför webbläsarflödet och kontrollera status igen. Token skrivs inte ut. Detta kontrollerar lokal CLI-autentisering, inte inloggningen till en separat värdbaserad anslutning.

npx -y sosoapi auth status

npx -y sosoapi auth login

4. Anslut ditt sociala konto

Öppna kontoanslutning eller använd det lokala kommandot nedan. Ersätt threads med instagram, facebook, youtube eller x vid behov. Detta öppnar anslutningsflödet; det publicerar inget innehåll.

Kontrollera organisationen och arbetsytan som visas. Välj plattform, logga in via dess auktoriseringssida och välj exakt konto, Page eller kanal. Slutför samtycket och eventuell bekräftelse av kontoval när du återvänder. Be sedan agenten uppdatera anslutna konton för avsedd arbetsyta.

Återanvänd en befintlig fungerande anslutning. Om den tillhör en annan organisation eller arbetsyta löser du valet i appen; vanlig konfigurering ska inte koppla från eller flytta den. Förväntat resultat: rätt konto visas i avsedd arbetsyta med aktuell anslutningsstatus och funktionsinformation. En lyckad återkoppling bevisar inte i sig publiceringsbehörighet.

npx -y sosoapi connect threads

• Anslut konton

5. Verifiera åtkomst utan att publicera

Klistra in följande i den anslutna agentkonversationen.

Agenten kan använda sosoapi_get_workspace_context och sosoapi_list_connected_accounts, återanvända känd kontext och skicka valt workspace_id uttryckligen. Kontoinitiering kan skapa din första arbetsyta; denna konfigurationskontroll skapar inget socialt inlägg.

Innan du fortsätter bekräftar du arbetsyta och mål, din roll och agentens åtkomst samt målets stöd för föreslaget format. Använd felsökningen om en kontroll misslyckas. Att installera om paketet löser inte saknad plattformsbehörighet.

Kontrollera min SosoAPI-konfiguration utan att publicera eller schemalägga något.
Visa de arbetsytor jag kan använda och de sociala kontona i arbetsytan jag väljer.
För kontot jag väljer visar du plattform, kontonamn, anslutningsstatus och publiceringsfunktioner för formatet jag föreslår.
Om flera arbetsytor eller konton kan passa, fråga mig vilken du ska använda.
Behåll interna ID:n för verktygsanrop; be mig inte hitta eller hitta på dem.

6. Förbered och godkänn ditt första inlägg

Börja med ett riktigt inlägg och ett mål. Ersätt fälten i hakparenteser i denna utkastprompt. Agenten skriver; SosoAPI tillhandahåller anslutning och publiceringsåtgärder. Granska påståenden, stavning, länkar och medier själv.

Ange uttryckligt datum, lokal tid och IANA-tidszon för ett framtida inlägg. Om sommartid gör den lokala tiden tvetydig väljer du vilken förekomst du menar före inskickning. Förväntat resultat i detta skede: ett exakt utkast för granskning, utan inskickad publiceringsbegäran.

Hjälp mig att förbereda ett produktmeddelande med SosoAPI.

Produkt: [public product name]
Verifierade fakta: [what is available today]
Målgrupp: [who this helps]
Mål: [account label and platform]
Språk: [language]
Önskat lokalt datum och klockslag: [YYYY-MM-DD HH:mm]
Tidszon: [IANA timezone, for example Asia/Hong_Kong]
Medier: [none, a local file, or a public media URL]

Använd bara de fakta jag gav. Kontrollera målets formatkrav.
Visa exakt utkast, medier, mål, datum, klockslag och tidszon för granskning.
Schemalägg eller publicera inte ännu.

Godkänn det exakta inlägget före schemaläggning

När alla uppgifter är korrekta ger du en konkret instruktion med prompten nedan. Detta skapar en riktig schemaläggning som kan publicera offentligt. Använd innehåll och ett konto du faktiskt avser att publicera på. Omedelbar publicering kräver också en uttrycklig instruktion efter granskning av samma uppgifter.

Förväntat resultat: ett Scheduled Post-ID, rätt mål, accepterad tidpunkt och aktuell status. En accepterad schemaläggning betyder inte att leverantören har publicerat inlägget.

Schemalägg det exakta godkända inlägget nedan till det namngivna kontot på angivet datum, klockslag och tidszon.

[Klistra in slutligt innehåll, medier, mål, datum, klockslag och tidszon.]

Kontrollera först om det finns en matchande schemaläggning. Skicka inlägget en gång och läs tillbaka det sparade resultatet. Returnera ID, mål, accepterad tidpunkt och aktuell status. Om resultatet är osäkert kontrollerar du den befintliga begäran innan du gör något annat.

7. Kontrollera resultatet, schemalägg om eller avboka

Be agenten läsa samma Scheduled Post med sosoapi_get_scheduled_post. Du kan även öppna https://app.sosoapi.ai/scheduled-posts/<post-id> efter inloggning med ett auktoriserat konto. Kontrollera varje mål separat när en begäran gäller flera konton; vissa kan lyckas medan andra behöver åtgärdas.

Läs aktuellt resultat för Scheduled Post [returned ID].
Visa mål, schemalagd tidpunkt, aktuell status och publiceringsresultat.
Om publicering är bekräftad, ta med den offentliga länken när den finns.
Försök inte igen, schemalägg inte om och skapa inget nytt inlägg.

Hantera ett väntande inlägg och återkom senare

För att ändra ett väntande inlägg anger du ID och nya uppgifter. Agenten måste läsa aktuell version och tillgängliga åtgärder före en stödd uppdatering eller avbokning. Möjligheten att avboka beror på leveransstadiet och kan upphöra när leveransen startar. Att avboka en schemaläggning tar inte bort ett redan publicerat inlägg hos leverantören.

När du har fått sparade uppgifter för en framtida schemaläggning kan du lämna konversationen och återvända till samma inlägg senare. En stängd agentkonversation lovar inte att vakna eller meddela dig om detta inte har konfigurerats separat.

8. Lägg till bilder eller video och återanvänd flödet

Få flödet för ett inlägg att fungera innan du förbereder en större omgång. Tala om för agenten om medierna är en lokal fil, en offentlig URL eller en befintlig SosoAPI-resurs.

Lokala filer kan laddas upp med sosoapi_upload_asset i lokal MCP. Filen måste ligga i en tillåten uppladdningsmapp; verktyget förklarar tillåtna platser om sökvägen är utanför området. Värdbaserad MCP kan inte läsa filer på din dator.

För offentliga URL:er använder du sosoapi_import_asset_url och sedan sosoapi_get_asset_import_status med include_asset=true. Vänta tills resursen är klar. För en befintlig resurs bekräftar du att den tillhör rätt arbetsyta och är klar för valt format.

En vanlig schemaläggningsbegäran använder registrerat resurs-ID tillsammans med resursens kanoniska URL. En tillfällig förhandsvisnings-URL eller den ursprungliga externa URL:en kan inte ersätta detta. För det stödda flödet med en bild-URL kombinerar sosoapi_post_image_url import och inskickning. Det är en publiceringsåtgärd: godkänn hela inlägget först. Behåll ID:t för ett accepterat inlägg under bearbetningen; starta inte en ny import för att fortsätta.

X stöder ett ursprungligt TEXT-inlägg utan medier, eller VIDEO med exakt en färdig registrerad MP4-videoresurs, minst 0.5 sekunder lång och inom uppladdningsgränsen på 500 MiB. Video kräver verifierad can_publish_video för det aktuella kontot; enbart textåtkomst räcker inte. En äldre anslutning kan kräva ditt godkännande för att ansluta igen med videouppladdningsbehörighet. Text, hashtaggar och länk måste rymmas inom X:s viktade textgräns. Foton, svar, citat, återpublicering och trådpublicering stöds inte. Accepterad uppladdning eller videobearbetning är inte ett publiceringsresultat.

Före inskickning till X läser du sosoapi_get_x_usage för avsett workspace_id och slutlig text. Kvoten och kostnaden är skilda från den vanliga plankvoten. Kringgå inte en kreditgräns med upprepade inskickningar; stäm av en osäker publicering innan du skickar igen.

Förbered en omgång för granskning och läs resultaten ärligt

Efter ditt första lyckade inlägg kan du prova produktlanseringsprompten nedan. När du har godkänt den exakta tabellen kontrollerar du omgången mot planens gränser. Rapportera accepterade och avvisade mål separat och behåll identiteten för varje accepterat inlägg.

Publiceringsåtkomst och analysåtkomst kan skilja sig åt. Om du senare ber om en resultatanalys ska otillgängliga mätvärden anges som otillgängliga. Hitta inte på nollvärden och anta inte att alla mätvärden går att läsa för att ett inlägg har publicerats.

Använd samma verifierade konfiguration och förbered sju produktannonseringsutkast, ett per dag, från de offentliga fakta jag ger. Visa en granskningstabell med utkast, mål, medier, lokalt datum, klockslag och tidszon för varje rad. Behåll alla sju som utkast tills jag godkänner den exakta tabellen.

9. Genomgång av CLI och API

Använd denna valfria väg för uttryckliga begärandefiler eller en backend-integration. Agentanvändare kan hoppa över den. Exemplen använder samma konto, arbetsyta och publiceringsbehörigheter som MCP.

Granska först hjälpen och det inbyggda kontraktet för det installerade paketet; kontraktsgranskning kräver ingen inloggning. Det visar åtgärder och scheman som följer med paketet. Använd dessa fältnamn i stället för en annan leverantörs begärandeformat.

npx -y sosoapi --help
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/

CLI: gör din första autentiserade kontextbegäran

Slutför auth login. Spara JSON nedan som workspaces.json i en textredigerare och kör sedan kommandot. Använd filer för begärandekroppar i stället för att infoga innehåll i skalkommandon.

CLI returnerar schema_version, http_status och body. Ett lyckat svar innehåller body.active_workspace_id och body.workspaces. Välj avsedd arbetsyta från svaret; den aktiva arbetsytan avgör inte tyst målet för en ny uppgift. Första anropet för ett nytt konto kan initiera den första arbetsytan.

Kontrollera http_status och body, inte bara skalets avslutningskod. Ett kommando kan returnera ett HTTP-felformat utan att API-åtgärden lyckas.

{}

npx -y sosoapi api post /identity-api/workspace/list < workspaces.json

CLI: välj det anslutna sociala kontot

Spara accounts.json med arbetsytans ID som returnerats för ditt konto och kör kommandot. Välj rätt konto från body.accounts. Kontots SosoAPI-ID är social_account_id som används vid schemaläggning; ett användarnamn eller leverantörens Page-ID kan inte ersätta det.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>"
}

npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.json

CLI: schemalägg ett godkänt Threads-textinlägg

Detta är en begärandemall, inte ett färdigt inlägg att köra. Spara post.json med en filredigerare och ersätt alla värden i hakparenteser med egna auktoriserade värden. Välj en framtida ISO-tidsstämpel med uttrycklig UTC-förskjutning, eller Z för UTC. display_timezone är en IANA-tidszon för visning; den gör inte en tvetydig lokal tidsstämpel fullständig.

Skapa en unik idempotency_key, till exempel en UUID, och behåll den med den exakta begärandekroppen. Försök igen med samma nyckel för en identisk begäran; ett försenat svar är inget skäl att skapa en ny nyckel. Ett ändrat inlägg är en annan begäran: kontrollera originalresultatet innan du väljer en ny identitet.

Kör create-kommandot efter att ha bekräftat innehåll, konto, tidpunkt, behörigheter och aktuell kvot. Detta schemalägger ett riktigt inlägg. Vid acceptans behåller du body.post.id och läser body.post.status, body.post.scheduled_at och body.post.destination. body.deduped visar om en befintlig begäran återanvändes. Acceptans är inte leverantörsbekräftad publicering.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>",
  "social_account_id": "<YOUR_THREADS_ACCOUNT_ID>",
  "caption": "<YOUR_APPROVED_POST_TEXT>",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<FUTURE_ISO_8601_TIME_WITH_OFFSET>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<NEW_STABLE_REQUEST_KEY>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/create < post.json

CLI: läs det sparade inlägget och resultatet

Spara post-status.json med returnerat ID. Läs body.post, body.delivery, body.actions och body.outcomes. Bekräfta ett publicerat resultat innan du rapporterar framgång. Om create-svaret gick förlorat återfinner du originalbegäran med sparad identitet; skapa inte en ny schemaläggning med ny nyckel.

{
  "id": "<RETURNED_POST_ID>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.json

CLI: avboka bara när aktuellt resultat tillåter det

Om den senaste läsningen tillåter avbokning och du vill avboka sparar du cancel.json med returnerat ID och aktuellt numeriskt body.post.version. Exemplets 1 är illustrativt: ersätt det med versionen du just läste. Kör sedan kommandot och bekräfta resultatet.

Om versionen ändrats eller avbokning inte är tillgänglig läser du samma inlägg igen och använder de faktiskt tillgängliga åtgärderna. Kringgå inte en versionskonflikt och förväxla inte avbokning med radering av ett redan publicerat inlägg.

{
  "id": "<RETURNED_POST_ID>",
  "expected_version": 1
}

npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.json

HTTP: anropa från din egen backend

För en serverintegration skapar du en API-nyckel under Connection → API och lagrar hemligheten i serverns hemlighetskonfiguration. Skärmen frågar nu bara efter namn; den har inga väljare för arbetsyta eller funktioner. En användarskapad nyckel får som standard operate, publish och engage i alla arbetsytor användaren kan nå. Kontrollera om behörigheten passar integrationen. API-kontraktet stöder nycklar med uttryckligt begränsade capabilities och workspace_ids.

Vanlig agentkonfiguration använder OAuth och behöver inte detta API-nyckelsteg. I exemplet är SOSOAPI_ACCESS_TOKEN en exempelvariabel på serversidan som innehåller nyckeln, inte en SosoAPI CLI-inställning. CLI:ns valfria variabel för personlig åtkomsttoken är VICKY_API_KEY.

Använd workspaces.json-filen ovan. Direkt HTTP returnerar slutpunktens innehåll utan CLI:ns http_status/body-format; läs faktisk HTTP-status och JSON. Behåll autentiseringsuppgifter i backend och utanför webbläsarkod, prompter, skärmbilder och delade begärandefiler.

Att bygga in social anslutning i en produkt för egna kunder är en separat integrationsuppgift. Denna genomgång för ett konto bevisar inte att kundernas introduktionsflöde är klart.

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer ${SOSOAPI_ACCESS_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data-binary @workspaces.json \
  'https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/workspace/list'

• Hantera API-nycklar: Connection → API
• API-referens
• Skapande av API-nyckel och uttrycklig behörighet
• Autentisering och behörigheter
• CLI-referens

10. Felsökning

Utgå från det faktiska felet och anslutningen du felsöker. Utökade behörigheter eller upprepade inskickningar löser inte alla fel.

Uppdatera, återkalla åtkomst eller be om hjälp

Det första kommandot nedan kontrollerar hjälpen för senaste paketet utan att starta MCP-servern. Om klienten låser en version i det sparade kommandot uppdaterar du det kommandot avsiktligt. En separat global installationsuppdatering uppdaterar inte klientens låsta kopia.

För att återkalla en lokal enhet använder du Connection → Agent eller auth logout nedan. För en värdbaserad anslutning återkallar du motsvarande auktorisering under Connection → Agent. API-nycklar hanteras separat under Connection → API. Att återkalla agentåtkomst avbokar inte accepterade schemaläggningar; hantera inläggen separat.

Om du behöver hjälp anger du klient- och paketversion, misslyckat steg, visat fel och tid/tidszon. Dela relevanta begärande- eller inläggs-ID:n privat med support vid behov. Skicka inte autentiseringsuppgifter, auktoriseringslänkar eller råloggar som kan innehålla token.

npx -y sosoapi@latest --help

npx -y sosoapi auth logout

• Hantera agentklienter: Connection → Agent
• Hantera API-nycklar: Connection → API
• Felsökningsreferens
• Kontakta SosoAPI-support

Checklista för slutförd konfiguration

Du kan slutföra anslutningskonfigurationen utan att skicka in ett inlägg. Om du publicerar använder du den separata resultatkontrollen för att bekräfta det första publiceringsflödet.

• Min klient kan använda SosoAPI-verktyg, eller mitt CLI/API kan göra en auktoriserad begäran.
• Jag har loggat in med rätt konto och valt rätt arbetsyta.
• Mitt sociala konto visas med de funktioner uppgiften behöver.
• Jag förstår om min agent bara kan förbereda arbete eller även schemalägga och publicera.
• Jag kan förbereda ett utkast och granska exakt mål, innehåll och tidpunkt.
• Om jag har skickat in ett inlägg har jag behållit dess ID och kan skilja mellan acceptans och bekräftad publicering.
• Jag vet hur jag undersöker fel, hanterar en väntande schemaläggning och återkallar åtkomst.