Current version: 1.1.3
Agoras is a python utility that helps publish and delete posts on the most popular social networks (twitter, facebook, instagram and linkedin).
This repository contains the source code for the Agoras github actions. Its purpose is to serve as a wrapper for the application and provide a simple way to use it in your workflows.
The name of the action is LuisAlejandro/agoras-actions, and it accepts inputs as parameters. The inputs that you'll need to provide depend on the action you want to execute. For example, to publish a post to facebook, you'll need to provide the access token for your facebook app, the page ID (object ID) where you want to publish the post, the text and the image URL. The full workflow file would look like this:
name: Publish post to facebook
on:
workflow_dispatch:
jobs:
publish:
runs-on: ubuntu-22.04
steps:
- uses: LuisAlejandro/[email protected]
with:
network: facebook
action: post
status-text: This is a test post
status-image-url-1: https://placekitten.com/200/300
facebook-access-token: ZCNqH3bT0as2ZBB...
facebook-object-id: 8974765243478...The inputs are named after the command line arguments of the Agoras application. You can read more about how to use the application (and subsequently, this action) in the following links:
- General usage
- Using Agoras with Twitter
- Using Agoras with Facebook
- Using Agoras with Instagram
- Using Agoras with LinkedIn
Also, You can find a list of all the available inputs for each action in the Inputs section.
This action has one output named result that contains the IDs of the posts that were published, liked, shared or deleted. An operation can result in one ID or multiple IDs. Multiple IDs are separated by a comma. An example of an operation that yields multiple IDs would be when publishing with actions last-from-feed or schedule and max-count is set to an integer greater than 1.
To use the output, asign an id to the step where you are publishing and then reference the output in the step where you need the IDs like this ${{ steps.your-id-name.outputs.result }}. An example of how to use the output would be:
name: Publish post to linkedin and then like it
on:
workflow_dispatch:
jobs:
publish-like:
runs-on: ubuntu-22.04
steps:
- uses: LuisAlejandro/[email protected]
id: agoras
with:
network: linkedin
action: post
status-text: This is a test post
linkedin-access-token: ZCNqH3bT0as2ZBB...
- uses: LuisAlejandro/[email protected]
with:
network: linkedin
action: like
linkedin-post-id: ${{ steps.agoras.outputs.result }}
linkedin-access-token: ZCNqH3bT0as2ZBB...network: Social network to use for publishing. Must be one of twitter, facebook, instagram or linkedin.action: Action to execute. Must be one of like, share, last-from-feed, random-from-feed, schedule, post, delete.status-text: Text to be published.status-link: Link to be published.status-image-url-1: First image URL to be published.status-image-url-2: Second image URL to be published.status-image-url-3: Third image URL to be published.status-image-url-4: Fourth image URL to be published.feed-url: URL of public Atom feed to be parsed.max-count: Max number of new posts to be published at once.post-lookback: Only allow posts publishedmax-post-age: Dont allow publishing of posts older than this number of days.twitter-consumer-key: Twitter consumer key from twitter developer app.twitter-consumer-secret: Twitter consumer secret from twitter developer app.twitter-oauth-token: Twitter OAuth token from twitter developer app.twitter-oauth-secret: Twitter OAuth secret from twitter developer app.tweet-id: Twitter post ID to like, share or delete.facebook-access-token: Facebook access token from facebook app.facebook-object-id: Facebook ID of object where the post is going to be published.facebook-post-id: Facebook ID of post to be liked, shared or deleted.facebook-profile-id: Facebook ID of profile where a post will be shared.instagram-access-token: Facebook access token from facebook app.instagram-object-id: Instagram ID of profile where the post is going to be published.instagram-post-id: Instagram ID of post to be liked, shared or deleted.linkedin-access-token: Your LinkedIn access token.linkedin-post-id: LinkedIn post ID to like, share or delete.google-sheets-client-email: A google console project client email corresponding to the private key.google-sheets-private-key: A google console project private key.google-sheets-id: The google sheets ID to read schedule entries.google-sheets-name: The name of the sheet where the schedule is.
- Publish post to LinkedIn using
status-link, which embeds a preview of an URL in the post.
on:
workflow_dispatch:
jobs:
publish-like:
runs-on: ubuntu-22.04
steps:
- uses: LuisAlejandro/[email protected]
with:
network: linkedin
action: post
status-text: This is a test post
status-link: https://luisalejandro.org/blog/posts/nuevo-blog
linkedin-access-token: ZCNqH3bT0as2ZBB...- Publish post to Facebook with multiple images.
on:
workflow_dispatch:
jobs:
publish-like:
runs-on: ubuntu-22.04
steps:
- uses: LuisAlejandro/[email protected]
with:
network: facebook
action: post
status-text: This is a test post
status-image-url-1: https://pbs.twimg.com/media/Ej3d42zXsAEfDCr?format=jpg
status-image-url-2: https://pbs.twimg.com/media/Ej3d42zXsAEfDCr?format=jpg
status-image-url-3: https://pbs.twimg.com/media/Ej3d42zXsAEfDCr?format=jpg
status-image-url-4: https://pbs.twimg.com/media/Ej3d42zXsAEfDCr?format=jpg
facebook-access-token: ZCNqH3bT0as2ZBB...
facebook-object-id: 8974765243478...- Publish last post from feed to Facebook. This requires a cron to continuously check for new posts. The cron in this example runs every hour.
max-countis set to 1 to only publish one post at a time.post-lookbackis set to 3600 to only publish posts that are less than 1 hour old. This is to avoid publishing the same post multiple times.
on:
schedule:
- cron: 0 * * * *
jobs:
publish-like:
runs-on: ubuntu-22.04
steps:
- uses: LuisAlejandro/[email protected]
with:
network: facebook
action: last-from-feed
feed-url: https://luisalejandro.org/blog/posts/feed.xml
max-count: 1
post-lookback: 3600
facebook-access-token: ZCNqH3bT0as2ZBB...
facebook-object-id: 8974765243478...
Web luisalejandro.org · GitHub @LuisAlejandro · Twitter @LuisAlejandro