Repository files navigation

bskyr provides an interface to the Bluesky Social API, allowing you tointeract with Bluesky Social from R. To do this, we provide functionswhich match with theAT Protocol’sLexicon, which is like usingregular HTTP requests. Outputs frombskyr’s functions are primarilytibbles, allowing for easy analysis of the outputs from the API calls.

You can install the stable version ofbskyr fromCRAN with:

install.packages('bskyr')

You can install the development version ofbskyr fromGitHub with:

# install.packages('pak')pak::pak('christopherkenny/bskyr')

First, load the package:

library(bskyr)

Text posts can be made as follows:

bs_post(text='Your text goes here.')

If you have images to include, up to four can be included with theimages argument:

bs_post(text='Your text goes here.',images= c('path/to/image1.jpg','path/to/image2.png'))

Alt text can be added to images with theimages_alt argument:

bs_post(text='Your text goes here.',images= c('path/to/image1.jpg','path/to/image2.png'),images_alt= c('Alt text for image 1','Alt text for image 2'))

To quote or reply to a post, use thequote and/orreply argument,respectively. These can take the link of an existing post. You can quoteand reply to the same post, if you want.

bs_post(text='Your text goes here.',quote='https://bsky.app/profile/chriskenny.bsky.social/post/3kepscxiljc22',reply='https://bsky.app/profile/chriskenny.bsky.social/post/3kepscxiljc22')

See the reference for additional features, including likes withbs_like() and reposts withbs_repost().

To authenticate, you first need to make an App Password. To do this, gotohttps://bsky.app/settings. Under “Advanced” click App passwords andthen “Add App Password.”

Once you have a password, you need to run:

set_bluesky_user('YOUR-USERNAME.bsky.social')set_bluesky_pass('your-apps-pass-word')

If you want this to persist across sessions, setinstall = TRUE andr_env = file.path(Sys.getenv('HOME'), '.Renviron'). This will saveyour credentials in your R environment file.

Alternatively, you can set them manually usingusethis::edit_r_environ() and adding lines like so:

BLUESKY_APP_USER='YOUR-USERNAME.bsky.social'BLUESKY_APP_PASS='your-apps-pass-word'