README

Facebook Login for 🤖 robots

Uses a headless browser to perform a Facebook Login (OAuth dialog) in a Facebook App.

Features

Uses Perseverance to add :raised_hand: rate limit, :poop: retry and :traffic_light: circuit breaker behaviour to your requests :white_check_mark:
Supports Bluebird :bird: promises :white_check_mark:

How to install

npm install facebook-login-for-robots

How to use

Use it in your app

Use Facebook Login to get an access token for a Facebook App

const FacebookLogin = require('facebook-login-for-robots')

const facebookLogin = new FacebookLogin({
  facebook: {
    email: 'my-facebook-email-address',
    password: 'my-facebook-passsword'
  },
  // puppeteer: {
  //   headless: false // helpful for troubleshooting
  // }
})

const clientId = 'my-facebook-app-id'
const redirectUri = 'my-facebook-app-redirect-uri'

facebookLogin.oauthDialog(clientId, redirectUri)
  .then(({ facebookAccessToken }) => console.log(facebookAccessToken))
  .catch((error) => console.error(error))

How to contribute

You can contribute either with code (e.g., new features, bug fixes and documentation) or by donating 5 EUR. You can read the contributing guidelines for instructions on how to contribute with code.

All donation proceedings will go to the Sverige för UNHCR, a swedish partner of the UNHCR - The UN Refugee Agency, a global organisation dedicated to saving lives, protecting rights and building a better future for refugees, forcibly displaced communities and stateless people.

Used by

get-me-a-date - :heart_eyes: Help me get a :cupid: date tonight :first_quarter_moon_with_face:

License

Read the license for permissions and limitations.

Usage no npm install needed!