luisalejandro/agoras-actions

Agoras helps publish, like, share and delete posts on social networks (Agoras 2.0 native CLI). Also supports standalone OAuth credential refresh to GitHub secrets.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jul 7, 2026
License
GPL 3.0

Pinned Snippet

workflow.ymlSHA-pinned
uses: luisalejandro/agoras-actions@97601ef5fd474a635d1843663105cd28de21b6db # 2.0.5

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
networkTarget platform for social actions. One of: x, facebook, instagram, linkedin, discord, youtube, tiktok, threads, telegram, whatsapp. Legacy value twitter is mapped to x. Optional when action is refresh-credentials (may be used as an additional platform filter).no
actionAction to execute. One of: post, like, share, delete, video, template, thread, refresh-credentials.yes
github-secret-update-tokenPAT or GitHub App token with repository secrets write permission. Required when any *-refresh-token-secret-name input is set.no
platformsComma-separated platforms to refresh (youtube, facebook, instagram, linkedin, tiktok, threads). Defaults to all configured platforms when omitted.no
youtube-refresh-token-secret-nameGitHub repository secret name to update with the refreshed YouTube refresh token.no
facebook-refresh-token-secret-nameGitHub repository secret name to update with the refreshed Facebook refresh token.no
instagram-refresh-token-secret-nameGitHub repository secret name to update with the refreshed Instagram refresh token.no
linkedin-refresh-token-secret-nameGitHub repository secret name to update with the refreshed LinkedIn refresh token.no
tiktok-refresh-token-secret-nameGitHub repository secret name to update with the refreshed TikTok refresh token.no
threads-refresh-token-secret-nameGitHub repository secret name to update with the refreshed Threads refresh token.no
textText content to publish.no
linkURL link to include in the post.no
entriesYAML or JSON thread entries for action=thread. Full doc (version+entries) or a list of {text,link,images,...} objects. Used to build an Agoras content file.no
content-filePath to an Agoras content YAML file for action=thread (workspace path). Alternative to entries.no
image-1First image URL.no
image-2Second image URL.no
image-3Third image URL.no
image-4Fourth image URL.no
post-idPost ID for like, share, or delete actions (comma-separated for multiple).no
profile-idProfile ID for share actions (Facebook).no
video-urlVideo file URL for video actions.no
video-titleVideo title or caption.no
video-descriptionVideo description.no
video-typeVideo type (platform-specific).no
video-captionVideo caption (Instagram).no
titleTitle (YouTube, TikTok).no
descriptionDescription (YouTube).no
category-idYouTube category ID.no
privacyPrivacy setting (YouTube, TikTok).no
keywordsComma-separated YouTube keywords.no
x-consumer-keyX API consumer key.no
x-consumer-secretX API consumer secret.no
x-oauth-tokenX OAuth token.no
x-oauth-secretX OAuth secret.no
facebook-client-idFacebook OAuth client ID.no
facebook-client-secretFacebook OAuth client secret.no
facebook-app-idFacebook App ID.no
facebook-object-idFacebook page or profile ID.no
facebook-refresh-tokenFacebook OAuth refresh token (unattended CI).no
instagram-client-idInstagram (Facebook) OAuth client ID.no
instagram-client-secretInstagram (Facebook) OAuth client secret.no
instagram-object-idInstagram business account ID.no
instagram-refresh-tokenInstagram OAuth refresh token (unattended CI).no
linkedin-client-idLinkedIn OAuth client ID.no
linkedin-client-secretLinkedIn OAuth client secret.no
linkedin-object-idLinkedIn user or organization ID.no
linkedin-refresh-tokenLinkedIn OAuth refresh token (unattended CI).no
linkedin-access-tokenLinkedIn OAuth access token (unattended CI, standard apps).no
discord-bot-tokenDiscord bot token.no
discord-server-nameDiscord server (guild) name.no
discord-channel-nameDiscord channel name.no
youtube-client-idYouTube (Google) OAuth client ID.no
youtube-client-secretYouTube (Google) OAuth client secret.no
youtube-refresh-tokenYouTube OAuth refresh token (unattended CI).no
tiktok-client-keyTikTok App client key.no
tiktok-client-secretTikTok App client secret.no
tiktok-usernameTikTok username.no
tiktok-refresh-tokenTikTok OAuth refresh token (unattended CI).no
threads-app-idThreads (Meta) App ID.no
threads-app-secretThreads (Meta) App secret.no
threads-refresh-tokenThreads OAuth refresh token (unattended CI).no
threads-user-idThreads user ID (unattended CI).no
telegram-bot-tokenTelegram bot token.no
telegram-chat-idTelegram chat ID.no
telegram-parse-modeTelegram parse mode: HTML, Markdown, MarkdownV2, or None.no
whatsapp-access-tokenWhatsApp Business API access token.no
whatsapp-phone-number-idWhatsApp Business phone number ID.no
whatsapp-business-account-idWhatsApp Business Account ID.no
whatsapp-recipientWhatsApp recipient phone number (E.164).no
whatsapp-template-nameWhatsApp pre-approved template name.no
whatsapp-template-languageWhatsApp template language code (ISO 639-1).no
whatsapp-template-componentsWhatsApp template components as JSON string.no
namedescription
resultComma-separated list of published or affected post IDs.